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 solo es necesario en caso de conflicto de nombres entre dos tipos de datos diferentes. Por ejemplo, una geodatabase puede contener una clase de relación que tiene un nombre idéntico al de una clase de entidad. Si este es el caso, especifique la palabra clave correspondiente.

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 solo es necesario en caso de conflicto de nombres entre dos tipos de datos diferentes. Por ejemplo, una geodatabase puede contener una clase de relación que tiene un nombre idéntico al de una clase de entidad. Si este es el caso, especifique la palabra clave correspondiente.

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)

Información de licenciamiento

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

Temas relacionados