Copiar (Administración de datos)

Resumen

Realiza una copia de los datos de entrada.

Uso

• Si se copia una clase de entidad a un dataset de entidades, la referencia espacial de la clase de entidad y el dataset de entidades deben coincidir, de lo contrario, la herramienta fallará.

• También se copian todos los datos que dependan de la entrada. Por ejemplo, al copiar una clase de entidad o tabla que forma parte de una clase de relación también se copia la clase de relación. Lo mismo se aplica a la clase de entidad que tiene una anotación vinculada a entidad, dominios, subtipos e índices, todo se copia junto con la clase de entidad. Copiar redes geométricas, datasets de red y topologías también copia las clases de entidades participantes.

• La herramienta Copiar no copia capas, ya que una capa es solo una referencia a una clase de entidad.

• Al copiar un dataset de mosaico copia el dataset de mosaico en la ubicación designada; las imágenes a las que hace referencia el dataset de mosaico no se copian.

• La herramienta Copiar no admite el formato de imagen .mrf. Para copiar un archivo .mrf, utilice la herramienta Copiar ráster.

• Si la entrada tiene datos asociados, se muestra el parámetro Datos asociados, donde se puede controlar el nombre de los datos de salida asociados y la palabra clave de configuración.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
in_data	Los datos que se van a copiar.	Data Element
out_data	La ubicación y el nombre de los datos de salida. La extensión de nombre de archivo de los datos de salida debe coincidir con la extensión de los datos de entrada. Por ejemplo, si va a copiar una geodatabase de archivos, el elemento de datos de salida debe tener .gdb como sufijo.	Data Element
data_type (Opcional)	Tipo de los datos del disco que se van a copiar. Esto solo es necesario si los datos de entrada se encuentran en una geodatabase y existe un conflicto de nomenclatura, por ejemplo, si la geodatabase contiene un dataset de entidades y una clase de entidad con el mismo nombre. En este caso, se utiliza el tipo de datos para aclarar el dataset que desea copiar.	String
associated_data [[from_name, data_type, to_name, config_keyword],...] (Opcional)	Si la entrada tiene datos asociados, se puede utilizar este parámetro para controlar el nombre de los datos de salida asociados y la palabra clave de configuración. from_name: datos asociados a los datos de entrada, que también se copiarán. data_type: tipo de los datos del disco que se van a copiar. La única vez que deberá proporcionar un valor es cuando una geodatabase contiene un dataset de entidad y una clase de entidad con el mismo nombre. En este caso, debe seleccionar el tipo de datos, FeatureDataset o FeatureClass, del elemento que desea copiar. config_keyword: parámetros de almacenamiento de la geodatabase (configuración). Los nombres de las columnas from_name y to_name serán idénticos si to_name todavía no se ha utilizado en los out_data. Si ya existe un nombre en los out_data, se creará un único to_name incorporando un guión bajo más un número, _2.	Value Table

Muestra de código

Ejemplo 1 de Copiar (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función Copy en modo inmediato.

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

Ejemplo 2 de Copiar (script independiente)

El siguiente script de Python muestra cómo utilizar la función Copy en un script independiente.

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

Ejemplo 3 de Copiar (script independiente)

El siguiente script de Python muestra cómo utilizar el parámetro associated_data en la función 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 #"
                                                                   ]))

Entornos

Espacio de trabajo actual, Palabra clave CONFIG de salida, Espacio de trabajo temporal, Mantener adjuntos

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí