| 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) | El tipo de datos del disco que se van a copiar. Este parámetro solo es necesario en caso de conflicto de nombres entre dos tipos de datos diferentes. Por ejemplo, una geodatabase puede contener una clase de relación que tiene un nombre idéntico al de una clase de entidad. Si este es el caso, especifique la palabra clave correspondiente.
| 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 columna De nombre y A nombre serán idénticos si el valor de nombre no se utiliza en el valor del parámetro Datos de salida. Si el nombre existe en el valor Datos de salida, se creará automáticamente un valor para el parámetro A nombre único agregando un guion bajo y un número (por ejemplo, rivers_1) al valor del parámetro De nombre. | Value Table |
Resumen
Copia los datos de entrada en un espacio de trabajo de salida del mismo tipo de datos que el espacio de trabajo de entrada.
Uso
Esta herramienta solo copia entre espacios de trabajo del mismo tipo de datos: de una carpeta a otra y de cualquier tipo de geodatabase a cualquier tipo de geodatabase (de archivo, corporativa o móvil). Para copiar datos entre distintos tipos de espacios de trabajo, utilice la herramienta Copiar entidades u otras herramientas de la caja de herramientas Conversión.
Esta herramienta no permite copiar en ni desde un espacio de trabajo de memoria.
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, de modo que 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) | El tipo de datos del disco que se van a copiar. Este parámetro solo es necesario en caso de conflicto de nombres entre dos tipos de datos diferentes. Por ejemplo, una geodatabase puede contener una clase de relación que tiene un nombre idéntico al de una clase de entidad. Si este es el caso, especifique la palabra clave correspondiente.
| 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 no se utiliza en el valor del parámetro out_data. Si el nombre ya existe en el valor del parámetro out_data, se creará un valor to_name único agregando un guion bajo y un número (por ejemplo, rivers_1) al valor del parámetro from_name. | Value Table |
Muestra de código
La siguiente secuencia de comandos de la ventana de Python muestra 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")La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función Copy en una secuencia de comandos 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)La siguiente secuencia de comandos 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)La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función Copy con un dataset de entidades y especificar el parámetro associated_data en el entorno de una geodatabase corporativa.
import arcpy
arcpy.management.Copy(
in_data=r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Mexico",
out_data=r"C:\Users\GIS\SQLServerDatabase.sde\DBO.PyCmd_Mexico",
data_type="FeatureDataset",
associated_data="DBO.Rivers FeatureClass DBO.PyCmd_Rivers #;DBO.Lakes FeatureClass DBO.PyCmd_Lakes #;DBO.Cities FeatureClass DBO.PyCmd_Cities #"
)La siguiente secuencia de comandos de Python la ventana de muestra cómo utilizar la función Copy con un dataset de entidades y especificar el parámetro associated_data en el entorno de una geodatabase corporativa.
# Description: Copy a feature dataset and specify associated_data within an
# Enterprise geodatabase environment
# Import system modules
import arcpy
# The input is a feature dataset containing 3 feature classes: lakes, cities,
# rivers.
in_data = r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Mexico"
# The output is a new feature dataset that the feature classes from in_data will
# be copied to
out_data = r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Py_Mexico"
# Define schema of the from_name and to_name values when preparing data to be
# created in an enterprise geodatabase
associated_data = ";".join(["DBO.Lakes FeatureClass DBO.Py_Lakes #",
"DBO.Cities FeatureClass DBO.Py_Cities #",
"DBO.Rivers FeatureClass DBO.Py_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)Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí