Modificar campo (Administración de datos)

Resumen

Cambia el nombre de campos y alias de campo o modifica las propiedades de los campos.

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.

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

  • Puede utilizar esta herramienta para modificar el alias de campo de una campo de una tabla o vista que se ha registrado en la base de datos.

  • Si el campo de entrada es un campo obligatorio, solo es posible modificar el alias del campo.

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla de entrada

Clase de entidad o tabla de geodatabase de entrada que contiene el campo que se modificará.

Table View; Raster Layer; Mosaic Layer
Nombre de campo

Nombre del campo que se modificará. Si el campo es un campo obligatorio, solo se 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. Este parámetro solo puede aplicarse si la tabla de entrada está vacía (no contiene registros).

  • 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 largos admiten números 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.
  • TextoEl tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • FechaEl tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • Solo fechaEl tipo de campo será solo fecha. Los campos de solo fecha admiten valores de fecha sin valores de hora.
  • Solo horaEl tipo de campo será solo hora. Los campos de solo hora admiten valores de hora sin valor de fecha.
  • Desfase de marca de tiempoEl tipo de campo será desfase de marca de tiempo. Los campos de desplazamiento de fecha y hora admiten un valor de fecha, hora y desplazamiento con respecto a 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.
  • RásterEl 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.
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. Este parámetro 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. Este parámetro solo puede aplicarse si la tabla está vacía (no contiene registros).

  • Activado: el campo puede contener valores nulos. Esta es la opción predeterminada.
  • Desactivado: el campo no puede contener valores nulos.
Boolean
Borrar alias
(Opcional)

Especifica si se borrará el alias del campo de entrada. El valor del parámetro Nuevo alias de 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

EtiquetaExplicaciónTipo de datos
Tabla de entrada actualizada

La tabla de entrada actualizada.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AlterField(in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})
NombreExplicaciónTipo de datos
in_table

Clase de entidad o tabla de geodatabase de entrada que contiene el campo que se modificará.

Table View; Raster Layer; Mosaic Layer
field

Nombre del campo que se modificará. Si el campo es un campo obligatorio, solo se 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. Este parámetro solo puede aplicarse si la tabla de entrada está vacía (no contiene registros).

  • SHORTEl tipo de campo será corto. Los campos cortos admiten números enteros entre -32.768 y 32.767.
  • LONGEl tipo de campo será largo. Los campos largos admiten números enteros entre -2.147.483.648 y 2.147.483.647.
  • BIGINTEGEREl tipo de campo será entero grande. Los campos de números enteros grandes admiten números enteros entre -(253) y 253.
  • FLOATEl tipo de campo será flotante. Los campos flotantes admiten números fraccionarios entre -3,4E38 y 1,2E38.
  • DOUBLEEl tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2,2E308 y 1,8E308.
  • TEXTEl tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • DATEEl tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • DATEONLYEl tipo de campo será solo fecha. Los campos de solo fecha admiten valores de fecha sin valores de hora.
  • TIMEONLYEl tipo de campo será solo hora. Los campos de solo hora admiten valores de hora sin valor de fecha.
  • TIMESTAMPOFFSETEl tipo de campo será desfase de marca de tiempo. Los campos de desplazamiento de fecha y hora admiten un valor de fecha, hora y desplazamiento con respecto a UTC.
  • BLOBEl 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.
  • GUIDEl 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.
  • RASTEREl 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.
String
field_length
(Opcional)

La nueva longitud del campo. Esto establece el número máximo de caracteres permitidos para cada registro del campo. Este parámetro solo se aplica 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. Este parámetro solo puede aplicarse si la tabla de entrada está vacía (no contiene registros).

  • NULLABLEEl campo puede contener valores nulos. Esta es la opción predeterminada.
  • NON_NULLABLEEl campo no puede contener valores nulos.
Boolean
clear_field_alias
(Opcional)

Especifica si se borrará el alias del campo de entrada. El parámetro new_field_alias debe estar vacío para borrar el alias del campo.

  • CLEAR_ALIASEl alias del campo se borrará (se establecerá como nulo).
  • DO_NOT_CLEAREl alias del campo no se borrará. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo 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)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función AlterField de modo inmediato.

import arcpy
arcpy.management.AlterField(
    r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')
Ejemplo 2 de AlterField (script independiente)

El siguiente script de la ventana de Pythonindependiente muestra cómo utilizar la función AlterField en un script independiente.

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:  # Lloop through each field
        if field.name.lower() == 'elev':  # Look for the name elev
            arcpy.management.AlterField(fc, field.name, 'ELEVATION', 'Elevation in Metres')
Ejemplo 3 de AlterField (script independiente)

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

import arcpy

# Set local variables
in_table = "C:/Data/Garbo.gdb/trails"  # Note: empty feature class
field = "condition_rating"  # short int, non nullable field
new_field_name = "notes"
new_field_alias = "Comments on Trail Condition"
field_type = "TEXT"
field_length = 60
field_is_nullable = "NULLABLE"
clear_field_alias = "FALSE"

# Alter the properties of a non nullable, short data type field to become a text field
arcpy.management.AlterField(in_table,
                            field,
                            new_field_name,
                            new_field_alias,
                            field_type,
                            field_length,
                            field_is_nullable,
                            clear_field_alias)