Cambiar nombre (Administración de datos)

Resumen

Cambia el nombre de un dataset. Esto incluye una gran variedad de tipos de datos, entre ellos el dataset de entidades, ráster, tabla y shapefile.

Uso

• El nombre de salida debe ser único. Si no es así, se emite un mensaje de error, incluso si el entorno de salida de sobrescritura de geoprocesamiento está establecido en verdadero.

• Esta herramienta no renombra las capas, ya que una capa es una referencia a un dataset.

• Cambiar nombre no cambia el nombre de los campos en el dataset. Por ejemplo, suponga que tiene un campo denominado ROADS_ID en una clase de entidad llamada Roads. Al cambiar el nombre de la clase de entidad Roads a Streets, no se cambia el nombre del campo ROADS_ID a STREETS_ID.

• Esta herramienta no funciona con datos almacenados en una base de datos DB2 debido a las restricciones de la base de datos.

Sintaxis

arcpy.management.Rename(in_data, out_data, {data_type})

Parámetro	Explicación	Tipo de datos
in_data	Los datos de entrada que se renombrarán.	Data Element
out_data	El nombre de los datos de salida.	Data Element
data_type (Opcional)	El tipo de datos que cambiarán de nombre. La única vez que deberá proporcionar un valor es cuando una geodatabase contiene un dataset de entidad y una clase de entidad con el mismo nombre. En este caso, debe seleccionar el tipo de datos (dataset de entidad o clase de entidad) del elemento al que desea cambiar el nombre.	String

Muestra de código

Ejemplo 1 Cambiar nombre (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función Cambiar nombre en el modo inmediato.

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.Rename_management("customers.dbf", "customers_2010.dbf")

Ejemplo 2 de Cambiar nombre (secuencia de comandos de Python independiente)

La siguiente secuencia de comandos de Python demuestra cómo utilizar la función Cambiar nombre en una secuencia de comandos independiente.

# Name: Rename_Example2.py
# Description: Rename fileGDB feature class

# Import system modules
import arcpy
from arcpy import env

# Set workspace
env.workspace = "C:/workspace/test.gdb"

# Set local variables
in_data =  "test"
out_data = "testFC"
data_type = "FeatureClass"

# Execute Rename
arcpy.Rename_management(in_data, out_data, data_type)

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal

Información de licenciamiento

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