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. 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

EtiquetaExplicaciónTipo 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.

  • De nombre: los datos asociados a los datos de entrada, que también se copiarán.
  • Tipo de datos: tipo de 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, seleccione el tipo de datos correcto, FeatureDataset o FeatureClass, del elemento que desea copiar.
  • A nombre: el nombre de los datos copiados en el valor del parámetro Datos de salida.
  • Palabra clave de configuración: parámetros de almacenamiento de la geodatabase (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

arcpy.management.Copy(in_data, out_data, {data_type}, {associated_data})
NombreExplicaciónTipo 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.

  • from_name: los 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, utilice el tipo de datos correcto, FeatureDataset o FeatureClass, del elemento que desea copiar.
  • to_name: el nombre de los datos copiados en el valor del parámetro out_data.
  • 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 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

Ejemplo 1 de Copiar (ventana de Python)

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

# Run Copy
arcpy.management.Copy(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"

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)