Присоединить (Инструменты Управление данными)

Краткая информация

Присоединяет и, дополнительно, обновляет существующий целевой набор несколькими входными наборами данных. Входными наборами данных могут быть классы объектов, таблицы, шейп-файлы, растры, классы объектов аннотаций или объекты-размеры. Входными также могут быть размещенные сервисы пространственных объектов.

Чтобы комбинировать входные наборы данных в новый выходном наборе данных, используйте инструмент Слияние.

Иллюстрация

Использование

• Используйте этот инструмент, чтобы добавить пространственные объекты или другие данные из нескольких наборов данных в существующий набор данных. Этот инструмент может присоединять классы точечных, линейных и полигональных пространственных объектов, таблицы, растры, классы пространственных объектов-аннотаций или объектов-размеров к существующему набору данных такого же типа. Например, к имеющейся таблице можно присоединить несколько таблиц, или несколько растров к существующему набору растровых данных, но нельзя соединить линейный и точечный классы пространственных объектов.

• Используйте параметр Список полей для контроля над тем, какая информация из атрибутивных полей входного набора данных переносится в целевой набор данных. Параметр Список полей можно использовать только в случае, если указано Используйте список полей для согласования изменений для параметра Тип сопоставления полей.

• Используйте параметр Список полей для задания соответствия или сопоставления полей из входных наборов данных в целевой набор данных.

  • Используйте действие, чтобы определить, как значения из одного или нескольких входных наборов данных будут сопоставлены с одним полем в целевом наборе данных.

  • Доступны следующие действия: Первое, Последнее, Соединить, Сумма, Среднее, Медиана, Мода, Минимум, Максимум, Среднеквадратическое отклонение и Число.

  • При использовании действия Соединить вы можете задать разделитель, например, точку или другой символ. Щелкните начало текстового поля Разделитель, чтобы добавить символы-разделители.

  • Среднеквадратическое отклонение не является допустимым вариантом для одиночных входных значений.

  • Используйте опцию Экспорт для сохранения списка полей в файле .fieldmap.

  • Используйте опцию Загрузить , чтобы загрузить файл .fieldmap. Векторный слой или набор данных, указанный в файле, должен соответствовать набору данных, используемому в инструменте. Иначе параметр Список полей будет сброшен.

  • Используйте кнопку Разрезать текст в исходных текстовых полях, чтобы выбрать, какие символы из входного значения будут извлечены в целевое поле. Чтобы получить доступ к кнопке Разрезать текст, наведите курсор на текстовое поле в списке входных полей, а затем укажите начальную и конечную позиции символов.

  • Поля также можно сопоставить в скрипте Python.

• В Python при использовании объекта FieldMappings в качестве параметра field_mapping сначала добавьте поля из целевого набора данных, как показано в приведенном ниже коде. Входные поля сопоставляются со схемой целевых полей. Если входные поля добавляются первыми, сопоставление полей может сбросить настройки или вести себя непредсказуемо.

  fieldmappings = arcpy.FieldMappings()
  fieldmappings.addTable(target)
  fieldmappings.addTable(input)
  

• Этот инструмент не разбивает пространственные объекты в точках пересечений при добавлении их целевому набору данных. Все пространственные объекты из входного класса объектов и целевого класса объектов останутся без изменений после присоединения, даже если пространственные объекты перекрываются. Чтобы скомбинировать, или разбить, геометрию пространственных объектов, используйте инструмент Объединение.

• Если для параметра Тип сопоставления полей установлено значение Входные поля должны соответствовать целевым полям, схема входных наборов данных должна соответствовать схеме целевого набора данных для добавления объектов.

  Если для параметра Тип сопоставления полей задано Используйте список полей для согласования изменений, схема не должна соответствовать. Поля из входного набора данных, которые не соответствуют полям целевого набора данных, не будут сопоставлены в целевом наборе данных, если соответствие не будет определено параметром Список полей. Поля в целевом наборе данных, которые не сопоставлены с полями входных наборов данных, будут содержать нулевые значения.

  Если для параметра Тип сопоставления полей установлено значение Пропускать и предупреждать, если схема не совпадает, схема входных наборов данных должна совпадать со схемой целевого набора данных для присоединяемых объектов. Если входной набор данных содержит поля, не соответствующие полям в целевом наборе данных, этот входной набор данных будет пропущен.

• Количество присоединяемых строк отображается в сообщениях инструмента и возвращается в выходных данных Количество присоединенных строк.

• Поскольку данные входных наборов данных записываются в существующий целевой набор данных, имеющий предопределенную схему, вы не сможете использовать параметр Список полей для добавления полей в целевой набор данных и удаления их из него.

• Вы можете использовать этот инструмент для вставки новых и обновления существующих записей в целевой набор данных за одну операцию (аналогично операции UPSERT в базе данных). Используйте параметр Сопоставленные поля для обновления, чтобы указать поля входного набора данных, которые будут соответствовать полям целевого набора данных. Для записей со значениями сопоставленных полей все поля целевой записи будут обновлены значениями в полях с теми же именами во входной записи. Количество обновленных строк с совпадающими полями отображается в сообщениях инструмента и будет возвращено в выходных данных Количество обновленных строк. Геометрия будет обновлена, если стоит отметка Обновить геометрию.

• У входных и целевых наборов данных могут быть различные пространственные привязки. В этом случае инструмент спроецирует входные объекты в целевую систему координат. Для достижения наилучших результатов укажите подходящее географическое преобразование с помощью параметра среды Географические преобразования. Если целевой набор данных - это слой карты, инструмент может применить преобразование по умолчанию. В Python нет преобразования по умолчанию.

• Этот инструмент не выполняет подгонку границ, и корректировка геометрии пространственных объектов производиться не будет.

• Слои карты могут использоваться в качестве значений параметра Входные наборы данных. Если в слое задана выборка, будут использованы только выбранные записи (пространственные объекты или строки таблицы).

• В этом инструменте вы не сможете использовать несколько входных слоев с одинаковыми именами. Вместо этого используйте кнопку обзора на панели Геообработка, чтобы просмотреть полные пути к каждому из значений параметра Входные наборы данных.

• Если входной набор данных и целевой набор данных имеют одинаковое имя, производительность инструмента снизится.

• Чтобы использовать параметр Подтип, e целевого набора данных должно быть заданное поле подтипа и присвоенные коды подтипа. В параметре Подтип задайте описание подтипа, чтобы присвоить этот подтип всем новым данным, которые присоединяются к целевому набору данных.

• Используйте параметр Принудительно использовать домены для принудительного применения атрибутивных доменов к полям целевого набора данных. Если этот параметр отмечен, инструмент будет учитывать значения домена, определенные в целевом наборе данных. Данные из входных полей, которые не соответствуют этим значениям домена, будут вставлены как значения Null.

• Следующие данные относятся к обновлению полей целевого набора данных:

  • Вы можете использовать этот инструмент для вставки новых и обновления существующих записей в целевой набор данных за одну операцию (аналогично операции UPSERT в базе данных). Используйте параметр Сопоставленные поля для обновления, чтобы указать поля входного набора данных, которые будут соответствовать полям целевого набора данных.

  • По умолчанию для записей, содержащих совпадающие значения полей, поля в целевой записи обновляются на значения из входных данных, если у них одинаковые имена. Количество обновленных строк с совпадающими полями будет отображаться в сообщениях инструмента и возвращается параметром Количество обновленных строк.

  • Параметр Поля-кандидаты может использоваться для выборочного обновления или вставки полей в целевой набор данных. Например, для целевого набора данных, содержащего поля с названиями f1, f2, f3 и f4, можно указать, что обновляются только поля f3 и f4 для целевых строк. Для операций вставки будут вставлены только поля f3 и f4.

  • Геометрия будет обновлена, если стоит отметка Обновить геометрию.

  • Чтобы обновлять только геометрию и не обновлять атрибутивные поля в целевом наборе данных, убедитесь, что отмечен параметр Обновить геометрию и что поле Shape — единственное, указанное в параметре Поля-кандидаты . Если целевой сервис является сервисом объектов, подробнее см. ниже в разделе Использование.

  • У параметра Опции пропуска есть следующие опции управления поведением обновлённых и вставленных строк:

    • Не пропускать обновления или вставки—Все строки с соответствующими полями будут обновлены в целевом наборе, а все входные несопоставленные строки будут вставлены.
    • Пропускать вставки для несовпадающих строк (только обновление)—Все строки с совпадающими полями будут обновлены в целевом наборе. Несовпадающие строки из входного набора не будут вставляться.
    • Пропускать обновления для совпадающих строк (только вставка)—В целевом объекте не обновляются строки с совпадающими полями. Вставляются только несовпадающие входные строки.

• Следующее относится к сервисам объектов:

  • Для оптимальной производительности используйте этот инструмент непосредственно в хранилище данных, сервере или базе данных для векторных веб-слоёв. Для сервисов объектов, ссылающихся на базу геоданных, используйте подключение к базе данных для выполнения операций загрузки больших данных непосредственно в исходную базу данных. Для размещенных сервисов ArcGIS Enterprise используйте операцию 'append' со страницы элемента векторного слоя или ArcGIS REST API.

  • Для оптимальной производительности с размещенными сервисами на ArcGIS Online и ArcGIS Enterprise администраторы и владельцы сервисов могут использовать этот инструмент с API ArcGIS REST, если для свойства supportAppend задано значение true. Чтобы пользователи, не являющиеся администраторами, могли использовать этот инструмент с ArcGIS REST API, возможности присоединения сервисов объектов должны быть включены. Для размещённых векторных слоев ArcGIS Enterprise возможность Uploads должна быть включена.

  • Параметр Оптимизировать производительность для сервисов объектов поддерживается только в том случае, если целевой набор данных поддерживает возможности присоединения сервисов объектов. Если этот параметр отмечен, инструмент выполняет следующее:

    • Инструмент будет использовать ArcGIS REST API для оптимальной производительности.

    • Параметр Входные наборы данных будет ограничен одним набором данных.

    • Параметры Выражение и Принудительно использовать домены поддерживаться не будут.

    • Параметр Сопоставленные поля для обновления будет ограничен одной парой сопоставленных полей.

    • Все операции обновления и вставки будут учтены в выходном значении Количество присоединенных строк.

  • Если инструмент запущен в существующем сеансе редактирования или включена кнопка Включить возможность отмены, параметр Оптимизировать производительность для сервисов объектов не будет использоваться.

  • Если отмечен параметр Оптимизировать производительность для сервисов пространственных объектов и значения параметра Сопоставленные поля для обновления содержат сопоставленное поле Global ID, значения Global ID будут сохранены. Если поля Global ID не включены, все входные строки будут вставлены и им будут присвоены новые значения Global ID.

  • Чтобы обновить только геометрию целевого набора данных, отметьте параметр Обновить геометрию и убедитесь, что параметр Поля-кандидаты содержит только имя поля совпадения. Например, если значение параметра Сопоставленные поля для обновления использует поле globalid, то параметр Поля-кандидаты должен содержать только поле globalid.

Параметры

• Dialog
• Python

Подпись	Объяснение	Тип данных
Входные наборы данных	Входные наборы данных, данные которых будут присоединены к целевым наборам данных. Входные наборы данных могут быть классами точечных, линейных или полигональных объектов, таблицами, растрами, классами объектов аннотаций или классами объектов измерений. Таблицы и классы объектов можно комбинировать. Если класс пространственных объектов добавляется к таблице, атрибуты будут перенесены, но объекты будут удалены. Если таблица присоединяется к классу объектов, у строк входной таблицы будет нулевая геометрия.	Table View; Raster Layer
Целевой набор данных	Существующий набор данных, к которому будут присоединены данные входных наборов данных.	Table View; Raster Layer
Тип сопоставления полей (Дополнительный)	Определяет, должны ли для присоединения данных поля входных наборов данных соответствовать полям целевого набора. Входные поля должны соответствовать целевым полям–Поля входных наборов данных должны соответствовать полям целевого набора данных. Если поля не соответствуют, будет выдаваться ошибка. Используется по умолчанию. Используйте список полей для согласования изменений–Поля входных наборов данных не должны соответствовать полям целевого набора данных. Поля входного набора данных, которые не соответствуют полям целевого набора данных, не будут сопоставлены в целевом наборе данных, если соответствие не будет специально определено параметром сопоставления полей. Пропуск и предупреждение при несоответствии–Поля входных наборов данных должны соответствовать полям целевого набора данных. Если какой-то из входных наборов данных содержит поля, не соответствующие полям целевого набора данных, этот входной набор данных будет пропущен, и появится предупреждающее сообщение.	String
Сопоставление полей (Дополнительный)	Параметр списка полей управляет переносом или отображением полей из входных наборов данных в целевой набор данных. Он может использоваться только если Тип сопоставления полей задан как Использовать список полей для согласования изменений. Поскольку входные наборы данных присоединяются к существующему целевому объекту, имеющему предопределенные поля, вы не можете добавлять, удалять, менять порядок или свойства полей в списке полей. Список полей также может использоваться для объединения значений из одного или нескольких входных полей в одно выходное.	Field Mappings
Подтип (Дополнительный)	Описание подтипа, которое будет присвоено всем новым данным, которые присоединяются к целевому набору данных.	String
Выражение (Дополнительный)	SQL-выражение, которое будет использоваться для выбора поднабора записей входного набора данных. Если указано несколько наборов данных, выражение будет применено ко всем. Если во входном наборе данных отсутствуют записи, удовлетворяющие выражению, ни одна запись не будет присоединена к целевому набору. Более подробно о синтаксисе SQL см. [Справочник по SQL для выражений запросов, применяемых в ArcGIS] (../../help/mapping/navigation/sql-reference-for-elements-used-in-query-expressions.md).	SQL Expression
Сопоставленные поля для обновления (Дополнительный)	Поля входных наборов данных, которые будут использоваться для сопоставления с целевым набором данных. Если значения в этих полях совпадают, записи из входных наборов данных обновят соответствующие записи целевого набора. Столбцы таблицы значений: Target Fields–The fields from the target dataset that will be matched. Input Fields–The fields from the input dataset that will be matched.	Value Table
Обновление геометрии (Дополнительный)	Определяет, будет ли геометрия целевого набора данных обновлена геометрией входных наборов, если значения в полях, указанных в параметре match_fields, совпадают. Отмечено–Геометрия целевого набора данных будет обновлена, если значения полей параметра match_fields совпадают. Не отмечено–Геометрия вычисляться не будет. Используется по умолчанию.	Boolean
Принудительно использовать домены (Дополнительный)	Определяет, будут ли принудительно использованы домены полей целевого набора данных. Отмечено–Домены полей целевого набора данных будут принудительно использованы. Если значение входного поля выходит за пределы определения домена целевого поля, запись будет вставлена, но значение входного поля станет Null. Если указаны соответствующие поля для обновления, целевое поле обновлено не будет. Сообщения инструмента будут содержать предупреждение с указанием строк, в которых невозможно записать значения выходных полей. Не отмечено–Домены полей целевого набора данных не будут принудительно использованы. Используется по умолчанию.	Boolean
Оптимизировать производительность для сервисов пространственных объектов (Дополнительный)	Задает, будет ли оптимизирована производительность, если целевым набором данных является ArcGIS Online или сервис объектов ArcGIS Enterprise. Этот параметр активен только в том случае, если целевой набор данных поддерживает оптимизацию. Отмечено–Производительность инструмента будет оптимизирована, если целевым набором данных является сервис объектов с включенной возможностью Присоединить. Это значение по умолчанию, если оно поддерживается целевым сервисом объектов. Оптимизация использует обработку на стороне сервера, при которой входные данные отправляются в API Присоединить сервиса объектов и загружаются в набор данных асинхронно. Когда параметр отмечен, параметры Выражение и Принудительно использовать домены не поддерживаются, а использование параметра Сопоставленные поля для обновления ограничено одним входным набором данных и одной парой полей. Не отмечено–Производительность инструмента не будет оптимизирована, если целевым является сервис объектов.	Boolean
Поля-кандидаты (Дополнительный)	Поля, которые будут обновлены или вставлены в целевой набор данных. Используйте этот параметр, если вы хотите обновить или вставить в целевой набор данных поднабор полей. При добавлении новых записей поля, не включенные в этот список, будут иметь значения Null.	Field
Опции пропуска (Дополнительный)	Определяет, будут ли пропущены обновления или вставки, если задан параметр Сопоставленные поля для обновления. Не пропускать обновления или вставки–Не пропускать обновления или вставки — целевые строки, содержащие совпадающие поля, будут обновлены, а входные строки, не содержащие совпадений, будут вставлены в целевой набор данных. Используется по умолчанию. Пропускать вставки для несовпадающих строк (только обновление)–Входные строки, не содержащие соответствующих полей, не будут вставляться в целевой набор данных. Эта опция обновит только те строки в целевом наборе данных, которые содержат совпадающие поля Пропустить обновление совпадающих строк (только вставка)–Целевые строки, содержащие соответствующие поля из входных наборов данных, не будут обновляться. Этот параметр позволит вставлять из входного набора данных только те строки, которые не содержат совпадающих полей.	String

Производные выходные данные

Подпись	Объяснение	Тип данных
Обновленный целевой набор данных	Обновленный целевой набор данных.	Table View; Raster Layer
Количество присоединенных строк	Количество строк, присоединенных к целевому набору данных. Если отмечен параметр Оптимизировать производительность для сервисов объектов и указано значение параметра Сопоставленные поля для обновления, будут учитываться все операции обновления и вставки	Long
Количество обновленных строк	Количество обновленных строк в целевом наборе данных. Количество обновленных строк не будет предоставлено для целевых наборов данных сервисов объектов, если отмечен параметр Оптимизировать производительность для сервисов объектов.	Long

Параметры среды

Экстент, Текущая рабочая область, Сохранение Global ID, Поддержка вложений, Географические преобразования

Особые случаи

Сохранение Global ID

For the Append tool, this environment will only preserve Global ID values from the input dataset if the target Global ID field has a unique index. If the target Global ID field does not have a unique index, the tool may fail. To add a unique index to a Global ID field, use the Add Attribute Index tool.

If the target dataset contains a Global ID field and the input data does not, running the Append tool with this environment set to True will automatically generate new Global ID values for inserted rows.

This environment is ignored for target feature services. To preserve Global IDs for feature services that support optimization, check the Optimize performance for feature services parameter and specify GlobalID as the match fields in the Matching Fields for Update parameter.

Информация о лицензировании

• Basic: Да
• Standard: Да
• Advanced: Да

Связанные разделы

• Обзор группы инструментов Общие
• Поиск инструмента геообработки
• Сопоставление атрибутивных полей
• Слияние
• Объединить
• Сопоставление входных полей с выходными полями