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.
Dieses Werkzeug benennt keine Layers um, da ein Layer ein Verweis auf ein Dataset ist.
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
Rename_management (in_data, out_data, {data_type})
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
Rename – Beispiel 1 (Python-Fenster)
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")
Rename – Beispiel 2 (eigenständiges Python-Skript)
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)
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Ja
- ArcGIS Desktop Standard: Ja
- ArcGIS Desktop Advanced: Ja