Присоединить данные (GeoAnalytics)

Сводка

Присоединяет объекты к имеющемуся размещенному слою объектов.

Иллюстрация

Схема рабочего процесса Присоединить данные
Рабочий процесс Присоединить данные

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

  • Этот инструмент геообработки доступен с версией 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

Синтаксис

AppendData(input_layer, append_layer, {append_method}, {append_fields}, {append_expressions})
ParameterОбъяснениеТип данных
input_layer

Размещенный слой объектов, к которому будут присоединяться объекты.

Record Set
append_layer

Слой содержащий объекты, присоединяемые к входному слою.

Record Set
append_method
(Дополнительный)

Задает способ присоединения к полям Входного слоя значений из Слоя присоединения.

  • MATCHING_ONLYПоля входного слоя будут присоединяться, только если в слое присоединения имеются совпадающие поля. Поля без сопоставления будут присоединяться с нулевыми значениями.
  • FIELD_MAPPINGПоля входного слоя могут быть соединены с полями слоя присоединения с такими же именами, но другими типами, или со значениями, вычисленными с помощью выражений Arcade.
String
append_fields
[append_fields,...]
(Дополнительный)

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

Value Table
append_expressions
[append_expressions,...]
(Дополнительный)

Выражение Arcade, используемое для вычисления значений для входного поля. Выражения создаются в Arcade и могут включать математические операторы и несколько полей.

Value Table

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

NameОбъяснениеТип данных
append_result

Обновленные входные данные, к которым присоединены объекты.

Набор записей

Пример кода

AppendData, пример (автономный скрипт)

В следующем автономном скрипте показано, как использовать инструмент AppendData.

#-------------------------------------------------------------------------------
# Name: AppendData.py
# 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)

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

  • Basic: Требуется ArcGIS GeoAnalytics Server
  • Standard: Требуется ArcGIS GeoAnalytics Server
  • Advanced: Требуется ArcGIS GeoAnalytics Server

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