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.

  • 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.

  • Dieses Werkzeug kann aufgrund von Datenbankeinschränkungen nicht für Daten in einer DB2-Datenbank verwendet werden.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Datenelement

Die Eingabedaten, die umbenannt werden sollen.

Data Element
Ausgabe-Datenelement

Der Name für die Ausgabedaten.

Data Element
Datentyp
(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

arcpy.management.Rename(in_data, out_data, {data_type})
NameErläuterungDatentyp
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

Sonderfälle

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen