Incorporar (Administración de datos)

Resumen

Adjunta múltiples datasets de entrada en un dataset de destino existente. Los datasets de entrada pueden ser clases de entidad de punto, de línea o poligonal, tablas, rásteres, catálogos de ráster, clases de entidad de anotación o clases de entidad de dimensión.

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

Ilustración

Append illustration

Uso

Sintaxis

Append_management (inputs, target, {schema_type}, {field_mapping}, {subtype})
ParámetroExplicaciónTipo de datos
inputs
[inputs,...]

Datasets de entrada cuyos datos se adjuntarán al dataset de destino. Los datasets de entrada pueden ser clases de entidad de punto, de línea o poligonal, tablas, rásteres, catálogos de ráster, clases de entidad de anotación o clases de entidad de dimensión. Cada dataset de entrada debe concordar con el tipo de datos del dataset de destino.

Table View; Raster Layer
target

Dataset existente en el que se adjuntarán los datos de los datasets de entrada. Cada dataset de entrada debe concordar con el tipo de datos del dataset de destino.

Table View; Raster Layer
schema_type
(Opcional)

Especifica si el esquema (definiciones de campo) de los datasets de entrada debe coincidir con el esquema del dataset de destino para que se adjunten los datos.

  • PRUEBAEl esquema del dataset de entrada (definiciones de campo) debe coincidir con el esquema del dataset de destino. Se devolverá un error si los esquemas no coinciden.
  • NO_TESTEl esquema del dataset de entrada (definiciones de campo) no debe coincidir con el esquema 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 control Mapa de campo.
String
field_mapping
(Opcional)

Controla la forma en que se transfiere la información de atributo en los campos de los datasets de entrada al dataset de destino. Este parámetro sólo se puede utilizar si está especificado el Tipo de esquema NO_TEST.

Dado que los datos de los datasets de entrada se escriben en un dataset de destino existente que tiene un esquema predefinido (definiciones de campo), los campos no se pueden agregar o quitar del dataset de destino.

Las reglas de fusión le permiten especificar cómo los valores de dos o más campos de entrada se fusionan en un único valor de salida. Existen varias reglas de fusión que puede utilizar:

  • Primero: utilizar los primeros valores del campo de entrada para rellenar el campo de salida.
  • Último: utilizar los últimos valores del campo de entrada para rellenar el campo de salida.
  • Unir: concatenar (unir) todos los valores de los campos de entrada para rellenar el campo de salida.
  • Sumar: calcular el total de todos los valores de los campos de entrada.
  • Valor medio: calcular el valor medio (promedio) de todos los valores de los campos de entrada.
  • Mediana: calcular el valor de la mediana (centro).
  • Modo: utilizar el valor con la mayor frecuencia.
  • Mín.: usar el valor mínimo de todos los valores de los campos de entrada.
  • Máx.: usar el valor máximo de todos los valores de los campos de entrada.
  • Desviación estándar: utilizar el método de clasificación de la desviación estándar en todos los valores de campos de entrada.
  • Conteo: buscar la cantidad de registros incluidos en los cálculos.

Field Mapping
subtype
(Opcional)

Una descripción de subtipo para asignar ese subtipo a todos los datos nuevos adjuntados en el dataset de destino.

String

Ejemplo de código

Ejemplo 1 de Incorporar (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta Adjuntar en el modo inmediato.

import arcpy arcpy.env.workspace = "C:/data/" arcpy.Append_management(["north.shp", "south.shp", "east.shp", "west.shp"], "wholecity.shp", "TEST","","")
Ejemplo 2 de Incorporar (secuencia de comandos de Python independiente)

La siguiente secuencia de comandos muestra cómo utilizar la herramienta Adjuntar.

# Name: Append.py # Description: Use the Append tool to combine several shapefiles   # import system modules  import arcpy, os from arcpy import env  # Set environment settings env.workspace = "C:/data"  # Set local variables outLocation = "C:/Output" emptyFC = "MA_towns.shp" schemaType = "NO_TEST" fieldMappings = "" subtype = ""  try:     # Process:  Create a new empty feature class to append shapefiles into     arcpy.CreateFeatureclass_management(outLocation, emptyFC, "POLYGON", "amherst.shp")      # All polygon FCs in the workspace are MA town shapefiles, we want to append these to the empty FC     fcList = arcpy.ListFeatureClasses("","POLYGON")     # list will resemble ["amherst.shp", "hadley.shp", "pelham.shp", "coldspring.shp"]       # Process: Append the feature classes into the empty feature class     arcpy.Append_management(fcList, outLocation + os.sep + emptyFC, schemaType, fieldMappings, subtype)  except:     # If an error occurred while running a tool print the messages     print arcpy.GetMessages()

Entornos

Temas relacionados

9/11/2013