| Etiqueta | Explicación | Tipo de datos |
Datos de entrada | Los datos que se van a copiar. | Data Element |
Datos de salida | La ubicación y el nombre de los datos de salida. | Data Element |
Tipo de datos (Opcional) | Tipo de los datos del disco que se van a copiar. Este parámetro se utilizará en caso de un conflicto de nombres. Una geodatabase puede contener diferentes datasets con el mismo nombre, por ejemplo, una clase de entidad, un dataset de entidad, un dataset de mosaico y una estructura de parcela con el mismo nombre pueden existir en la misma geodatabase. Especificar un valor indicará a la herramienta que use ese tipo de datos en caso de que haya dos o más conjuntos de datos con el mismo nombre.
| String |
Datos asociados (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.
Los nombres de las columnas De nombre y A nombre serán idénticos si el valor de A nombre todavía no se ha utilizado en Datos de salida. Si ya existe un nombre en el valor de Datos de salida, se creará un único valor de A nombre incorporando un guion bajo más un número (por ejemplo, rivers_1). | Value Table |
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. Esto también 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.
Esta herramienta 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.
Esta herramienta no permite copiar un dataset de red en la misma geodatabase.
Esta herramienta 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 valor del parámetro Datos asociados, donde se puede controlar el nombre de los datos de salida asociados y la palabra clave de configuración.
Parámetros
arcpy.management.Copy(in_data, out_data, {data_type}, {associated_data})| Nombre | 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. Este parámetro se utilizará en caso de un conflicto de nombres. Una geodatabase puede contener diferentes datasets con el mismo nombre, por ejemplo, una clase de entidad, un dataset de entidad, un dataset de mosaico y una estructura de parcela con el mismo nombre pueden existir en la misma geodatabase. Especificar un valor indicará a la herramienta que use ese tipo de datos en caso de que haya dos o más conjuntos de datos con el mismo nombre.
| 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.
Los nombres de las columnas from_name y to_name serán idénticos si el valor de to_name todavía no se ha utilizado en out_data. Si ya existe un nombre en el valor de out_data, se creará un único valor de to_name incorporando un guion bajo más un número (por ejemplo, rivers_1). | Value Table |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función Copy de modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Copy("majorrds.shp", "C:/output/majorrdsCopy.shp")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"
# Run Copy
arcpy.management.Copy(in_data, out_data)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"
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)