Incorporar (Herramientas de administración de datos)

Resumen

Adjunta múltiples datasets de entrada a un dataset de destino existente, y opcionalmente lo actualiza con ellos. Los datasets de entrada pueden ser clases de entidad, tablas, shapefiles, rásteres o clases de entidad de anotación o de dimensión. Las entradas también pueden ser servicios de entidades alojados.

Para combinar datasets de entrada en un nuevo dataset de salida, utilice la herramienta Fusionar.

Ilustración

Uso

• Utilice esta herramienta para agregar nuevas entidades u otros datos de varios datasets a un dataset existente. Esta herramienta puede adjuntar clases de entidad de punto, de línea o poligonal, tablas, rásteres o clases de entidad de anotación o de dimensión a un dataset existente del mismo tipo. Por ejemplo, se pueden adjuntar varias tablas a una tabla existente, o varios rásteres a un dataset ráster existente, pero una clase de entidad de línea no se puede adjuntar a una clase de entidad de punto.

• Use el parámetro Mapa de campo para controlar la forma en que se transfiere la información de los atributos desde los campos del dataset de entrada al dataset de destino. El parámetro Mapa de campos solo se puede utilizar si se especifica Utilizar el mapa de campos para conciliar las diferencias de campos en el parámetro Tipo de coincidencia de campos.

• Utilice el parámetro Mapa de campo para asignar o hacer corresponder los campos de los dataset de entrada con los campos del dataset de destino.

  • Use una acción para determinar cómo se asignarán los valores de uno o varios campos del dataset de entrada en un solo campo del dataset de destino.

  • Las acciones disponibles son Primera, Última, Concatenación, Suma, Valor medio, Mediana, Modo, Mínimo, Máximo, Desviación estándar y Recuento.

  • Al usar la acción Concatenar, pude especificar un delimitador tal como una coma u otro carácter. Haga clic en el inicio del cuadro de texto Delimitador para agregar los caracteres delimitadores.

  • Desviación estándar no es una opción válida para los valores de entrada únicos.

  • Utilice la opción Exportar para guardar un mapa de campo como un archivo .fieldmap.

  • Utilice la opción Cargar para cargar un archivo .fieldmap. La capa de entidades o el dataset especificado en el archivo debe coincidir con el dataset utilizado en la herramienta. De lo contrario, el parámetro Mapa de campo se restablecerá.

  • Use el botón Trocear texto en los campos de origen de texto para elegir qué caracteres de un valor de entrada se extraerán al campo de destino. Para acceder al botón Trocear texto, pase el cursor del ratón por encima de un campo de texto de la lista de campos de entrada; a continuación, especifique las posiciones de los caracteres de inicio y fin.

  • Los campos también se pueden asignar en un script de Python.

• En Python, cuando utilice el objeto FieldMappings para el parámetro field_mapping, agregue primero los campos del dataset de destino, tal y como se muestra en el código siguiente. Los campos de entrada se asignan al esquema de los campos de destino. Cuando se agreguen primero los campos de entrada, el mapa de campos puede restablecerse o comportarse de forma inesperada.

  fieldmappings = arcpy.FieldMappings()
  fieldmappings.addTable(target)
  fieldmappings.addTable(input)
  

• Esta herramienta no planarizará las entidades cuando las agregue al dataset de destino. Todas las entidades tanto de la clase de entidad de entrada como de la clase de entidad de destino permanecerán intactas después de adjuntar, incluso si se superponen. Para combinar o planarizar geometrías de entidad, utilice la herramienta Combinación.

• Si el parámetro Tipo de coincidencia de campos está establecido como Los campos de entrada deben coincidir con los campos de destino, el esquema de los datasets de entrada debe coincidir con el del dataset de destino para poder incorporar las entidades.

  Si el parámetro Tipo de coincidencia de campos está establecido como Usar el Mapa de campo para conciliar las diferencias de campo, no es necesario que los esquemas coincidan. Los campos del dataset de entrada que no coincidan con los campos del dataset de destino no se asignarán al dataset de destino, a menos que la asignación esté establecida de manera en el parámetro Mapa de campo. Los campos en el dataset de destino no asignados a campos de los datasets de entrada contendrán valores nulos.

  Si el parámetro Tipo de coincidencia de campos se establece como Omitir y emitir un mensaje de advertencia si el esquema no coincide, el esquema de los datasets de entrada debe coincidir con el del dataset de destino para las entidades que se van a incorporar. Si un dataset de entrada contiene campos que no coinciden con los campos del dataset de destino, ese dataset de entrada se omitirá.

• El número de filas incorporadas se muestra en los mensajes de la herramienta y se devuelve mediante la salida Recuento de filas incorporadas.

• Dado que los datos de los datasets de entrada se escriben en un dataset destino existente con un esquema predefinido, no puede usar el parámetro Mapa de campo para agregar o eliminar campos del dataset destino.

• Puede usar esta herramienta para insertar nuevos registros y actualizar los registros existentes en un dataset destino en la misma operación (equivalente a una operación de base de datos de UPSERT). Use el parámetro Campos coincidentes para actualizar para especificar que los campos del dataset de entrada coincidan con los campos del dataset destino. Para los registros con valores de campos coincidentes, cualquier campo del registro destino se actualizará con los valores de los campos con el mismo nombre en el registro de entrada. El número de filas actualizadas con campos coincidentes se muestra en los mensajes de la herramienta y se devuelve mediante la salida Recuento de filas actualizadas. La geometría se actualizará si el parámetro Actualizar geometría está activado.

• Los datasets de entrada y destino pueden tener referencias espaciales diferentes. Cuando esto sucede, la herramienta proyecta las entidades de entrada en el sistema de coordenadas del destino. Para obtener los mejores resultados, especifique una transformación geográfica adecuada mediante el entorno Transformaciones geográficas. Si el dataset destino es una capa de mapa, la herramienta podrá aplicar una transformación predeterminada. En Python, no hay transformación predeterminada.

• Esta herramienta no realiza ajuste de bordes; no se realizará ningún ajuste en la geometría de las entidades.

• Las capas de mapa se pueden utilizar como valores de los parámetros de los Datasets de entrada. Si una capa tiene una selección, solo se usarán los registros seleccionados (entidades o filas de tabla).

• En esta herramienta no se pueden utilizar varias capas de entrada con el mismo nombre. Para evitar esta limitación, utilice el botón Examinar del panel Geoprocesamiento para examinar las rutas completas de los valores de cada uno de los Datasets de entrada.

• Si un dataset de entrada y el dataset de destino tienen el mismo nombre, la herramienta tendrá un rendimiento reducido.

• Para utilizar el parámetro Subtipo, el dataset de destino debe tener un campo de subtipo definido y códigos de subtipo asignados. En el parámetro Subtipo, proporcione una descripción del subtipo para asignar este subtipo a todos los datos nuevos que se adjuntan al dataset de destino.

• Utilice el parámetro Aplicar dominios para aplicar dominios de atributos a los campos del dataset de destino. Cuando se marca este parámetro, la herramienta respetará los valores de dominio definidos en el dataset de destino. Los datos de los campos de entrada que no se ajusten a estos valores de dominio se insertarán como valores nulos.

• Lo siguiente se refiere a la actualización de los campos del dataset de destino:

  • Utilice esta herramienta para insertar nuevos registros y actualizar los registros existentes en un dataset destino en la misma operación (equivalente a una operación de base de datos de UPSERT). Use el parámetro Campos coincidentes para actualizar para especificar que los campos del dataset de entrada coincidan con los campos del dataset destino.

  • De forma predeterminada, en el caso de los registros que contengan valores de campo coincidentes, los campos del registro de destino se actualizarán con los valores del registro de origen si tienen el mismo nombre de campo. El número de filas actualizadas con campos correlacionados se mostrará en los mensajes de la herramienta y se devuelve mediante el parámetro Recuento de filas actualizadas derivado.

  • El parámetro Campos candidatos se puede utilizar para actualizar o insertar campos de forma selectiva en el dataset de destino. Por ejemplo, en el caso de un dataset de destino que contenga los campos f1, f2, f3 y f4, se puede especificar que solo se actualicen los campos f3 y f4 en las filas de destino. En las operaciones de inserción, solo se insertarán los campos f3 y f4.

  • La geometría se actualizará si el parámetro Actualizar geometría está activado.

  • Para actualizar únicamente la geometría y no los campos de atributos en el dataset de destino, asegúrese de que el parámetro Actualizar geometría esté marcado y de que el campo Forma sea el único campo especificado en el parámetro Campos candidatos. Si el destino es un servicio de entidades, consulta más abajo, en la sección Uso.

  • El parámetro Opciones de omisión ofrece las siguientes opciones para controlar el comportamiento de las filas actualizadas e insertadas:

    • No omitir actualizaciones ni inserciones: todas las filas con campos coincidentes se actualizarán en la tabla de destino, y todas las filas de la tabla de origen que no coincidan se insertarán.
    • Omitir inserciones de filas no coincidentes (solo actualizar): se actualizarán en el destino todas las filas cuyos campos coincidan. Las filas sin correspondencia del dataset de entrada no se insertarán.
    • Omitir actualizaciones para filas coincidentes (solo insertar): no se actualizarán en el destino las filas cuyos campos coincidan. Solo se insertarán las filas de la entrada que no tengan correspondencia.

• Los siguientes puntos se refieren a los servicios de entidades:

  • Para obtener un rendimiento óptimo, utilice esta herramienta directamente en el data store, en el servidor o en la base de datos para las capas de entidades web. En el caso de servicios de entidades que hacen referencia a una geodatabase, utilice una conexión de base de datos para llevar a cabo grandes operaciones de carga de datos directamente sobre la base de datos subyacente. Para servicios alojados en ArcGIS Enterprise, utilice la operación append de la página de elementos de la capa d eentidades o la API REST de ArcGIS.

  • Para obtener un rendimiento óptimo con los servicios alojados en ArcGIS Online y ArcGIS Enterprise, los administradores y los propietarios de los servicios pueden utilizar esta herramienta con la ArcGIS REST API cuando la propiedad supportAppend sea true. Las capacidades de agregar servicios de entidades deben estar habilitadas para que los usuarios que no sean administradores puedan utilizar esta herramienta con ArcGIS REST API. Para capas de entidades alojadas de ArcGIS Enterise, la capacidad Uploads debe estar habilitada.

  • El parámetro Optimizar el rendimiento para servicios de entidades solo se admite cuando el dataset de destino admite capacidades de adición de servicios de entidades. Si se marca esta opción, la herramienta hará lo siguiente:

    • La herramienta utilizará ArcGIS REST API para garantizar un rendimiento óptimo.

    • El parámetro Dataset de entrada se limitará a un dataset.

    • Los parámetros Expresión y Aplicar dominios no serán compatibles.

    • El parámetro Campos coincidentes para actualizar se limitará a un par de campos coincidentes.

    • Todas las operaciones de actualización e inserción se contarán en el valor de salida Recuento de filas incorporadas.

  • Cuando la herramienta se ejecuta en una sesión de edición existente o el botón de alternancia Habilitar deshacer está activado, se ignorará el parámetro Optimizar rendimiento para servicios de entidades.

  • Si el parámetro Optimizar rendimiento para servicios de entidades está marcado y los valores del parámetro Campos coincidentes para actualizar tienen un campo Global ID coincidente, se conservarán los valores de Id. global. Si los campos Global ID no están incluidos, se insertarán todas las filas de entrada y se les asignarán nuevos valores de Id. global.

  • Para actualizar únicamente la geometría del dataset de destino, marque la casilla Actualizar geometría y asegúrese de que el parámetro Campos candidatos contenga únicamente el nombre del campo de coincidencia. Por ejemplo, si el valor del parámetro Campos coincidentes para actualizar utiliza el campo globalid, el parámetro Campos candidatos debería contener únicamente el campo globalid.

Parámetros

• Dialog
• Python

Etiqueta	Explicación	Tipo de datos
Datasets de entrada	Los dataset de entrada que contienen los datos que se agregarán al dataset de destino. Los datasets de entrada pueden ser clases de entidad de punto, de línea o poligonal, tablas, rásteres, clases de entidad de anotación o clases de entidad de dimensión. Las tablas y clases de entidad se pueden combinar. Si se incorpora una clase de entidad a una tabla, los atributos se transfieren; no obstante, las entidades se eliminarán. Si se incorpora una tabla a una clase de entidad, las filas de la tabla de entrada tendrán una geometría nula.	Table View; Raster Layer
Dataset destino	El dataset existente al que se incorporarán los datos de los datasets de entrada.	Table View; Raster Layer
Tipo de coincidencia de campos (Opcional)	Especifica si los campos de los datasets de entrada deben coincidir con los campos de los datasets de destino para que se incorporen los datos. Los campos de entrada deben coincidir con los campos de destino—Los campos de los datasets de entrada deben coincidir con los campos del dataset de destino. Se devolverá un error si los campos no coinciden. Esta es la opción predeterminada. Utilizar el mapa de campo para conciliar las diferencias de campo—No es necesario que los campos de los datasets de entrada coincidan con los campos del dataset de destino. Los campos de los datasets de entrada que no coincidan con los campos del dataset de destino no se asignarán al dataset de destino, a menos que la asignación esté establecida de manera explícita en el parámetro Mapa de campo. Omitir y emitir un mensaje de advertencia si el esquema no coincide—Los campos de los datasets de entrada deben coincidir con los campos del dataset de destino. Si alguno de los datasets de entrada contiene campos que no coinciden con los campos del dataset de destino, ese dataset de entrada se omitirá y se generará un mensaje de advertencia.	String
Mapa de campo (Opcional)	El parámetro de mapa de campo controla la transferencia o la correspondencia de los campos de los datasets de entrada con el dataset de destino. Solo puede utilizarse si el parámetro Tipo de coincidencia de campos tiene el valor Utilizar el mapa de campo para conciliar las diferencias de campo. Dado que los datasets de entrada se incorporan a un dataset de destino existente que tiene campos predefinidos, no es posible agregar, eliminar, reordenar ni cambiar las propiedades de los campos del mapa de campo. El mapa de campo puede usarse para combinar valores de uno o más campos de entrada en un solo campo de salida.	Field Mappings
Subtipo (Opcional)	Descripción del subtipo que se asignará a todos los datos nuevos incorporados al dataset de destino.	String
Expresión (Opcional)	La expresión SQL que se usará para seleccionar un subconjunto de los registros de los datasets de entrada. Si se especifican varios datasets de entrada, se evaluarán utilizando la expresión. Si no hay ningún registro que coincida con la expresión de un dataset de entrada, no se incorporará ningún registro de ese dataset al dataset de destino. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression
Campos coincidentes para actualizar (Opcional)	Los campos de los datasets de entrada que se usarán para buscar la coincidencia con los campos del dataset de destino. Si los valores de esos campos coinciden, los campos del dataset de destino se actualizarán con los valores de los registros de los datasets de entrada. Columnas de la tabla de valores: Target Fields—The fields from the target dataset that will be matched. Input Fields—The fields from the input dataset that will be matched.	Value Table
Actualizar geometría (Opcional)	Determina si la geometría del dataset de destino se actualizará con la geometría del dataset de entrada si los valores de campo del parámetro match_fields coinciden. Activado—La geometría del dataset de destino se actualizará si los valores de campo del parámetro match_fields coinciden. Desactivado—La geometría no se actualizará. Esta es la opción predeterminada.	Boolean
Aplicar dominios (Opcional)	Especifica si se aplicarán los dominios de campo del destino. Activado—Se aplicarán los dominios de campo del objetivo. Si el valor de un campo de entrada está fuera de la definición del dominio del campo de destino, el registro se insertará, pero el campo de entrada será nulo. Si se especifican campos coincidentes para la actualización, el campo de destino no se actualizará. Los mensajes de la herramienta incluirán un mensaje de advertencia que identificará las filas en las que no se pueden escribir los valores del campo de salida. Desactivado—No se aplicarán los dominios de campo del objetivo. Esta es la opción predeterminada.	Boolean
Optimizar el rendimiento para los servicios de entidades (Opcional)	Especifica si se optimizará el rendimiento cuando el dataset de destino sea un servicio de entidades de ArcGIS Online o ArcGIS Enterprise. Este parámetro solo está activo cuando el dataset de destino admite la optimización. Activado—El rendimiento de la herramienta se optimizará cuando el dataset de destino sea un servicio de entidades con la capacidad Incorporar habilitada. Esta es la opción predeterminada cuando el servicio de entidades de destino lo admite. La optimización utiliza el procesamiento del lado del servidor, en el que los datos de entrada se envían a la API Incorporar del servicio de entidades y se cargan en el dataset de forma asíncrona. Cuando el parámetro está marcado, los parámetros Expresión y Aplicar dominios no son compatibles, y el uso del parámetro Campos coincidentes para actualizar se limita a un dataset de entrada y un par de campos. Desactivado—El rendimiento de la herramienta no se optimizará cuando el destino sea un servicio de entidades.	Boolean
Campos candidatos (Opcional)	Campos que se actualizarán o se insertarán en el dataset de destino. Utilice este parámetro si desea que se actualice o se inserte un subconjunto de campos en el dataset de destino. Al introducir nuevos registros, los campos que no figuren en esta lista tendrán valores nulos.	Field
Omitir opciones (Opcional)	Especifica si las actualizaciones o inserciones se omitirán cuando se especifique el parámetro Campos coincidentes para actualizar. No omitir actualizaciones ni inserciones—Las filas de destino que contengan campos coincidentes se actualizarán y las filas de entrada que no contengan coincidencias se insertarán en el dataset de destino. Esta es la opción predeterminada. Omitir inserciones de filas no coincidentes (solo actualizar)—Las filas de entrada que no contengan campos coincidentes no se insertarán en el dataset de destino. Esta opción solo actualizará las filas del dataset de destino que contengan campos coincidentes. Omitir actualizaciones para filas coincidentes (solo insertar)—Las filas de destino que contengan campos coincidentes de los datasets de entrada no se actualizarán. Esta opción solo insertará nuevas filas del dataset de entrada que no contengan campos coincidentes.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Dataset objetivo actualizado	El dataset de destino actualizado.	Table View; Raster Layer
Recuento de filas incorporadas	El número de filas incorporadas al dataset de destino. Cuando se marca el parámetro Optimizar el rendimiento para servicios de entidades y se especifica el valor del parámetro Campos coincidentes para actualizar, se contarán todas las operaciones de actualización e inserción.	Long
Recuento de filas actualizado	El número de filas actualizadas en el dataset de destino. No se proporcionará un recuento de filas actualizado de los datasets del servicio de entidades de destino cuando se marque el parámetro Optimizar el rendimiento para los servicios de entidades.	Long

Entornos

Extensión, Espacio de trabajo actual, Conservar Id. globales, Mantener adjuntos, Transformaciones geográficas

Casos especiales

Conservar Id. globales

For the Append tool, this environment will only preserve Global ID values from the input dataset if the target Global ID field has a unique index. If the target Global ID field does not have a unique index, the tool may fail. To add a unique index to a Global ID field, use the Add Attribute Index tool.

If the target dataset contains a Global ID field and the input data does not, running the Append tool with this environment set to True will automatically generate new Global ID values for inserted rows.

This environment is ignored for target feature services. To preserve Global IDs for feature services that support optimization, check the Optimize performance for feature services parameter and specify GlobalID as the match fields in the Matching Fields for Update parameter.

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Avanzado: Sí

Temas relacionados

• Descripción general del conjunto de herramientas General
• Buscar una herramienta de geoprocesamiento
• Asignación de campos de atributo
• Fusionar
• Union
• Asignar campos de entrada a campos de salida