Agregar campos (varios) (Administración de datos)

Resumen

Agrega campos nuevos a una tabla, clase de entidad o ráster.

Uso

    Precaución:

    Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

  • En los shapefiles y las tablas dBase, si el tipo de campo define un carácter, se insertan espacios en blanco para cada registro. Si el tipo de campo define un elemento numérico, se insertan ceros para cada registro.

  • Los campos especificados por el parámetro Propiedades de campo tendrán las siguientes propiedades predeterminadas:

    • La propiedad Permitir NULL será verdadera.
    • La propiedad Editable será verdadera.
    • La propiedad Necesario será falsa.
    • Las propiedades Precisión y Escala se definen según los valores predeterminados de tipo de campo y origen de datos.

  • Los campos se pueden agregar a la entrada mediante el parámetro Propiedades de campo o Tablas de plantillas. Si se especifican ambos parámetros, se agregarán campos de ambos parámetros.

  • La opción Longitud de campo del parámetro Propiedades de campo solo es aplicable a campos de tipo texto.

  • Los shapefiles no son compatibles con alias para campos, de manera que no puede agregar un alias de campo a un shapefile.

  • Un campo de tipo ráster permite incluir una imagen ráster como atributo. Se almacena en la geodatabase o junto con ella. Esto es útil cuando una imagen es la mejor manera de describir una entidad. La precisión, la escala y la longitud no se pueden configurar para los campos de tipo ráster.

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla de entrada

La tabla de entrada donde se agregarán los campos. Los campos se agregarán a la tabla de entrada existente y no crearán una tabla de salida nueva.

Los campos se pueden agregar a clases de entidad de geodatabases, shapefiles, coberturas, tablas independientes, catálogos de ráster, rásteres con tablas de atributos y a capas.

Table View; Raster Layer; Mosaic Layer
Propiedades del campo
(Opcional)

Los campos y propiedades que se agregarán a la tabla de entrada.

  • Field Name: el nombre del campo que se agregará a la tabla de entrada.
  • Field Type: el tipo del campo nuevo.
  • Field Alias: el nombre alternativo dado al nombre de campo. Se utiliza para dar nombres más descriptivos a los nombres de campos crípticos. Este valor solo se aplica a geodatabases.
  • Field Length: la longitud del campo que se está agregando. Esto establece el número máximo de caracteres permitidos para cada registro del campo. Esta opción solo es aplicable en campos de tipo texto; la longitud predeterminada es de 255.
  • Default Value: el valor predeterminado del campo.
  • Field Domain: el dominio de la geodatabase que se asignará al campo.

Están disponibles los siguientes tipos de campos:

  • Texto: el tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • Flotante (punto flotante de 32 bits): el tipo de campo será flotante. Los campos flotantes admiten números fraccionarios entre -3,4E38 y 1,2E38.
  • Doble (punto flotante de 64 bits): el tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2,2E308 y 1,8E308.
  • Corto (entero de 16 bits): el tipo de campo será corto. Los campos cortos admiten números enteros entre -32.768 y 32.767.
  • Largo (entero de 32 bits): el tipo de campo será largo. Los campos nuevos admiten número enteros entre -2.147.483.648 y 2.147.483.647.
  • Fecha: el tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • Blob (datos binarios): el tipo de campo será BLOB. Los campos BLOB admiten datos almacenados como una secuencia larga de números binarios. Necesita un cargador o un visor personalizado, o una aplicación de terceros, para cargar elementos en un campo BLOB o para visualizar el contenido de un campo BLOB.
  • Imágenes ráster: el tipo de campo será ráster. Los campos ráster pueden almacenar datos ráster dentro o junto con la geodatabase. Aunque se pueden almacenar todos los formatos de dataset ráster admitidos por el software de ArcGIS, se recomienda utilizar solamente imágenes pequeñas.
  • GUID (identificador único a nivel mundial): el tipo de campo será GUID. Los campos GUID almacenan cadenas de texto de estilo de registro que están compuestas por 36 caracteres encerrados entre paréntesis.
Value Table
Tablas de plantillas
(Opcional)

