Resumen
Incorpora entidades a una capa de entidades alojada existente.
Ilustración
Uso
Esta herramienta de geoprocesamiento está disponible con ArcGIS Enterprise 10.6.1 o posterior.
La capa de entrada debe ser una capa de puntos, líneas, polígonos o tablas alojada existente. Para incorporar una capa diferente, debe crear primero una capa alojada de ese dataset. Para ello, utilice la herramienta Copiar a data store o comparta una capa en su portal. Para obtener más información sobre cómo compartir capas, consulte Introducción al uso compartido de capas web.
La capa de incorporación puede ser un dataset o una capa de entidades de un recurso compartido de archivos de big data de puntos, líneas, polígonos o tablas.
La Capa de incorporación debe tener el mismo tipo de geometría que la Capa de entrada. Por ejemplo, incorpore entidades de tabla a entidades de tabla, y entidades de punto a entidades de punto. No se incorporará ninguna entidad si los tipos de geometría no coinciden.
La Capa de incorporación debe tener el mismo tipo de tiempo que la Capa de entrada. Estos tipos pueden ser: instante, intervalo o ninguno.
Los campos, la geometría y el tiempo de la Capa de entrada no se modificarán.
Pueden utilizarse los dos métodos siguientes para incorporar entidades:
- Incorporar solo campos coincidentes: solo se incorporarán los campos con nombres y tipos coincidentes. Este es el comportamiento predeterminado.
- Incorporar campos coincidentes y resolver diferencias: utilice el parámetro Campos para incorporaro Expresiones para incorporar para concordar campos con nombres diferentes o calcular valores de campos especificados.
Los campos de Capa de incorporaciónque no se hayan concordado en el parámetro Campos para incorporaro Expresiones para incorporar se excluirán de los resultados incorporados.
Por ejemplo, unos investigadores sobre migraciones humanas quieren incorporar datasets con los esquemas de capa de entrada y capa de incorporación que aparecen más abajo. Ambas capas tienen un campo en común, llamado Countryde tipo text, y ambas tienen dos campos adicionales con el mismo tipo de datos, pero con nombres únicos. La capa de entrada tiene los campos Pop_y Pop_Density, y la capa de incorporación tiene los campos Populationy area_km2. Los investigadores quieren concordar el campo Countrycon el campo Country, incorporar el campo Populational campo Pop_y calcular la densidad de población para el campo Pop_Densitymediante un cálculo matemático.
Esquemas de ejemplo de capa de entrada y capa de incorporación para su uso en la herramienta Incorporar datos De forma predeterminada, Incorporar datos concordará los campos Country, porque tienen el mismo nombre de campo y tipo de campo. De forma predeterminada, los campos Pop_y Pop_Densityno tienen ningún campo coincidente en la capa de incorporación y se incorporarán con valores null.
Asignación de campos predeterminada que se aplicará cuando la opción Incorporar solo campos coincidentes esté seleccionada en el Método para incorporar. Seleccione la opción Método para incorporar de Incorporar campos coincidentes y resolver diferencias para definir sus propias especificaciones de asignación de campos. Utilice el parámetro Campos para incorporarpara incorporar el Campo de entrada Pop_con valores del Campo para incorporar Population. Utilice el parámetro Expresiones para incorporarpara calcular los valores de Pop_Densitypara las entidades de incorporación con los campos de la capa de incorporación Populationy area_km2creando la siguiente expresión de Arcade: $feature["Population"]/$feature["area_km2"].
Asignación de campos definida según lo especificado en los parámetros Campos para incorporar y Expresiones para incorporar. Esta herramienta de geoprocesamiento se basa en ArcGIS GeoAnalytics Server. El análisis se completa en su GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.
Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para su GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Por lo tanto, se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.
Más información acerca del uso compartido de datos en el portal
Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager
Sintaxis
arcpy.geoanalytics.AppendData(input_layer, append_layer, {append_method}, {append_fields}, {append_expressions})| Parámetro | Explicación | Tipo de datos |
input_layer | La capa de entidades alojada a la que se incorporarán entidades. | Record Set |
append_layer | La capa que contiene las entidades que se incorporarán a la capa de entrada. | Record Set |
append_method (Opcional) | Especifica el modo en que los campos de la Capa de entrada se incorporarán con los valores de la Capa de incorporación.
| String |
append_fields [append_fields,...] (Opcional) | Los campos de la capa de incorporación del mismo tipo y de nombre distinto de los campos de la capa de entrada que se van a incorporar. Seleccione el Campo de entrada al que desea incorporar y el Campo para incorporar que contiene los valores que desea incorporar. | Value Table |
append_expressions [append_expressions,...] (Opcional) | La expresión de Arcade utilizada para calcular valores de campo para el campo de entrada. Las expresiones están escritas en Arcade y pueden incluir operadores matemáticos y varios campos. | Value Table |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| append_result | La entrada actualizada en la que se han incorporado las entidades. | Conjunto de registros |
Muestra de código
El siguiente script independiente muestra cómo utilizar la herramienta 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)Entornos
Información de licenciamiento
- Basic: Requiere ArcGIS GeoAnalytics Server
- Standard: Requiere ArcGIS GeoAnalytics Server
- Advanced: Requiere ArcGIS GeoAnalytics Server