Copiar (Herramientas de administración de datos)

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á.
Any data that is dependent on the input is also copied. For example, copying a feature class or table that is part of a relationship class also copies the relationship class. This also applies to a feature class that has feature-linked annotation, domains, subtypes, and indices—Todas se copian 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.

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. `FeatureClass`—En caso de nombres duplicados, se utilizará la clase de entidad. `FeatureDataset`—En caso de nombres duplicados, se utilizará el dataset de entidades. `MosaicDataset`—En caso de nombres duplicados, se utilizará el dataset de mosaico. `ParcelFabric`—En el caso de nombres duplicados, se utilizará la estructura de parcela. `RelationshipClass`—En caso de nombres duplicados, se utilizará la clase de relación. `Topology`—En caso de nombres duplicados, se utilizará la topología.	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 A 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. Columnas de la tabla de valores: From Name—The data associated with the input data, which will also be copied. Data Type—The type of the data on disk that will be copied. The only time you need to provide a value is when a geodatabase contains a feature dataset and a feature class with the same name. In this case, use the correct data type, FeatureDataset or FeatureClass, of the item you want to copy. To Name—The name of the copied data in the output. Config Keyword—The geodatabase storage parameters (configuration).	Value Table

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. `FeatureClass`—En caso de nombres duplicados, se utilizará la clase de entidad. `FeatureDataset`—En caso de nombres duplicados, se utilizará el dataset de entidades. `MosaicDataset`—En caso de nombres duplicados, se utilizará el dataset de mosaico. `ParcelFabric`—En el caso de nombres duplicados, se utilizará la estructura de parcela. `RelationshipClass`—En caso de nombres duplicados, se utilizará la clase de relación. `Topology`—En caso de nombres duplicados, se utilizará la topología.	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`. Columnas de la tabla de valores: `From Name`—The data associated with the input data, which will also be copied. `Data Type`—The type of the data on disk that will be copied. The only time you need to provide a value is when a geodatabase contains a feature dataset and a feature class with the same name. In this case, use the correct data type, FeatureDataset or FeatureClass, of the item you want to copy. `To Name`—The name of the copied data in the output. `Config Keyword`—The geodatabase storage parameters (configuration).	Value Table

Muestra de código

Ejemplo 1 de "Copy" (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.management.Copy("majorrds.shp", "C:/output/majorrdsCopy.shp")

Ejemplo 2 de "Copy" (script independiente)

El siguiente script de Python demuestra 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)

Ejemplo 3 de "Copy" (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"

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)

Ejemplo 4 de "Copy" (ventana de Python)

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

Ejemplo 5 de "Copy" (script independiente)

La siguiente secuencia de comandos 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.

# 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

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

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Copiar (Herramientas de administración de datos)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados