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.
Sintaxis
arcpy.management.AlterField(in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})| Parámetro | Explicación | Tipo de datos |
in_table | La clase de entidad o tabla de entrada que contiene el campo que se desea modificar. | Table View; Raster Layer; Raster Catalog 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).
| 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. Igualmente, solo es aplicable si la tabla está vacía. | 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).
| 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.
| 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
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí