Copier (Gestion des données)

Synthèse

Copie les données en entrée.

Utilisation

  • 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, le paramètre Données associées s’affiche si le nom des données en sortie associées et le mot-clé de configuration peuvent être contrôlés.

Paramètres

ÉtiquetteExplicationType 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)

Type des données du 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.

  • Depuis : nom : Données associées aux données en entrée, qui seront également copiées.
  • Data Type (Type de données) : type des données sur le disque à copier. Vous devez fournir une valeur uniquement lorsqu’une géodatabase contient un jeu de classes d’entités et une classe d’entités portant le même nom. Dans ce cas, sélectionnez le type de données correct, FeatureDataset ou FeatureClass, de l’élément que vous souhaitez copier.
  • Vers le nom : nom des données copiées dans la valeur du paramètre Données en sortie.
  • Mot-clé de configuration : les paramètres de stockage de la géodatabase (configuration).

Les noms des colonnes Depuis le nom et Vers le nom sont identiques si la valeur Vers le nom n’est pas déjà utilisée dans Données en sortie. Si un nom existe déjà dans la valeur Données en sortie, une valeur Vers le nom unique est créée via l’ajout d’un caractère de soulignement et d’un nombre (par exemple, fleuves_1).

Value Table

arcpy.management.Copy(in_data, out_data, {data_type}, {associated_data})
NomExplicationType 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)

Type des données du 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.

  • from_name : Données associées aux données en entrée, qui seront également copiées.
  • data_type : type des données sur le disque à copier. Vous devez fournir une valeur uniquement lorsqu’une géodatabase contient un jeu de classes d’entités et une classe d’entités portant le même nom. Dans ce cas, utilisez le type de données correct, FeatureDataset ou FeatureClass, de l’élément à copier.
  • to_name : nom des données copiées dans la valeur du paramètre out_data.
  • config_keyword : paramètres de stockage de la géodatabase (configuration).

Les noms des colonnes from_name et to_name sont identiques si la valeur to_name n’est pas déjà utilisée dans out_data. Si un nom existe déjà dans la valeur out_data, une valeur to_name unique est créée via l’ajout d’un caractère de soulignement et d’un nombre (par exemple, fleuves_1).

Value Table

Exemple de code

Exemple 1 d’utilisation de la fonction Copy (fenêtre Python)

Le script ci-dessous pour la fenêtre Python 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 la fonction Copy (script autonome)

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)
Exemple 3 d’utilisation de la fonction Copy (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)

Rubriques connexes