Modificar campo (Administración de datos)

Resumen

Renombra campos y alias de campos o modifica las propiedades del campo.

Uso

• Esta herramienta permite cambiar el nombre de campos o alias de campos de cualquier tabla o clase de entidad de geodatabase.

• Cuando se utilizan las clases de entidad o tablas en memoria, al cambiar el nombre de ObjectID, Shape u otros campos obligatorios, como los que se encuentran en las capas de análisis de red, puede que se dañen los datos o se produzca un comportamiento inesperado.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	La clase de entidad o tabla de geodatabase de entrada que contiene el campo que se desea modificar.	Table View; Raster Layer; Mosaic Layer
Nombre de campo	Nombre del campo que se desea modificar. Si el campo es un campo obligatorio (isRequired=true), solo es posible modificar el alias del campo.	Field
Nuevo nombre de campo (Opcional)	Nombre nuevo del campo.	String
Nuevo alias de campo (Opcional)	El nuevo alias de campo para el campo.	String
Nuevo tipo de campo (Opcional)	Especifica el nuevo tipo de campo para el campo. Esta propiedad solo puede aplicarse si la tabla de entrada está vacía (no contiene registros). Texto—Cualquier cadena de caracteres. Flotante (precisión simple)— Números fraccionarios entre -3,4E38 y 1,2E38. Doble (precisión doble)— Números fraccionarios entre -2,2E308 y 1,8E308. Corto (entero pequeño)— Números enteros entre -32.768 y 32.767. Largo (entero grande)— Números enteros entre -2.147.483.648 y 2.147.483.647. Fecha—Fecha y/u hora. Blob (datos binarios)—Secuencia larga de números binarios. Necesita un cargador o un visualizador 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—Imágenes ráster. Todos los formatos de dataset ráster admitidos por el software de ArcGIS se pueden almacenar, pero es muy recomendable que se utilicen únicamente imágenes pequeñas. GUID (identificador único a nivel mundial)—Identificador único a nivel mundial.	String
Nueva longitud de campo (Opcional)	La nueva longitud del campo. Esto establece el número máximo de caracteres permitidos para cada registro del campo. Esta opción solo es aplicable a campos de tipo Texto o BLOB (datos binarios). Si la tabla está vacía, es posible aumentar o disminuir la longitud del campo. Si la tabla no está vacía, la longitud tan solo se puede aumentar respecto del valor actual.	Long
Nuevo campo anulable (Opcional)	Especifica si el campo puede contener valores nulos. Los valores nulos solo son compatibles con los campos de una geodatabase. Esta opción solo puede aplicarse si la tabla está vacía (no contiene registros). Activado: el campo permitirá valores nulos. Esta es la opción predeterminada. Desactivado: el campo no permitirá valores nulos.	Boolean
Borrar alias (Opcional)	Especifica si se borrará el alias del campo de entrada. El parámetro del alias del campo debe estar vacío para borrar el alias del campo. Activado: el alias del campo se borrará (se establecerá como nulo). El parámetro del alias del campo debe estar vacío. Desactivado: el alias del campo no se borrará. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Tabla de entrada actualizada	La tabla de entrada actualizada.	Table View; Raster Layer; Mosaic Layer

Python

arcpy.management.AlterField(in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})

Nombre	Explicación	Tipo de datos
in_table	La clase de entidad o tabla de geodatabase de entrada que contiene el campo que se desea modificar.	Table View; Raster Layer; Mosaic Layer
field	Nombre del campo que se desea modificar. Si el campo es un campo obligatorio (isRequired=true), solo es posible modificar el alias del campo.	Field
new_field_name (Opcional)	Nombre nuevo del campo.	String
new_field_alias (Opcional)	El nuevo alias de campo para el campo.	String
field_type (Opcional)	Especifica el nuevo tipo de campo para el campo. Esta propiedad solo puede aplicarse si la tabla de entrada está vacía (no contiene registros). TEXT—Cualquier cadena de caracteres. FLOAT— Números fraccionarios entre -3,4E38 y 1,2E38. DOUBLE— Números fraccionarios entre -2,2E308 y 1,8E308. SHORT— Números enteros entre -32.768 y 32.767. LONG— Números enteros entre -2.147.483.648 y 2.147.483.647. DATE—Fecha y/u hora. BLOB—Secuencia larga de números binarios. Necesita un cargador o un visualizador personalizado, o una aplicación de terceros, para cargar elementos en un campo BLOB o para visualizar el contenido de un campo BLOB. RASTER—Imágenes ráster. Todos los formatos de dataset ráster admitidos por el software de ArcGIS se pueden almacenar, pero es muy recomendable que se utilicen únicamente imágenes pequeñas. GUID—Identificador único a nivel mundial.	String
field_length (Opcional)	La nueva longitud del campo. Esto establece el número máximo de caracteres permitidos para cada registro del campo. Esta opción solo puede aplicarse a campos de tipo TEXT o BLOB. Si la tabla está vacía, es posible aumentar o disminuir la longitud del campo. Si la tabla no está vacía, la longitud tan solo se puede aumentar respecto del valor actual.	Long
field_is_nullable (Opcional)	Especifica si el campo puede contener valores nulos. Los valores nulos solo son compatibles con los campos de una geodatabase. Esta opción solo puede aplicarse si la tabla de entrada está vacía (no contiene registros). NON_NULLABLE—El campo no permitirá valores nulos. NULLABLE—El campo permitirá valores nulos. Esta es la opción predeterminada.	Boolean
clear_field_alias (Opcional)	Especifica si se borrará el alias del campo de entrada. El parámetro del alias del campo debe estar vacío para borrar el alias del campo. CLEAR_ALIAS—El alias del campo se borrará (se establecerá como nulo). DO_NOT_CLEAR—El alias del campo no se borrará. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_table	La tabla de entrada actualizada.	Table View; Raster Layer; Mosaic Layer

Muestra de código

Ejemplo 1 de AlterField (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta AlterField en el modo inmediato.

arcpy.AlterField_management(r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')

Ejemplo 2 de AlterField (script independiente)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta AlterField en un script independiente.

#Import geoprocessing
import arcpy

#Set workspace
arcpy.env.workspace = r'C:\Data\Garbo.gdb'

#Loop through feature classes looking for a field named 'elev'
fcList = arcpy.ListFeatureClasses() #get a list of feature classes
for fc in fcList:  #loop through feature classes
    fieldList = arcpy.ListFields(fc)  #get a list of fields for each feature class
    for field in fieldList: #loop through each field
        if field.name.lower() == 'elev':  #look for the name elev
            arcpy.AlterField_management(fc, field.name, 'ELEVATION', 'Elevation in Metres')

Ejemplo 3 de AlterField (script independiente)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta AlterField en una clase de entidad vacía de un script independiente.

#Import geoprocessing
import arcpy

#Set local variables
fc = "C:/Data/Garbo.gdb/trails" #Note:empty feature class
field = "condition_rating" #short int, non nullable field
new_name = "notes"
new_alias = "Comments on Trail Condition"
new_type = "TEXT"
new_length = "60"
new_is_nullable = "NULLABLE"
clear_alias = "FALSE"

#Alter the properties of a non nullable, short data type field to become a text field
arcpy.AlterField_management(fc, field, new_name, new_alias, new_type, new_length, new_is_nullable, clear_alias)

Entornos

Espacio de trabajo actual

Casos especiales

Información de licenciamiento

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