Incorporar datos (Geoanálisis)

Resumen

Incorpora entidades a una capa de entidades alojada existente.

Ilustración

Diagrama del flujo de trabajo de Incorporar datos
Flujo de trabajo de Incorporar datos

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 herramientaCopiar en data store o comparta una capa en su portal. Para obtener más información sobre cómo compartir capas, consulteIntroducció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 incorporar o Expresiones para incorporar para concordar campos con nombres diferentes o calcular valores de campos especificados.

      Más información sobre expresiones de Incorporar datos

  • Los campos de Capa de incorporación que no se hayan concordado en el parámetro Campos para incorporar o 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 Country de 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 Population y area_km2. Los investigadores quieren concordar el campo Country con el campo Country, incorporar el campo Population al campo Pop_ y calcular la densidad de población para el campo Pop_Density mediante un cálculo matemático.

    Ejemplo de esquemas de capa de entrada y capa de incorporación
    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_Density no tienen ningún campo coincidente en la capa de incorporación y se incorporarán con valores null.

    Ejemplo de asignación de campos predeterminada
    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 incorporar para incorporar el Campo de entrada Pop_con valores del Campo para incorporar Population. Utilice el parámetro Expresiones para incorporar para calcular los valores de Pop_Density para las entidades de incorporación con los campos de la capa de incorporación Population y area_km2 creando la siguiente expresión de Arcade: $feature["Population"]/$feature["area_km2"].

    Ejemplo de asignación de campos definida
    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. 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

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de entrada

La capa de entidades alojada a la que se incorporarán entidades.

Record Set
Capa de incorporación

La capa que contiene las entidades que se incorporarán a la capa de entrada.

Record Set
Método para incorporar
(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.

  • Incorporar solo campos coincidentesLos campos de la capa de entrada solo se incorporarán si tienen un campo coincidente en la capa de incorporación. Los campos que no tengan un campo coincidente se incorporarán con valores nulos.
  • Incorporar campos coincidentes y resolver diferenciasEs posible incorporar campos de la capa de entrada con campos de la capa de incorporación del mismo nombre y de un tipo diferente, o con valores calculados con expresiones de Arcade.
String
Campos para incorporar
(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
Expresiones para incorporar
(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.

Seleccione los campos a los que desea incorporar e introduzca una expresión para cada uno, para calcular los valores que desea incorporar. Si se agrega la capa al mapa, es posible usar los campos y auxiliar para construir una expresión.

Value Table

Salida derivada

EtiquetaExplicaciónTipo de datos
Resultado de incorporación

La entrada actualizada en la que se han incorporado las entidades.

Record Set

arcpy.geoanalytics.AppendData(input_layer, append_layer, {append_method}, {append_fields}, {append_expressions})
NombreExplicaciónTipo 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.

  • MATCHING_ONLYLos campos de la capa de entrada solo se incorporarán si tienen un campo coincidente en la capa de incorporación. Los campos que no tengan un campo coincidente se incorporarán con valores nulos.
  • FIELD_MAPPINGEs posible incorporar campos de la capa de entrada con campos de la capa de incorporación del mismo nombre y de un tipo diferente, o con valores calculados con expresiones de Arcade.
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

NombreExplicaciónTipo de datos
append_result

La entrada actualizada en la que se han incorporado las entidades.

Record Set

Muestra de código

Ejemplo de AppendData (script independiente)

La siguiente secuencia de comandos 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

Casos especiales

Información de licenciamiento

  • Basic: Requiere ArcGIS GeoAnalytics Server
  • Standard: Requiere ArcGIS GeoAnalytics Server
  • Advanced: Requiere ArcGIS GeoAnalytics Server

Temas relacionados