Copier (Outils de gestion des données)

Résumé

Copie les données en entrée dans un espace de travail en sortie dont le type de données est le même que celui de l’espace de travail en entrée.

Utilisation

Cet outil ne copie les données qu’entre des espaces de travail dont le type de données est le même : d’un dossier dans un dossier et de tout type de géodatabase dans tout type de géodatabase (fichier, d’entreprise ou mobile). Pour copier des données entre des types d’espace de travail différents, utilisez l’outil Copy Features (Copier des entités) ou d’autres outils de la boîte à outils Conversion.

Cet outil ne prend pas en charge la copie vers ou depuis un espace de travail en mémoire.
Si une classe d’entités est copiée vers un jeu de données d’entité, la référence spatiale de la classe d’entités et du jeu de données d’entité doivent correspondre ; sinon, l’outil échoue.
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—tous sont copiés avec la classe d’entités. La copie des réseaux géométriques, jeux de données réseau et topologies copie également les classes d’entités participantes.
Cet outil ne copie pas les couches, étant donné qu’une couche n’est qu’une référence à une classe d’entités.
La copie d’un jeu de données mosaïque se fait dans l’emplacement désigné ; les images référencées par le jeu de données mosaïque ne sont pas copiées.
Cet outil ne prend pas en charge la copie d’un jeu de données réseau dans la même géodatabase.
Cet outil ne prend pas en charge le format d’image MRF. Pour copier un fichier .mrf, utilisez l’outil Copy Raster (Copier un raster).
Lorsque l’entrée est associée à des données, la valeur de paramètre Associated Data (Données associées) s’affiche pour que le nom des données en sortie associées et le mot-clé de configuration puissent être contrôlés.

Etiqueter	Explication	Type de données
Données en entrée	Les données à copier.	Data Element
Données en sortie	Emplacement et nom des données en sortie.	Data Element
Type de données (Facultatif)	Le type de données sur le disque à copier. Ce paramètre est uniquement nécessaire en cas de conflit de noms entre deux types de données différents. Par exemple, une géodatabase peut contenir une classe de relations portant un nom identique à une classe d’entités. Si tel est le cas, indiquez le mot-clé pertinent. `FeatureClass`—En cas de noms en double, la classe d’entités est utilisée. `FeatureDataset`—En cas de noms en double, le jeu de classes d’entités est utilisé. `MosaicDataset`—En cas de noms en double, le jeu de données mosaïque est utilisé. `ParcelFabric`—En cas de noms en double, l’atelier parcellaire est utilisé. `RelationshipClass`—En cas de noms en double, la classe de relations est utilisée. `Topology`—En cas de noms en double, la topologie est utilisée.	String
Données associées (Facultatif)	Lorsque l’entrée est associée à des données, ce paramètre peut servir à contrôler le nom des données en sortie associées et le mot-clé de configuration. Les noms des colonnes From Name (Nom d’origine) et To Name (Nom de destination) sont identiques si la valeur To Name (Nom de destination) n’est pas utilisée dans la valeur de paramètre Output Data (Données en sortie). Si le nom existe dans la valeur Output Data (Données en sortie), une valeur To Name (Nom de destination) unique est créée automatiquement en ajoutant un trait de soulignement et un chiffre (par exemple, fleuves_1) à la valeur From Name (Nom d’origine). Colonnes de la table de valeurs : 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})

Nom	Explication	Type de données
in_data	Les données à copier.	Data Element
out_data	Emplacement et nom des données en sortie. L’extension du nom de fichier des données en sortie doit correspondre à celle des données en entrée. Par exemple, si vous copiez une géodatabase fichier, vos éléments de données en sortie doivent être suivis du suffixe `.gdb`.	Data Element
data_type (Facultatif)	Le type de données sur le disque à copier. Ce paramètre est uniquement nécessaire en cas de conflit de noms entre deux types de données différents. Par exemple, une géodatabase peut contenir une classe de relations portant un nom identique à une classe d’entités. Si tel est le cas, indiquez le mot-clé pertinent. `FeatureClass`—En cas de noms en double, la classe d’entités est utilisée. `FeatureDataset`—En cas de noms en double, le jeu de classes d’entités est utilisé. `MosaicDataset`—En cas de noms en double, le jeu de données mosaïque est utilisé. `ParcelFabric`—En cas de noms en double, l’atelier parcellaire est utilisé. `RelationshipClass`—En cas de noms en double, la classe de relations est utilisée. `Topology`—En cas de noms en double, la topologie est utilisée.	String
associated_data [[from_name, data_type, to_name, config_keyword],...] (Facultatif)	Lorsque l’entrée est associée à des données, ce paramètre peut servir à contrôler le nom des données en sortie associées et le mot-clé de configuration. Les noms des colonnes `from_name` et `to_name` sont identiques si la valeur `to_name` n’est pas utilisée dans la valeur de paramètre `out_data`. Si le nom existe dans la valeur `out_data`, une valeur `to_name` unique est créée en ajoutant un trait de soulignement et un chiffre (par exemple, fleuves_1) à la valeur `from_name`. Colonnes de la table de valeurs : `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

Exemple de code

Exemple 1 d’utilisation de l’outil Copy (Copier) (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction Copy en mode immédiat.

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

Exemple 2 d’utilisation de l’outil Copy (Copier) (script autonome)

Le script Python ci-après illustre l’utilisation de la fonction Copy dans un script autonome.

# 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)

Exemple 3 d’utilisation de l’outil Copy (Copier) (script autonome)

Le script Python ci-dessous illustre l’utilisation du paramètre associated_data dans la fonction Copy.

# 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)

Exemple 4 d’utilisation de l’outil Copy (Copier) (fenêtre Python)

Ce script de fenêtre Python indique comment utiliser la fonction Copy avec un jeu de données d’entités et préciser le paramètre associated_data dans un environnement de géodatabase d’entreprise.

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 #"
)

Exemple 5 d’utilisation de l’outil Copy (Copier) (script autonome)

Ce script Python indique comment utiliser la fonction Copy avec un jeu de données d’entités et préciser le paramètre associated_data dans un environnement de géodatabase d’entreprise.

# 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)

Environnements

Espace de travail courant, Mot-clé CONFIG en sortie, Espace de travail temporaire, Conserver les pièces jointes

Informations de licence