Las clases de entidad o las tablas que se utilizarán como plantilla para definir los campos de atributos que se agregarán.

Los campos de las entradas especificadas con este parámetro se agregarán al valor de la Tabla de entrada además de cualquier campo especificado por el parámetro Propiedades de campo.

Table View

Salida derivada

EtiquetaExplicaciónTipo de datos
Tabla de entrada actualizada

Las tablas de entrada actualizadas.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AddFields(in_table, {field_description}, {template})
NombreExplicaciónTipo de datos
in_table

La tabla de entrada donde se agregarán los campos. Los campos se agregarán a la tabla de entrada existente y no crearán una tabla de salida nueva.

Los campos se pueden agregar a clases de entidad de geodatabases, shapefiles, coberturas, tablas independientes, catálogos de ráster, rásteres con tablas de atributos y a capas.

Table View; Raster Layer; Mosaic Layer
field_description
[[Field Name, Field Type, {Field Alias}, {Field Length}, {Default Value} {Field Domain}],...]
(Opcional)

Los campos y propiedades que se agregarán a la tabla de entrada.

  • Field Name: el nombre del campo que se agregará a la tabla de entrada.
  • Field Type: el tipo del campo nuevo.
  • Field Alias: el nombre alternativo dado al nombre de campo. Se utiliza para dar nombres más descriptivos a los nombres de campos crípticos. Este valor solo se aplica a geodatabases.
  • Field Length: la longitud del campo que se está agregando. Esto establece el número máximo de caracteres permitidos para cada registro del campo. Esta opción solo es aplicable en campos de tipo texto; la longitud predeterminada es de 255.
  • Default Value: el valor predeterminado del campo.
  • Field Domain: el dominio de la geodatabase que se asignará al campo.

Están disponibles los siguientes tipos de campos:

  • TEXT: el tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • FLOAT: el tipo de campo será flotante. Los campos flotantes admiten números fraccionarios entre -3,4E38 y 1,2E38.
  • DOUBLE: el tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2,2E308 y 1,8E308.
  • SHORT: el tipo de campo será corto. Los campos cortos admiten números enteros entre -32.768 y 32.767.
  • LONG: el tipo de campo será largo. Los campos nuevos admiten número enteros entre -2.147.483.648 y 2.147.483.647.
  • DATE: el tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • BLOB: el tipo de campo será BLOB. Los campos BLOB admiten datos almacenados como una secuencia larga de números binarios. Necesita un cargador o un visor personalizado, o una aplicación de terceros, para cargar elementos en un campo BLOB o para visualizar el contenido de un campo BLOB.
  • RASTER: el tipo de campo será ráster. Los campos ráster pueden almacenar datos ráster dentro o junto con la geodatabase. Aunque se pueden almacenar todos los formatos de dataset ráster admitidos por el software de ArcGIS, se recomienda utilizar solamente imágenes pequeñas.
  • GUID: el tipo de campo será GUID. Los campos GUID almacenan cadenas de texto de estilo de registro que están compuestas por 36 caracteres encerrados entre paréntesis.

En el parámetro field_description con parámetros opcionales, utilice None como un marcador de posición vacío.

Value Table
template
[template,...]
(Opcional)

Las clases de entidad o las tablas que se utilizarán como plantilla para definir los campos de atributos que se agregarán.

Los campos de las entradas especificadas con este parámetro se agregarán al valor de la in_table además de cualquier campo especificado por el parámetro field_description.

Table View

Salida derivada

NombreExplicaciónTipo de datos
out_table

Las tablas de entrada actualizadas.

Table View; Raster Layer; Mosaic Layer

Muestra de código

Ejemplo de AddFields (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función AddFields de modo inmediato.


import arcpy
arcpy.env.workspace = "C:/data/district.gdb"
arcpy.management.AddFields(
    'school', 
    [['school_name', 'TEXT', 'Name', 255, 'Hello world', ''], 
     ['street_number', 'LONG', 'Street Number', None, 35, 'StreetNumDomain'],
     ['year_start', 'DATE', 'Year Start', None, '2017-08-09 16:05:07', '']])

Información de licenciamiento

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

Temas relacionados