Resumen
Agrega campos nuevos a una tabla, clase de entidad o ráster.
Uso
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.
La herramienta Agregar campos tiene las siguientes propiedades de campos predeterminadas:
- La propiedad Permitir NULL de los campos agregados será verdadera.
- La propiedad Editable de los campos agregados será verdadera.
- La propiedad Necesario de los campos agregados será falsa.
- La precisión y la escala se definen según los valores predeterminados de tipo de campo y origen de datos.
La longitud 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.
Sintaxis
arcpy.management.AddFields(in_table, field_description)
Parámetro | Explicación | Tipo 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}],...] | Los campos y propiedades que se agregarán a la tabla de entrada.
Están disponibles los siguientes tipos de campos:
En el parámetro field_description con parámetros opcionales, utilice None como un marcador de posición vacío. | Value Table |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_table | Las tablas de entrada actualizadas. | Vista de tabla; Capa ráster; Capa de mosaico |
Muestra de código
El script de la ventana de Python muestra cómo utilizar la herramienta AddFields en el 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', '']])
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí