Resumen
Cambia el nombre de un dataset. Incluye una amplia variedad de tipos de datos, entre ellos dataset de entidades, raster, tabla y shapefile.
Uso
El nombre de la salida debe ser único. Si no lo es, se informa con un mensaje de error, incluso si el entorno de salida de sobreescritura de geoprocesamiento está configurado como true.
Esta herramienta no cambia el nombre de capas, ya que una capa es una referencia a un dataset.
La herramienta Cambiar nombre no cambia el nombre de los campos del dataset. Por ejemplo, si tiene un campo llamado ROADS_ID en una clase de entidad llamada Roads, cambiar el nombre de la clase de entidad de Roads a Streets no cambia el nombre del campo ROADS_ID a STREETS_ID.
Al cambiar el nombre de una cobertura también se cambia el nombre de todas las subclases de regiones y rutas dentro de una cobertura.
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 van a renombrar. | 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 de Cambiar nombre (ventana de Python)
El siguiente script de la ventana de Python demuestra cómo utilizar la función Rename de modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Rename_management("customers.dbf", "customers_2010.dbf")
Ejemplo 2 de Cambiar nombre (script independiente)
El siguiente script de Python demuestra cómo utilizar la función Rename en un script independiente.
# Name: Rename_Example2.py
# Description: Rename fileGDB feature class
# Import system modules
import arcpy
# Set workspace
arcpy.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
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí