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. Andernfalls wird eine Fehlermeldung angezeigt, auch wenn die Geoverarbeitungseinstellung Geoverarbeitungswerkzeugen das Überschreiben vorhandener Datasets erlauben aktiviert ist.

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

Data Element
Datentyp

Der Typ der umzubenennenden Daten.

Dieser Parameter ist nur im Falle eines Namenskonflikts zwischen zwei verschiedenen Datentypen erforderlich. So kann eine Geodatabase beispielsweise eine Beziehungsklasse enthalten, deren Name mit dem einer Feature-Class identisch ist. Geben Sie in diesem Fall das entsprechende Schlüsselwort an.

  • FeatureClass: Bei doppelten Namen wird die Feature-Class verwendet.
  • FeatureDataset: Bei doppelten Namen wird das Feature-Dataset verwendet.
  • MosaicDataset: Bei doppelten Namen wird das Mosaik-Dataset verwendet.
  • ParcelFabric: Bei doppelten Namen wird die Parcel-Fabric verwendet.
  • RelationshipClass: Bei doppelten Namen wird die Beziehungsklasse verwendet.
  • Topology: Bei doppelten Namen wird die Topologie verwendet.
String

arcpy.management.Rename(in_data, out_data, data_type)
NameErläuterungDatentyp
in_data

Die umzubenennenden Eingabedaten.

Data Element
out_data

Der Name der Ausgabedaten.

Data Element
data_type

Der Typ der umzubenennenden Daten.

Dieser Parameter ist nur im Falle eines Namenskonflikts zwischen zwei verschiedenen Datentypen erforderlich. So kann eine Geodatabase beispielsweise eine Beziehungsklasse enthalten, deren Name mit dem einer Feature-Class identisch ist. Geben Sie in diesem Fall das entsprechende Schlüsselwort an.

  • FeatureClass: Bei doppelten Namen wird die Feature-Class verwendet.
  • FeatureDataset: Bei doppelten Namen wird das Feature-Dataset verwendet.
  • MosaicDataset: Bei doppelten Namen wird das Mosaik-Dataset verwendet.
  • ParcelFabric: Bei doppelten Namen wird die Parcel-Fabric verwendet.
  • RelationshipClass: Bei doppelten Namen wird die Beziehungsklasse verwendet.
  • Topology: Bei doppelten Namen wird die Topologie verwendet.
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.

# Description: Rename a file geodatabase 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)

Verwandte Themen