Umbenennen (Data Management)

Zusammenfassung

Ändert den Namen eines Datasets. Dazu zählt eine Vielzahl von Datentypen, einschließlich 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 dem Werkzeug wird auch der Alias der Daten umbenannt.

  • Mit dem Werkzeug werden keine Layer umbenannt, da ein Layer ein Verweis auf ein Dataset ist.

  • Mit dem Werkzeug 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 Feature-Class von "Roads" in "Streets" das Feld ROADS_ID nicht in STREETS_ID umbenannt.

  • Aufgrund von Datenbankbeschränkungen kann das Werkzeug nicht für in einer DB2-Datenbank gespeicherte Daten verwendet werden.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Datenelement

Die umzubenennenden Eingabedaten.

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 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.management.Rename("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"

# Run Rename
arcpy.management.Rename(in_data, out_data, data_type)

Lizenzinformationen

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

Verwandte Themen