Extraer paquete (Administración de datos)

Resumen

Extrae el contenido de un paquete a una carpeta especificada. La carpeta de salida se actualizará con los contenidos extraídos del paquete de entrada.

Uso

  • Los tipos de paquetes admitidos son los siguientes:

    • Paquete de geoprocesamiento (.gpk y .gpkx)
    • Paquetes de capas (.lpk y .lpkx)
    • Paquetes de localizadores (.gcpk)
    • Paquetes de mapas (.mpk y .mpkx)
    • Paquetes de mapas móviles (.mmpk)
    • Paquetes de proyecto y plantillas de proyecto (.ppkx y .aptx)
    • Paquetes de capas de escena (.slpk)
    • Paquetes de teselas (.tpk y .tpkx)
    • Paquetes de teselas vectoriales (.vtpk)

  • La carpeta de salida puede ser una carpeta nueva o una carpeta existente. Cuando extrae a una carpeta existente, el contenido del paquete se incorporará a los archivos y carpetas existentes. Si la carpeta de salida contiene el contenido extraído del paquete, el contenido existente se sobrescribirá.

  • Los archivos adjuntos de los paquetes que tienen adjuntos se extraerán en la subcarpeta commondata\userdata\ de la Carpeta de salida. Normalmente, los archivos de un paquete son complementarios; por ejemplo, .pdf, .docx o una imagen. Examine el directorio extraído en Microsoft File Explorer para abrir estos archivos.

  • Al extraer paquetes de teselas vectoriales (.vtpk), el contenido del paquete se extraerá en la carpeta de salida. El formato de almacenamiento en caché se puede convertir de compacto (archivos .bundle) a expandido (archivos .pbf) con el parámetro Tipo de formato de almacenamiento. Puede utilizar los archivos .pbf extraídos en otras aplicaciones cliente, como Mapbox.

    Nota:

    La extracción de una caché plana puede ser lenta y resultar en la extracción de miles de millones de teselas, dependiendo de la extensión de los datos, los niveles de detalle del paquete y la configuración de hardware.

  • Al extraer paquetes de capas vectoriales, de teselas o de escena (.vtpk, .tpk, .tpkx o .slpk), el parámetro Paquete en caché está inactivo.

  • Al extraer paquetes de capas de escena vectoriales, de teselas o de versiones 1.7 y posteriores, puede extraer el contenido del paquete a una carpeta del sistema de archivos o a un almacén de objetos ubicado en la nube, por ejemplo, Amazon S3, Azure Blob Storage o Alibaba OSS. Este contenido está listo para servir como capa de teselas o de escena y la ubicación que elija debe estar registrada como data store administrado por el usuario en ArcGIS Enterprise.

  • Puede crear un archivo de conexión (.acs) utilizando la herramienta Crear archivo de conexión de almacenamiento en la nube.

  • Las versiones más antiguas de los paquetes de capas de escena se pueden actualizar a la versión más reciente con la herramienta Actualizar capa de escena.

  • Nota:

    Al extraer paquetes de capas de escena a un almacén de objetos de la nube (.i3sREST), el formato de almacenamiento en caché de escenas no es el mismo que al extraer a una carpeta del sistema de archivos (.eslpk) y los dos formatos no son intercambiables.

Parámetros

EtiquetaExplicaciónTipo de datos
Paquete de entrada

Paquete de entrada que será extraído.

File
Carpeta de salida
(Opcional)

Carpeta de salida que contendrá el contenido del paquete.

Si la carpeta especificada no existe, se creará una carpeta.

Folder
Almacenar paquete en caché
(Opcional)

Especifica si se almacena una copia del paquete en la caché de su perfil.

Al extraer un paquete, la salida se extrae primero a su perfil de usuario y se le incorpora un Id. único antes de hacer una copia al directorio especificado en el parámetro Carpeta de salida. La descarga y extracción de las versiones posteriores del mismo paquete solo actualiza esta ubicación. Si se usa este parámetro, no es necesario crear manualmente una versión en caché del paquete en su perfil de usuario. Este parámetro no está activo si el paquete de entrada es un paquete de teselas vectoriales (.vtpk) o un paquete de teselas (.tpk y .tpkx).

  • Activado: se extraerá una copia del paquete, que se almacena en caché en su perfil. Esta es la opción predeterminada.
  • Desactivado: se extraerá una copia del paquete solo al parámetro de salida especificado; en caso contrario, no se almacena en caché.
Boolean
Tipo de formato de almacenamiento
(Opcional)

Especifica el formato de almacenamiento que se utilizará para la caché extraída. Este parámetro solo se aplica si el paquete de entrada es un paquete de teselas vectoriales (.vtpk).

  • CompactaLas teselas se agruparán en archivos de paquetes utilizando el formato de almacenamiento Compact V2. Este formato proporciona un mejor rendimiento en las redes compartidas y en los directorios de cloudstore. Esta es la opción predeterminada.
  • ExpandidoCada tesela se almacenará como un archivo individual.
String
Crear dataset de caché listo para servir
(Opcional)

Especifica si se creará un formato listo para servir destinado a ArcGIS Enterprise. Este parámetro solo está activo si el paquete de entrada es un paquete de teselas vectoriales (.vtpk) o un paquete de teselas (.tpkx).

  • Activado: se creará una estructura de carpetas con una caché extraída que se puede utilizar para crear una capa de teselas en ArcGIS Enterprise. La extensión de la carpeta indica el contenido que almacena: .tiles (dataset de caché) para los paquetes de capas de teselas o .vtiles (dataset de caché vectorial) para los paquetes de teselas vectoriales.
  • Desactivado: se creará una estructura de carpetas con el contenido extraído del paquete. Esta es la opción predeterminada.
Boolean
Conexión a la nube de destino
(Opcional)

El archivo .acs de destino al que se extraerá el contenido del paquete. Este parámetro solo está habilitado cuando el paquete de entrada es un paquete de capas de escena (.slpk), un paquete de teselas vectoriales (.vtpk) o un paquete de teselas (.tpkx).

Folder

arcpy.management.ExtractPackage(in_package, {output_folder}, {cache_package}, {storage_format_type}, {create_ready_to_serve_format}, {target_cloud_connection})
NombreExplicaciónTipo de datos
in_package

Paquete de entrada que será extraído.

File
output_folder
(Opcional)

Carpeta de salida que contendrá el contenido del paquete.

Si la carpeta especificada no existe, se creará una carpeta.

Folder
cache_package
(Opcional)

Especifica si se almacena una copia del paquete en la caché de su perfil.

Al extraer un paquete, la salida se extrae primero a su perfil de usuario y se le incorpora un Id. único antes de hacer una copia al directorio especificado en el parámetro output_folder. La descarga y extracción de las versiones posteriores del mismo paquete solo actualiza esta ubicación. Si se usa este parámetro, no es necesario crear manualmente una versión en caché del paquete en su perfil de usuario. Este parámetro no está habilitado si el paquete de entrada es un paquete de teselas vectoriales (.vtpk) o un paquete de teselas (.tpk y .tpkx).

  • CACHESe extraerá una copia del paquete, que se almacena en caché en su perfil. Esta es la opción predeterminada.
  • NO_CACHESe extraerá una copia del paquete solo al parámetro de salida especificado; en caso contrario, no se almacena en caché.
Boolean
storage_format_type
(Opcional)

Especifica el formato de almacenamiento que se utilizará para la caché extraída. Este parámetro solo se aplica si el paquete de entrada es un paquete de teselas vectoriales (.vtpk).

  • COMPACTLas teselas se agruparán en archivos de paquetes utilizando el formato de almacenamiento Compact V2. Este formato proporciona un mejor rendimiento en las redes compartidas y en los directorios de cloudstore. Esta es la opción predeterminada.
  • EXPLODEDCada tesela se almacenará como un archivo individual.
String
create_ready_to_serve_format
(Opcional)

Especifica si se creará un formato listo para servir destinado a ArcGIS Enterprise. Este parámetro solo está habilitado si el paquete de entrada es un paquete de teselas vectoriales (.vtpk) o un paquete de teselas (.tpkx).

  • READY_TO_SERVE_CACHE_DATASETSe creará una estructura de carpetas con una caché extraída que se puede utilizar para crear una capa de teselas en ArcGIS Enterprise. La extensión de la carpeta indica el contenido que almacena: .tiles (dataset de caché) para los paquetes de capas de teselas o .vtiles (dataset de caché vectorial) para los paquetes de teselas vectoriales.
  • EXTRACTED_PACKAGESe creará una estructura de carpetas con el contenido extraído del paquete. Esta es la opción predeterminada.
Boolean
target_cloud_connection
(Opcional)

El archivo .acs de destino al que se extraerá el contenido del paquete. Este parámetro solo está habilitado cuando el paquete de entrada es un paquete de capas de escena (.slpk), un paquete de teselas vectoriales (.vtpk) o un paquete de teselas (.tpkx).

Folder

Muestra de código

Ejemplo 1 de ExtractPackage (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función ExtractPackage para generar datasets de caché listos para usar en flujos de trabajo de publicación de ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\MyVectorPackage.vtpk", 
                                r"C:\Data\packages\Extracted", "CACHE", 
                                "COMPACT", "READY_TO_SERVE_CACHE_DATASET")
Ejemplo 2 de ExtractPackage (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función ExtractPackage para extraer paquetes de capas de escena a un almacén de objetos que se puede utilizar en flujos de trabajo de publicación de ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\ChicagoBuildings.slpk", 
                                None, "CACHE", 
                                "COMPACT", "EXTRACTED_PACKAGE", 
                                r"C:\CloudConnections\AWS.acs")
Ejemplo 3 de ExtractPackage (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función ExtractPackage para extraer paquetes de capas de teselas vectoriales a un almacén de objetos que se puede utilizar en flujos de trabajo de publicación de ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\London.vtpk", 
                                None, "CACHE", 
                                "COMPACT", "EXTRACTED_PACKAGE", 
                                r"C:\CloudConnections\AWS.acs")
Ejemplo 4 de ExtractPackage (script independiente)

Encontrar todos los paquetes de geoprocesamiento dentro de una carpeta especificada y utilizar la función ExtractPackage para extraer el contenido a la carpeta especificada.

# Name: ExtractPackage.py
# Description: Find geoprocessing packages in a specified folder and extract 
#              contents.

import arcpy
import os

arcpy.env.overwriteOutput = True

# set folder that contains packages to extract
arcpy.env.workspace = "C:/geoprocessing/gpks" 
wrksp = arcpy.env.workspace

for gpk in arcpy.ListFiles("*.gpk"):
    print("Extracting... " + gpk)
    arcpy.management.ExtractPackage(gpk, os.path.splitext(gpk)[0])

print("done")