Распаковать (Управление данными)

Краткая информация

Извлекает содержимое пакета в указанную папку. Распакованное содержимое входного пакета будет добавлено в выходную папку.

Использование

  • Поддерживаются следующие типы пакетов:

    • Пакеты геообработки (.gpk и .gpkx)
    • Пакеты слоев (.lpk и .lpkx)
    • Пакеты локатора (.gcpk)
    • Пакеты карт (.mpk и .mpkx)
    • Пакеты мобильных карт (.mmpk)
    • Пакеты проектов и шаблоны проектов (.ppkx и .aptx)
    • Пакеты слоя сцены (.slpk)
    • Пакеты листов (.tpk и .tpkx)
    • Пакеты векторных листов (.vtpk)

  • Выходная папка может быть как новой папкой, так и существующей папкой. При распаковке в существующую папку содержимое пакета будет добавлено к существующим файлам и вложенным папкам. Если выходная папка содержит извлеченное содержимое пакета, существующее содержимое будет перезаписано.

  • Прикрепленные файлы из пакетов с вложениями будут распакованы в подпапку commondata\userdata\ выходной папки. Обычно файлы в пакете - это вспомогательные файлы, например .pdf, .docx или изображение. Перейдите в извлеченный каталог в проводнике Windows, чтобы открыть эти файлы.

  • При извлечении пакетов векторных листов (.vtpk) содержимое пакета будет извлечено в выходную папку. Формат хранения кэша может быть преобразован из компактного (файлы .bundle) в полистный (файлы .pbf) с помощью параметра Тип формата хранения. Вы можете использовать извлеченные файлы .pbf в других клиентских приложениях, таких как Mapbox.

  • При извлечении пакетов векторных листов, пакетов листов или пакетов слоев сцены (.vtpk, .tpk, .tpkx или .slpk), параметр Пакет кэша не активен.

  • При извлечении векторных пакетов, пакетов листов или пакетов слоев сцены версии 1.7 и более поздних, можно извлечь содержание либо в папку в файловой системе, либо в хранилище объектов, расположенное в облаке, например Amazon S3, хранилище BLOB-объектов Azure или Alibaba OSS. Эти ресурсы готовы к работе как слой листов или сцены, а выбранное вами местоположение должно быть зарегистрировано как хранилище данных, управляемое пользователем в ArcGIS Enterprise.

  • Вы можете создать файл подключения (.acs), используя инструмент Создать файл подключения к облачному хранилищу.

  • Более старые версии пакетов слоев сцены могут быть обновлены до последней версии с помощью инструмента Обновить слой сцены.

  • Примечание:

    При извлечении пакетов слоев сцен в хранилище объектов в облаке (.i3sREST) формат хранения кэша сцены не такой, как при извлечении в папку в файловой системе (.eslpk), и эти два формата не являются взаимозаменяемыми.

Параметры

ПодписьОписаниеТип данных
Входной пакет

Извлекаемый входной пакет.

File
Выходная папка
(Дополнительный)

Выходная папка, в которой будет находиться содержимое пакета.

Если указанная папка не существует, то она будет создана.

Folder
Пакет кэша
(Дополнительный)

Задает, будет ли копия пакета кэшироваться в вашем профиле.

При извлечении пакета выходные данные сначала распаковываются в ваш пользовательский профиль и к ним добавляется уникальный ID перед тем, как они будут скопированы в указанную в параметре Выходная папка директорию. При загрузке и извлечении последующих версий одного и того же пакета будет обновлено только это местоположение. При использовании этого параметра вам не нужно вручную создавать кэшированную версию пакета в вашем профиле пользователя. Этот параметр не активен, если входной пакет является пакетом векторных листов (.vtpk) или пакетом листов (.tpk и .tpkx).

  • Отмечено – копия пакета будет извлечена и сохранена в кэше в вашем профиле. Это значение по умолчанию
  • Не отмечено – копия пакета будет только извлечена в указанный выходной параметр, она не будет кэшироваться.
Boolean
Тип формата хранения
(Дополнительный)

Задает формат хранения извлеченного кеша. Этот параметр применим только в том случае, если входной пакет является пакетом векторных листов (.vtpk).

  • УплотнитьЛисты будут сгруппированы в файлы пакетов с использованием формата хранения Compact V2. Этот формат обеспечивает лучшую производительность в общих сетевых папках и каталогах облачных хранилищ. Это значение по умолчанию
  • ПолистныйКаждый лист будет сохранен как отдельный файл.
String
Создать готовый к обслуживанию набор данных кеша
(Дополнительный)

