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

EtiquetaExplicaciónTipo 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.

String

arcpy.management.Rename(in_data, out_data, data_type)
NombreExplicaciónTipo 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.

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)