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
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.
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
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")
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)
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
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí