Campos de actualización por lotes (Administración de datos)

Resumen

Transforma los campos de una tabla o clase de entidad basándose en el esquema definido en la tabla de definición y crea una tabla o clase de entidad nueva.

Si utiliza esta herramienta, podrá realizar lo siguiente:

• Agregar nuevos campos.
• Actualizar campos existentes.
• Reordenar campos.
• Cambiar tipos de campo.
• Cambiar propiedades de archivo.
• Asignar o actualizar alias de campo.
• Calcular valores de campo en función de campos existentes mediante Python.
• Quitar campos.

Uso

• La tabla de entrada puede ser una tabla o clase de entidad. La herramienta genera una nueva tabla o clase de entidad con el esquema actualizado.

• Los cambios de esquema para la tabla de salida se definen mediante el parámetro Tabla de definición de esquema de salida.

  A continuación, se muestra un ejemplo de una tabla de definición:

  

  Si el valor del parámetro Tabla de definición del esquema de salida incluye los siguientes nombres de campo, como en el ejemplo anterior, los valores de los parámetros correspondientes se rellenarán automáticamente:

  • Target field
  • Source field
  • Type
  • Decimals/Length
  • Alias
  • Script

  Nota:

  Script o Source field debe rellenarse.

• La herramienta calcula nuevos campos usando campos existentes proporcionando un campo de script en la tabla de definición.

  Un valor de ejemplo en el campo Script de la tabla de definición es !TOTPOP!/!AREA!, que calcula el campo Population Density. Los nombres de campo deben estar entre signos de exclamación.

• La herramienta puede crear campos adicionales que dependen de otros cálculos de campo. Por ejemplo, el campo Bev_Index se calcula con el campo Bev_Per_Capita, que también se calcula al ejecutar la herramienta.

• Utilice el parámetro Archivo de script para varios cálculos de Python de línea. Para usar un archivo de script, cree un archivo con las funciones de Python y haga referencia a las funciones en la tabla de definición.

  A continuación, se muestra un ejemplo de código de script para un campo de destino llamado Bev_Per_Capita:

  • Un campo llamado Script en el valor del parámetro Tabla de definición de esquema de salida con el valor e Bev_Per_Capita(!Bev_Total!, !TOTPOP!)
  • Un valor del parámetro Archivo de script con la siguiente función:
    
    def Bev_Per_Capita(Bev_Total, TOTPOP):
        return Bev_Total / TOTPOP

  A continuación, se encuentra un ejemplo en el que se muestra la tabla de atributos antes y después de ejecutar la herramienta:

  

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	Tabla o clase de entidad de entrada.	Table View
Tabla de Salida	La tabla o clase de entidad de salida que contiene los campos actualizados.	Table
Tabla de definición de esquema de salida	Una tabla que contiene las definiciones de campo y los cálculos que se utilizarán para crear la salida.	Table View
Archivo de script (Opcional)	Un archivo Python que almacena varias funciones de Python de línea para realizar cálculos para los campos del parámetro Tabla de salida.	File
Nombre de campo de salida (Opcional)	El nombre de campo de la tabla de definición que contiene los nombres de campo de destino para la tabla de salida.	Field
Nombre de campo de origen (Opcional)	El nombre de campo de la tabla de definición que contiene los nombres de campo de origen de la tabla de entrada.	Field
Tipo de campo de salida (Opcional)	Campo del valor del parámetro Tabla de definición del esquema de salida que define los tipos de datos para la tabla de salida. Se espera que el campo sea de tipo texto. Campo de la field_definition_table que define los tipos de dato para la tabla de salida. Se espera que el campo sea de tipo texto. Se admiten los siguientes valores: BigInteger: entero de 64 bits Blob: objeto binario grande Date: fecha DateOnly: solo fecha Double: número de punto flotante de doble precisión GlobalID: Id. global GUID: identificador único global Integer (o Long): entero de 32 bits Raster: ráster Float (o Single): número de punto flotante de precisión simple Short (o SmallInteger): entero de 16 bits Text (o String): cadena de caracteres TimeOnly: solo hora TimestampOffset: desfase de marca de tiempo	Field
Longitud o decimales del campo de salida (Opcional)	El nombre de campo de la tabla de definición que define el número de decimales o la longitud del campo para los campos de salida.	Field
Alias de campo de salida (Opcional)	El nombre de campo de la tabla de definición que define los nombres de alias para los campos de la tabla de salida.	Field
Script de campo de salida (Opcional)	El nombre de campo de la tabla de definición que define los cálculos para los campos de salida.	Field

Python

arcpy.management.BatchUpdateFields(in_table, out_table, field_definition_table, {script_file}, {output_field_name}, {source_field_name}, {output_field_type}, {output_field_decimals_or_length}, {output_field_alias}, {output_field_script})

Nombre	Explicación	Tipo de datos
in_table	Tabla o clase de entidad de entrada.	Table View
out_table	La tabla o clase de entidad de salida que contiene los campos actualizados.	Table
field_definition_table	Una tabla que contiene las definiciones de campo y los cálculos que se utilizarán para crear la salida.	Table View
script_file (Opcional)	Un archivo Python que almacena varias funciones de Python de línea para realizar cálculos para los campos del parámetro out_table.	File
output_field_name (Opcional)	El nombre de campo de la tabla de definición que contiene los nombres de campo de destino para la tabla de salida.	Field
source_field_name (Opcional)	El nombre de campo de la tabla de definición que contiene los nombres de campo de origen de la tabla de entrada.	Field
output_field_type (Opcional)	Campo del valor del parámetro Tabla de definición del esquema de salida que define los tipos de datos para la tabla de salida. Se espera que el campo sea de tipo texto. Campo de la field_definition_table que define los tipos de dato para la tabla de salida. Se espera que el campo sea de tipo texto. Se admiten los siguientes valores: BigInteger: entero de 64 bits Blob: objeto binario grande Date: fecha DateOnly: solo fecha Double: número de punto flotante de doble precisión GlobalID: Id. global GUID: identificador único global Integer (o Long): entero de 32 bits Raster: ráster Float (o Single): número de punto flotante de precisión simple Short (o SmallInteger): entero de 16 bits Text (o String): cadena de caracteres TimeOnly: solo hora TimestampOffset: desfase de marca de tiempo	Field
output_field_decimals_or_length (Opcional)	El nombre de campo de la tabla de definición que define el número de decimales o la longitud del campo para los campos de salida.	Field
output_field_alias (Opcional)	El nombre de campo de la tabla de definición que define los nombres de alias para los campos de la tabla de salida.	Field
output_field_script (Opcional)	El nombre de campo de la tabla de definición que define los cálculos para los campos de salida.	Field

Muestra de código

Ejemplo de BatchUpdateFields (script independiente)

El siguiente script de la ventana de Pythonindependiente muestra cómo utilizar la función BatchUpdateFields en un script independiente.

import arcpy
arcpy.management.BatchUpdateFields(
    "zip_codes", "MyProject.gdb\zip_codes_BatchUpdateFields",
    "DATA_TRANSFORMATION.csv", r"C:\BatchUpdate\script.py", "TARGET",
    "SOURCE", "DATATYPE", "DECIMALS", "ALIAS", "SCRIPT")

Entornos

Espacio de trabajo actual

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí