Сводка
Присоединяет объекты к имеющемуся размещенному слою объектов.
Иллюстрация
Использование
Этот инструмент геообработки доступен с версией ArcGIS Enterprise 10.6 или более новой.
Входной слой должен быть размещенным точечный, линейным, полигональным или табличным слоем Чтобы присоединить данные к другому слою, необходимо сначала создать размещенный слой из набора данных. Для этого используйте инструмент Копировать в хранилище данных или опубликуйте слой на портале. Более подробно о публикации слоев см. в разделе Введение в публикацию веб-слоев.
Присоединяемый слой может быть точечным, линейным, полигональным или таблицей в формате файлового хранилища больших данных или векторного слоя.
Слой присоединения должен содержать такой же тип геометрии, как и Входящий слой. Например, присоединяйте табличные объекты к табличным, точечные - к точечным. Если тип геометрии не совпадает, объекты присоединены не будут.
Слой присоединения должен содержать такой же тип времени, как и Входной слой. Это может быть моментальное время, интервал или нет.
Поля, геометрия и время Входного слоя не меняются.
Для присоединения объектов используется два метода:
- Присоединять только совпадающие поля - присоединяются только поля с совпадающими именами и типами. Это поведение по умолчанию.
- Присоединение совпадающих полей и устранение различий - используйте параметр Присоединить поля или Присоединить выражения, чтобы сопоставить поля с различными именами или вычислить значения для указанных полей.
Любые поля из Слоя присоединения, которые не совпадают с параметром Присоединить поляили Присоединить выражения, будут исключены из результатов присоединения.
Например, исследователь миграции населения хочет присоединить наборы данных ко входному слою и присоединить схемы слоев, показанные ниже. Все слои имеют общее поле Country типа text, а также два дополнительных поля с одинаковым типом данных, но разными именами. Входной слой содержит поля Pop_ и Pop_Density, а слой присоединения - поля Population и area_km2. Исследователь хочет присоединить поле Country к полю Country, поле Population к полю Pop_ и вычислить плотность населения для поля Pop_Density, используя математические выражения.
По умолчанию, Присоединить данныесопоставит поля Country, поскольку их имена и тип данных совпадают. По умолчанию, поля Pop_ и Pop_Density не имеют совпадений в слое присоединения и будут присоединяться со значениями null.
Выберите для Метода присоединения опцию Присоединение совпадающих полей и устранение различий, чтобы задать собственные параметры сопоставления полей. Используйте параметр Присоединить поля, чтобы присоединить Входное поле Pop_ к значениям из Поля присоединения Population. Используйте параметр Присоединить выражения, чтобы вычислить значения Pop_Densityдля присоединения объектов, используя поля присоединяемого поля Population и area_km2, создав следующее выражение Arcade: $feature["Population"]/$feature["area_km2"].
Этот инструмент геообработки работает на ArcGIS GeoAnalytics Server. Анализ выполняется на вашем GeoAnalytics Server, а результаты сохраняются в ресурсы на вашем ArcGIS Enterprise.
При работе инструментов GeoAnalytics Server, анализ выполняется на GeoAnalytics Server. Для оптимальной производительности сделайте данные доступными для GeoAnalytics Server через векторные слои, размещенные на вашем портале ArcGIS Enterprise или через файловое хранилище больших данных. Данные, которые не являются локальными для GeoAnalytics Server, будут перемещены на GeoAnalytics Server до начала анализа. Это означает, что для запуска инструмента потребуется больше времени, а в некоторых случаях перемещение данных с ArcGIS Pro на GeoAnalytics Server может завершиться ошибкой. Порог сбоя зависит от скорости сети, а также от размера и сложности данных. Соответственно рекомендуется всегда предоставлять доступ к данным или создавать файловое хранилище больших данных.
Более подробно о публикации локаторов на портале
Более подробно о создании файловых хранилищ больших данных в Server Manager
Синтаксис
arcpy.geoanalytics.AppendData(input_layer, append_layer, {append_method}, {append_fields}, {append_expressions})
Parameter | Объяснение | Тип данных |
input_layer | Размещенный слой объектов, к которому будут присоединяться объекты. | Record Set |
append_layer | Слой содержащий объекты, присоединяемые к входному слою. | Record Set |
append_method (Дополнительный) | Задает способ присоединения к полям Входного слоя значений из Слоя присоединения.
| String |
append_fields [append_fields,...] (Дополнительный) | Присоединяются поля из слоя присоединения с таким же типом данных, но с другими именами. Выберите Входное поле, к которому вы хотите присоединить данные, и Поле присоединения, содержащее нужные вам значения. | Value Table |
append_expressions [append_expressions,...] (Дополнительный) | Выражение Arcade, используемое для вычисления значений для входного поля. Выражения создаются в Arcade и могут включать математические операторы и несколько полей. | Value Table |
Производные выходные данные
Name | Объяснение | Тип данных |
append_result | Обновленные входные данные, к которым присоединены объекты. | Набор записей |
Пример кода
В следующем автономном скрипте показано, как использовать инструмент AppendData.
# Description: Append February 2018 sales records to your ANNUAL_SALES2018
# hosted layer.
#
# Caution: AppendData updates your ANNUAL_SALES2018 layer with appended
# features.
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
inputLayer = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/ANNUAL_SALES2018/FeatureServer/0"
appendLayer = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/DataStoreCatalogs/bigDataFileShares_sales2018/BigDataCatalogServer/FEBRUARY_SALES2018"
appendMethod = "FIELD_MAPPING"
fieldMapping = "Pop_ Population;State_ StateName",
expressionMapping = "Pop_density $feature.Population/$feature.area_km2;Unused_field null"
# Execute Append Data
arcpy.geoanalytics.AppendData(inputLayer, appendLayer, appendMethod,
fieldMapping, expressionMapping)
Environments
Информация о лицензиях
- Basic: Требуется ArcGIS GeoAnalytics Server
- Standard: Требуется ArcGIS GeoAnalytics Server
- Advanced: Требуется ArcGIS GeoAnalytics Server