Указывает, будет ли для ArcGIS Enterprise создан готовый к обслуживанию формат. Этот параметр активен только если входной пакет является пакетом векторных листов (.vtpk) или пакетом листов (.tpkx).

  • Отмечено – будет создана структура папок с извлеченным кешем, которую можно использовать для создания слоя листов в ArcGIS Enterprise. Расширение файла папки обозначает содержимое, которое она хранит: .tiles (набор данных кэша) для пакетов слоев листов или .vtiles (набор данных векторного кэша) для пакетов векторных листов.
  • Не отмечено – будет создана структура папок с извлеченным содержимым пакета. Это значение по умолчанию
Boolean
Целевое облачное подключение
(Дополнительный)

Целевой файл .acs, в который будет извлекаться содержимое пакета. Этот параметр активен только если входной пакет является пакетом слоя сцены (.slpk), пакетом векторных листов (.vtpk) или пакетом листов (.tpkx).

Folder

arcpy.management.ExtractPackage(in_package, {output_folder}, {cache_package}, {storage_format_type}, {create_ready_to_serve_format}, {target_cloud_connection})
ИмяОписаниеТип данных
in_package

Извлекаемый входной пакет.

File
output_folder
(Дополнительный)

Выходная папка, в которой будет находиться содержимое пакета.

Если указанная папка не существует, то она будет создана.

Folder
cache_package
(Дополнительный)

Задает, будет ли копия пакета кэшироваться в вашем профиле.

При извлечении пакета выходные данные сначала распаковываются в ваш пользовательский профиль и перед тем, как они будут скопированы в указанную в параметре output_folder директорию, к ним добавляется уникальный ID. При загрузке и извлечении последующих версий одного и того же пакета будет обновлено только это местоположение. При использовании этого параметра вам не нужно вручную создавать кэшированную версию пакета в вашем профиле пользователя. Этот параметр не включен, если входной пакет является пакетом векторных листов (.vtpk) или пакетом листов (.tpk и .tpkx).

  • CACHEКопия пакета будет извлечена и сохранена в кэше в вашем профиле. Это значение по умолчанию
  • NO_CACHEКопия пакета будет только извлечена в указанный выходной параметр, она не будет кэшироваться.
Boolean
storage_format_type
(Дополнительный)

Задает формат хранения извлеченного кеша. Этот параметр применим только в том случае, если входной пакет является пакетом векторных листов (.vtpk).

  • COMPACTЛисты будут сгруппированы в файлы пакетов с использованием формата хранения Compact V2. Этот формат обеспечивает лучшую производительность в общих сетевых папках и каталогах облачных хранилищ. Это значение по умолчанию
  • EXPLODEDКаждый лист будет сохранен как отдельный файл.
String
create_ready_to_serve_format
(Дополнительный)

Указывает, будет ли для ArcGIS Enterprise создан готовый к обслуживанию формат. Этот параметр включен только если входной пакет является пакетом векторных листов (.vtpk) или пакетом листов (.tpkx).

  • READY_TO_SERVE_CACHE_DATASETБудет создана структура папок с извлеченным кешем, которую можно использовать для создания слоя листов в ArcGIS Enterprise. Расширение файла папки обозначает содержимое, которое она хранит: .tiles (набор данных кэша) для пакетов слоев листов или .vtiles (набор данных векторного кэша) для пакетов векторных листов.
  • EXTRACTED_PACKAGEБудет создана структура папок с извлеченным содержимым пакета. Это значение по умолчанию
Boolean
target_cloud_connection
(Дополнительный)

Целевой файл .acs, в который будет извлекаться содержимое пакета. Этот параметр активен только если входной пакет является пакетом слоя сцены (.slpk), пакетом векторных листов (.vtpk) или пакетом листов (.tpkx).

Folder

Пример кода

ExtractPackage, пример 1 (окно Python)

Следующее скрипт окна Python демонстрирует, как использовать функцию ExtractPackage для создания готовых к использованию наборов данных кеша, которые можно использовать в рабочих процессах публикации 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")
ExtractPackage, пример 2 (окно Python)

Следующий скрипт окна Python демонстрирует, как использовать функцию ExtractPackage для извлечения пакетов слоев сцены в хранилище объектов, которое можно использовать в рабочих процессах публикации ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\ChicagoBuildings.slpk", 
                                None, "CACHE", 
                                "COMPACT", "EXTRACTED_PACKAGE", 
                                r"C:\CloudConnections\AWS.acs")
ExtractPackage, пример 3 (окно Python)

В следующем скрипте окна Python показано, как использовать функцию ExtractPackage для извлечения пакетов слоев векторных листов в хранилище объектов, которое можно использовать в рабочих процессах публикации ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\London.vtpk", 
                                None, "CACHE", 
                                "COMPACT", "EXTRACTED_PACKAGE", 
                                r"C:\CloudConnections\AWS.acs")
ExtractPackage, пример 4 (автономный скрипт)

Найдите все пакеты геообработки в указанной папке и используйте функцию ExtractPackage для извлечения содержимого в указанную папку.

# 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.ExtractPackage_management(gpk, os.path.splitext(gpk)[0])

print("done")

Параметры среды

Особые случаи

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы