| Étiquette | 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.
| 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 Nom d’origine et Nom de destination sont identiques si la valeur Nom de destination n’est pas utilisée dans la valeur de paramètre Données en sortie. Si le nom existe dans la valeur Données en sortie, une valeur Nom de destination unique est créée automatiquement en ajoutant un trait de soulignement et un chiffre (par exemple, fleuves_1) à la valeur Nom d’origine. | Value Table |
Synthèse
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 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.
Toutes les données qui dépendent de l’entrée sont également copiées. Par exemple, la copie d’une classe d’entités ou d’une table qui fait partie d’une classe de relations copie également la classe de relations. Cela s’applique également à une classe d’entités qui a des annotations, des domaines, des sous-types et des index liés aux entités. Tous ces éléments 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’une mosaïque se fait dans l’emplacement désigné ; les images référencées par la 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 Copier un raster.
Lorsque l’entrée est associée à des données, la valeur de paramètre 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.
Paramètres
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.
| 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. | Value Table |
Exemple de code
Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction Copy en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Copy("majorrds.shp", "C:/output/majorrdsCopy.shp")Le script Python ci-dessous 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)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)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 #"
)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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?