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. 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 permite copiar un dataset de red en la misma geodatabase.

  • 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 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. 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
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: 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, debe seleccionar el tipo de datos, 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. 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.

  • from_name: 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, debe utilizar el tipo de datos, 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 en modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Copy_management("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"
# Execute Copy
arcpy.Copy_management(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"
# 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 #"
                                                                   ]))

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados