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.

  • L'outil Copier 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.

  • L’outil Copier 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. Ceci est nécessaire uniquement lorsque les données en entrée sont dans une géodatabase et que des conflits de noms sont rencontrés, par exemple si la géodatabase contient un jeu de données d'entité et une classe d'entités qui portent le même nom. Dans ce cas, le type de données est utilisé pour clarifier le jeu de données que vous souhaitez copier.

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 seulement lorsqu'une géodatabase contient un jeu de données d'entité et une classe d'entités qui ont le même nom. Dans ce cas, vous devez sélectionner le type de données (FeatureDataset ou FeatureClass), de l'élément à copier.
  • Vers le nom : le nom des données copiées dans les données en sortie.
  • Mot-clé de configuration : les paramètres de stockage de la géodatabase (configuration).

Les noms des colonnes Depuis : 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 est déjà présent dans Données en sortie, un nom de destination unique (Vers le nom) est créé en ajoutant un caractère de soulignement plus un nombre, _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. Ceci est nécessaire uniquement lorsque les données en entrée sont dans une géodatabase et que des conflits de noms sont rencontrés, par exemple si la géodatabase contient un jeu de données d'entité et une classe d'entités qui portent le même nom. Dans ce cas, le type de données est utilisé pour clarifier le jeu de données que vous souhaitez copier.

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 seulement lorsqu'une géodatabase contient un jeu de données d'entité et une classe d'entités qui ont le même nom. Dans ce cas, vous devez utiliser le type de données (FeatureDataset ou FeatureClass), de l'élément à copier.
  • config_keyword : paramètres de stockage de la géodatabase (configuration).

Les noms des colonnes from_name etto_name sont identiques si la valeur to_name n'est pas déjà utilisée dans out_data. Si un nom est déjà présent dans out_data, un nom de destination unique (to_name) est créé en ajoutant un caractère de soulignement plus un nombre, _2.

Value Table

Exemple de code

Exemple 1 d'utilisation de la fonction Copier (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Copy en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Copy_management("majorrds.shp", "C:/output/majorrdsCopy.shp")
Exemple 2 d’utilisation de l’outil Copy (Copier) (script autonome)

Le script Python ci-dessous illustre l'utilisation de l'outil 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"
# Execute Copy
arcpy.Copy_management(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"
# Rename each feature class during the copy operation using the associated_data parameter
arcpy.Copy_management(in_data, out_data, associated_data=";".join(["lakes FeatureClass mexico_lakes #",
                                                                   "cities FeatureClass mexico_cities #",
                                                                   "rivers FeatureClass mexico_rivers #"
                                                                   ]))

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes