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.
Cambiar el nombre de una cobertura también cambia el nombre de todas las subclases de región y ruta 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
Rename_management (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 los 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
Información sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí