Cambiar nombre (Administración de datos)

Resumen

Cambia el nombre de un dataset. Incluye varios tipos de datos, incluidos dataset de entidades, ráster, tabla y shapefile.

Uso

• El nombre de la salida debe ser único. Si no es así, llega un mensaje de error, incluso si la configuración de geoprocesamiento Permitir que las herramientas de geoprocesamiento sobrescriban los datasets existentes está habilitada.

• La herramienta también cambia el nombre de alias de los datos.

• La herramienta no cambia el nombre de las capas, ya que una capa es una referencia a un dataset.

• La herramienta no cambia el nombre de los campos en el dataset. Por ejemplo, si tiene un campo denominado ROADS_ID en una clase de entidad llamada Roads, cambiar el nombre de la clase de entidad Roads a Streets no cambia el nombre del campo ROADS_ID a STREETS_ID.

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

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Elemento de datos de entrada	Los datos de entrada que se van a renombrar.	Data Element
Elemento de datos de salida	El nombre de los datos de salida.	Data Element
Tipo de datos	El tipo de datos que cambiarán de nombre. Este parámetro se utilizará en caso de un conflicto de nombres. Una geodatabase puede contener diferentes datasets con el mismo nombre, por ejemplo, una clase de entidad, un dataset de entidad, un dataset de mosaico y una estructura de parcela con el mismo nombre pueden existir en la misma geodatabase. Especificar un valor indicará a la herramienta que use ese tipo de datos en caso de que haya dos o más conjuntos de datos con el mismo nombre. FeatureClass: en caso de nombres duplicados, se utilizará la clase de entidad. FeatureDataset: en caso de nombres duplicados, se utilizará el dataset de entidades. MosaicDataset: en caso de nombres duplicados, se utilizará el dataset de mosaico. ParcelFabric: en el caso de nombres duplicados, se utilizará la estructura de parcela.	String

Python

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

Nombre	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	El tipo de datos que cambiarán de nombre. Este parámetro se utilizará en caso de un conflicto de nombres. Una geodatabase puede contener diferentes datasets con el mismo nombre, por ejemplo, una clase de entidad, un dataset de entidad, un dataset de mosaico y una estructura de parcela con el mismo nombre pueden existir en la misma geodatabase. Especificar un valor indicará a la herramienta que use ese tipo de datos en caso de que haya dos o más conjuntos de datos con el mismo nombre. FeatureClass: en caso de nombres duplicados, se utilizará la clase de entidad. FeatureDataset: en caso de nombres duplicados, se utilizará el dataset de entidades. MosaicDataset: en caso de nombres duplicados, se utilizará el dataset de mosaico. ParcelFabric: en el caso de nombres duplicados, se utilizará la estructura de parcela.	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.management.Rename("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.

# Description: Rename a file geodatabase 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"

# Run Rename
arcpy.management.Rename(in_data, out_data, data_type)

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal