Kopieren (Data Management Tools)

Zusammenfassung

Kopiert die Eingabedaten in einen Ausgabe-Workspace, dessen Datentyp mit dem des Eingabe-Workspace identisch ist.

Verwendung

Dieses Werkzeug kann nur zwischen Workspaces desselben Datentyps kopieren: Aus einem Ordner in einen Ordner und aus einer Geodatabase eines beliebigen Typs in eine Geodatabase eines beliebigen Typs (File-, Enterprise- oder Mobile-Geodatabase). Um Daten zwischen Workspaces unterschiedlicher Typen zu kopieren, sollten Sie das Werkzeug Features kopieren oder andere Werkzeuge in der Toolbox "Conversion" verwenden.

Das Kopieren in oder aus einem memory-Workspace wird durch dieses Werkzeug nicht unterstützt.
Wenn eine Feature-Class in ein vorhandenes Feature-Dataset kopiert wird, muss der Raumbezug von Feature-Class und Feature-Dataset übereinstimmen. Ansonsten kann das Werkzeug nicht ausgeführt werden.
Any data that is dependent on the input is also copied. For example, copying a feature class or table that is part of a relationship class also copies the relationship class. This also applies to a feature class that has feature-linked annotation, domains, subtypes, and indices—All diese Elemente werden zusammen mit der Feature-Class kopiert. Beim Kopieren von geometrischen Netzwerken, Netzwerk-Datasets und Topologien werden auch die beteiligten Feature-Classes kopiert.
Dieses Werkzeug kopiert keine Layer, da ein Layer lediglich ein Verweis auf eine Feature-Class ist.
Beim Kopieren eines Mosaik-Datasets wird es an den angegebenen Ort kopiert; die Bilder, auf die das Mosaik-Dataset verweist, werden nicht kopiert.
Dieses Werkzeug unterstützt nicht das Zurückkopieren eines Netzwerk-Datasets in dieselbe Geodatabase.
Dieses Werkzeug unterstützt das MRF-Bildformat nicht. Um eine .mrf-Datei zu kopieren, verwenden Sie das Werkzeug Raster kopieren.
Wenn Daten mit der Eingabe verknüpft sind, wird der Wert des Parameters Zugehörige Daten angezeigt, der die Festlegung des Namens der zugehörigen Ausgabedaten und des Konfigurationsschlüsselwortes ermöglicht.

Beschriftung	Erläuterung	Datentyp
Eingabedaten	Die Daten, die kopiert werden.	Data Element
Ausgabedaten	Der Speicherort und Name der Ausgabedaten.	Data Element
Datentyp (Optional)	Der Typ der Daten auf der Festplatte, die kopiert werden. 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
Zugehörige Daten (Optional)	Wenn Daten mit der Eingabe verknüpft sind, können mit diesem Parameter der Name der zugehörigen Ausgabedaten und das Konfigurationsschlüsselwort festgelegt werden. Wenn der Wert von In Name im Wert des Parameters Ausgabedaten nicht verwendet wird, dann sind die Namen der Spalten Von Name und In Name identisch. Wenn der Name im Wert von Ausgabedaten vorhanden ist, dann wird automatisch ein eindeutiger Wert für In Name erstellt, indem ein Unterstrich und eine Zahl (z. B. "rivers_1") an den Wert von Von Name angehängt werden. Spalten der Wertetabelle: From Name—The data associated with the input data, which will also be copied. Data Type—The type of the data on disk that will be copied. The only time you need to provide a value is when a geodatabase contains a feature dataset and a feature class with the same name. In this case, use the correct data type, FeatureDataset or FeatureClass, of the item you want to copy. To Name—The name of the copied data in the output. Config Keyword—The geodatabase storage parameters (configuration).	Value Table

arcpy.management.Copy(in_data, out_data, {data_type}, {associated_data})

Name	Erläuterung	Datentyp
in_data	Die Daten, die kopiert werden.	Data Element
out_data	Der Speicherort und Name der Ausgabedaten. Die Dateinamenerweiterung der Ausgabedaten muss mit der Erweiterung der Eingabedaten übereinstimmen. Wenn Sie beispielsweise eine File-Geodatabase kopieren, muss das Ausgabedatenelement über die Dateiendung `.gdb` verfügen.	Data Element
data_type (Optional)	Der Typ der Daten auf der Festplatte, die kopiert werden. 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
associated_data [[from_name, data_type, to_name, config_keyword],...] (Optional)	Wenn Daten mit der Eingabe verknüpft sind, können mit diesem Parameter der Name der zugehörigen Ausgabedaten und das Konfigurationsschlüsselwort festgelegt werden. Wenn der Wert von `to_name` im Wert des Parameters `out_data` nicht verwendet wird, dann sind die Namen der Spalten `from_name` und `to_name` identisch. Wenn der Name im Wert von `out_data` vorhanden ist, dann wird ein eindeutiger Wert für `to_name` erstellt, indem ein Unterstrich und eine Zahl (z. B. "rivers_1") an den Wert von `from_name` angehängt werden. Spalten der Wertetabelle: `From Name`—The data associated with the input data, which will also be copied. `Data Type`—The type of the data on disk that will be copied. The only time you need to provide a value is when a geodatabase contains a feature dataset and a feature class with the same name. In this case, use the correct data type, FeatureDataset or FeatureClass, of the item you want to copy. `To Name`—The name of the copied data in the output. `Config Keyword`—The geodatabase storage parameters (configuration).	Value Table

Codebeispiel

Copy: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion Copy im Direkt-Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Copy("majorrds.shp", "C:/output/majorrdsCopy.shp")

Copy: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion Copy in einem eigenständigen Skript.

# Name: Copy_Example2.py
# Description: Copy major roads dataset to preserve the original data

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/data"

# Set local variables
in_data =  "majorrds.shp"
out_data = "C:/output/majorrdsCopy.shp"

# Run Copy
arcpy.management.Copy(in_data, out_data)

Copy: Beispiel 3 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie Sie den Parameter associated_data für die Funktion Copy verwenden.

# Name: Copy_Example3.py
# Description: Copy a feature dataset and specify associated_data

# Import system modules
import arcpy

# The input is a feature dataset containing 3 feature classes: lakes, cities, rivers
in_data =  "C:/data/proj.gdb/mexico"
out_data = "C:/data/proj.sde/mexico"

associated_data = ";".join(["lakes FeatureClass mexico_lakes #",
                            "cities FeatureClass mexico_cities #",
                            "rivers FeatureClass mexico_rivers #"])

# Rename each feature class during the copy operation using the associated_data parameter
arcpy.management.Copy(in_data, out_data, associated_data=associated_data)

Copy: Beispiel 4 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion Copy mit einem Feature-Dataset verwendet wird und wie der Parameter associated_data in einer Enterprise-Geodatabase-Umgebung angegeben wird.

import arcpy
arcpy.management.Copy(
   in_data=r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Mexico",
   out_data=r"C:\Users\GIS\SQLServerDatabase.sde\DBO.PyCmd_Mexico",
   data_type="FeatureDataset",
   associated_data="DBO.Rivers FeatureClass DBO.PyCmd_Rivers #;DBO.Lakes FeatureClass DBO.PyCmd_Lakes #;DBO.Cities FeatureClass DBO.PyCmd_Cities #"
)

Copy: Beispiel 5 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion Copy mit einem Feature-Dataset verwendet wird und wie der Parameter associated_data in einer Enterprise-Geodatabase-Umgebung angegeben wird.

# Description: Copy a feature dataset and specify associated_data within an
#              Enterprise geodatabase environment

# Import system modules
import arcpy

# The input is a feature dataset containing 3 feature classes: lakes, cities,
# rivers.
in_data = r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Mexico"

# The output is a new feature dataset that the feature classes from in_data will
# be copied to
out_data = r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Py_Mexico"

# Define schema of the from_name and to_name values when preparing data to be
# created in an enterprise geodatabase
associated_data = ";".join(["DBO.Lakes FeatureClass DBO.Py_Lakes #",
                            "DBO.Cities FeatureClass DBO.Py_Cities #",
                            "DBO.Rivers FeatureClass DBO.Py_Rivers #"])

# Rename each feature class during the copy operation using the associated_data
# parameter
arcpy.management.Copy(in_data, out_data, associated_data=associated_data)

Umgebungen

Aktueller Workspace, Ausgabe-CONFIG-Schlüsselwort, Scratch-Workspace, Anlagen beibehalten

Lizenzierungsinformationen