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 proporcionan valores para 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.

  • Nombre de campo: el nombre del campo que se agregará a la tabla de entrada.
  • Tipo de campo: el tipo del campo nuevo.
  • Alias de campo: el nombre alternativo del campo. Se utiliza para describir los nombres de campo crípticos. Este valor solo se aplica a geodatabases.
  • Longitud de campo: 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 se aplica a los campos de tipo de texto. La longitud predeterminada es 255.
  • Valor predeterminado: el valor predeterminado del campo.
  • Dominio del campo: el dominio de la geodatabase que se asignará al campo.

Están disponibles los siguientes tipos de campos:

  • 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.
  • Entero grande (entero de 64 bits): el tipo de campo será entero grande. Los campos de números enteros grandes admiten números enteros entre -(253) y 253.
  • 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.
  • Texto: el tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • Fecha: el tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • Fecha (alta precisión): el tipo de campo será el de fecha de alta precisión. Los campos de fecha de alta precisión admiten valores de fecha y hora con tiempo en milisegundos.
  • Solo fecha: el tipo de campo será solo de fecha. Los campos de solo fecha admiten valores de fecha sin valores de hora.
  • Solo hora: el tipo de campo será solo de tiempo. Los campos de solo hora admiten valores de hora sin valor de fecha.
  • Desfase de marca de tiempo: el tipo de campo será de desfase de marca de tiempo. Los campos de desplazamiento de fecha y hora admiten un valor de fecha, hora y desplazamiento con respecto a un valor UTC.
  • 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.
  • 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.
  • 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.
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.

  • Nombre de campo: el nombre del campo que se agregará a la tabla de entrada.
  • Tipo de campo: el tipo del campo nuevo.
  • Alias de campo: el nombre alternativo del campo. Se utiliza para describir los nombres de campo crípticos. Este valor solo se aplica a geodatabases.
  • Longitud de campo: 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 se aplica a los campos de tipo de texto. La longitud predeterminada es 255.
  • Valor predeterminado: el valor predeterminado del campo.
  • Dominio del campo: el dominio de la geodatabase que se asignará al campo.

Están disponibles los siguientes tipos de campos:

  • 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.
  • BIGINTEGER: el tipo de campo será entero grande. Los campos de números enteros grandes admiten números enteros entre -(253) y 253.
  • 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.
  • TEXT: el tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • DATE: el tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • DATEHIGHPRECISION: el tipo de campo será el de fecha de alta precisión. Los campos de fecha de alta precisión admiten valores de fecha y hora con tiempo en milisegundos.
  • DATEONLY: el tipo de campo será solo de fecha. Los campos de solo fecha admiten valores de fecha sin valores de hora.
  • TIMEONLY: el tipo de campo será solo de tiempo. Los campos de solo hora admiten valores de hora sin valor de fecha.
  • TIMESTAMPOFFSET: el tipo de cambio será de desfase de marca de tiempo. Los campos de desplazamiento de fecha y hora admiten un valor de fecha, hora y desplazamiento con respecto a un valor UTC.
  • 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.
  • 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.
  • 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.

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)

La siguiente secuencia de comandos de la ventana de Python muestra 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', '']])

Temas relacionados