Umbenennen (Data Management)
Zusammenfassung
Ändert den Namen eines Datasets. Dies schließt eine Reihe von Datentypen ein, z. B. Feature-Datasets, Raster, Tabellen und Shapefiles.
Verwendung
-
Der Ausgabename muss eindeutig sein. Ist dies nicht der Fall, wird eine Fehlermeldung ausgegeben, auch wenn die Einstellung zum Überschreiben der Ausgabe der Geoverarbeitungs-Operation TRUE lautet.
-
Beim Umbenennen werden keine Felder im Dataset umbenannt. Angenommen, Sie verwenden ein Feld mit dem Namen ROADS_ID in einer Feature-Class mit dem Namen ROADS. Beim Umbenennen der Feature-Class ROADS in STREETS wird das Feld ROADS_ID nicht in STREETS_ID umbenannt.
Beim Umbenennen eines Coverage werden alle Region- und Routen-Subclasses innerhalb eines Coverage ebenfalls umbenannt.
Dieses Werkzeug kann aufgrund von Datenbankeinschränkungen nicht für Daten in einer DB2-Datenbank verwendet werden.
Syntax
| Parameter | Erläuterung | Datentyp |
in_data |
Die Eingabedaten, die umbenannt werden sollen. | Data Element |
out_data |
Der Name für die Ausgabedaten. | Data Element |
data_type (optional) |
Der Typ der umzubenennenden Daten. Sie müssen nur dann einen Wert angeben, wenn eine Geodatabase ein Feature-Dataset und eine Feature-Class mit dem gleichen Namen enthält. In diesem Fall müssen Sie den Datentyp (Feature-Dataset oder Feature-Class) des Elements auswählen, das Sie umbenennen möchten. | String |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie die Funktion "Rename" im unmittelbaren Modus verwendet wird.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Rename_management("customers.dbf", "customers_2010.dbf")
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion "Rename" in einem eigenständigen Skript verwenden.
# 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)