Zusammenfassung
Ändert den Namen eines Datasets. Dazu zählt eine Vielzahl von Datentypen, z. B. Feature-Dataset, Raster, Tabelle und Shapefile.
Verwendung
Der Ausgabename muss eindeutig sein. Falls nicht, wird eine Fehlermeldung angezeigt, selbst wenn für das Überschreiben der Ausgabe in der Geoverarbeitungsumgebung "true" festgelegt wurde.
Mit diesem Werkzeug werden keine Layer umbenannt, da ein Layer ein Verweis auf ein Dataset ist.
Mit dem Werkzeug Umbenennen werden keine Felder im Dataset umbenannt. Wenn Sie beispielsweise über ein Feld mit dem Namen ROADS_ID in einer Feature-Class mit dem Namen Roads verfügen, wird beim Umbenennen der Roads-Feature-Class in Streets das Feld ROADS_ID nicht in STREETS_ID umbenannt.
Beim Umbenennen eines Coverage werden auch alle Regions- und Routen-Subclasses innerhalb des Coverage umbenannt.
Aufgrund von Datenbankbeschränkungen kann das Werkzeug nicht für in einer DB2-Datenbank gespeicherte Daten verwendet werden.
Syntax
arcpy.management.Rename(in_data, out_data, {data_type})
Parameter | Erklärung | Datentyp |
in_data | Die umzubenennenden Eingabedaten. | 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 für das Python-Fenster veranschaulicht, wie die Funktion Rename im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Rename_management("customers.dbf", "customers_2010.dbf")
Rename – Beispiel 2 (eigenständiges Skript)
Das folgende Python-Skript veranschaulicht die Verwendung der Funktion Rename in einem eigenständigen Skript.
# Name: Rename_Example2.py
# Description: Rename fileGDB 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"
# Execute Rename
arcpy.Rename_management(in_data, out_data, data_type)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja