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

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

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

Иллюстрация

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

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

  • Этот инструмент геообработки доступен с версией ArcGIS Enterprise 10.6.1 или более новой.

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

  • Присоединяемый слой может быть точечным, линейным, полигональным или табличным набором данных файлового хранилища больших данных или векторным слоем.

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

  • Присоединяемый слой должен содержать такой же тип времени, как и Входной слой. Это может быть моментальное время, интервал или нет.

  • Поля, геометрия и время Входного слоя не меняются.

  • Для присоединения объектов используется два метода:

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

      Более подробно о выражениях Присоединить данные

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

    Например, исследователь миграции населения хочет присоединить наборы данных со схемами входного слоя и присоединяемого слоя, показанными ниже. Оба слоя имеют поле с общим названием 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

Параметры

ПодписьОписаниеТип данных
Входной слой

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

Record Set
Присоединяемый слой

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

Record Set
Метод присоединения
(Дополнительный)

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

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

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

Value Table
Присоединить выражения
(Дополнительный)

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

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

Value Table

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

ПодписьОписаниеТип данных
Результат присоединения

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

Record Set

arcpy.geoanalytics.AppendData(input_layer, append_layer, {append_method}, {append_fields}, {append_expressions})
ИмяОписаниеТип данных
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

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

ИмяОписаниеТип данных
append_result

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

Record Set

Пример кода

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

В следующем автономном скрипте показано, как использовать инструмент 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)

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

  • Basic: Обязательно ArcGIS GeoAnalytics Server
  • Standard: Обязательно ArcGIS GeoAnalytics Server
  • Advanced: Обязательно ArcGIS GeoAnalytics Server

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