Paket extrahieren (Data Management)

Zusammenfassung

Extrahiert den Inhalt eines Pakets in einen angegebenen Ordner. Der Ausgabeordner wird mit dem extrahierten Inhalt des Eingabepakets aktualisiert.

Verwendung

  • Folgende Pakettypen werden unterstützt:

    • Geoverarbeitungspakete (.gpk und .gpkx)
    • Layer-Pakete (.lpk und .lpkx)
    • Locator-Pakete (.gcpk)
    • Kartenpakete (.mpk und .mpkx)
    • Mobile Kartenpakete (.mmpk)
    • Projektpakete und Projektvorlagen (.ppkx und .aptx)
    • Szenen-Layer-Paket (.slpk)
    • Kachelpakete (.tpk und .tpkx)
    • Vektor-Kachelpakete (.vtpk)

  • Bei dem Ausgabeordner kann es sich um einen neuen oder einen vorhandenen Ordner handeln. Beim Extrahieren in einen vorhandenen Ordner wird der Paketinhalt an die vorhandenen Dateien und Ordner angehängt. Wenn der Ausgabeordner den extrahierten Inhalt des Pakets enthält, wird der vorhandene Inhalt überschrieben.

  • Die angehängten Dateien von Paketen mit Anlagen werden in den Unterordner commondata\userdata\ des Ausgabeordners entpackt. In der Regel sind die in einem Paket enthaltenen Dateien unterstützende Dateien wie eine .pdf-Datei, eine .docx-Datei oder ein Bild. Navigieren Sie im Microsoft File Explorer zu dem extrahierten Verzeichnis, um diese Dateien zu öffnen.

  • Beim Extrahieren von Vektorkachelpaketen (.vtpk) wird der Paketinhalt in den Ausgabeordner extrahiert. Das Cache-Speicherformat kann mit dem Parameter Speicherformattyp von "Compact" (.bundle-Dateien) in "Exploded" (.pbf-Dateien) konvertiert werden. Sie können die extrahierten .pbf-Dateien in anderen Client-Anwendungen wie Mapbox verwenden.

    Hinweis:

    Je nach Ausdehnung der Daten, Detaillierungsebene des Pakets und Hardware-Konfiguration werden Milliarden von Kacheln extrahiert, sodass die Extraktion eines Flatcache möglicherweise viel Zeit in Anspruch.

  • Beim Extrahieren von Vektor-, Kachel- oder Szenen-Layer-Paketen (.vtpk, .tpk, .tpkx oder .slpk) ist der Parameter Paket cachen nicht aktiv.

  • Beim Extrahieren von Vektor-, Kachel- oder Szenen-Layer-Paketen der Version 1.7 und höher können Sie den Inhalt des Pakets in einen Ordner im Dateisystem oder in einen Objektspeicher in der Cloud, z. B. Amazon S3, Azure-BLOB-Speicher oder Alibaba OSS, extrahieren. Dieser Inhalt kann als Kachel- oder Szenen-Layer dienen, und der von Ihnen ausgewählte Speicherort muss als ein benutzerverwalteter Data Store in ArcGIS Enterprise registriert sein.

  • Sie können eine Verbindungsdatei erstellen (.acs), indem Sie das Werkzeug Verbindungsdatei für Cloud-Speicher erstellen verwenden.

  • Bei älteren Versionen von Szenen-Layer-Paketen kann mithilfe des Werkzeugs Szenen-Layer-Upgrade durchführen ein Upgrade auf die neueste Version durchgeführt werden.

  • Hinweis:

    Beim Extrahieren von Szenen-Layer-Paketen in einen Objektspeicher in der Cloud (.i3sREST) ist zu beachten, dass das Speicherformat des Szenen-Cache nicht dem Format bei der Extraktion als Ordner im Dateisystem (.eslpk) entspricht. Die beiden Formate sind nicht austauschbar.

Parameter

BeschriftungErläuterungDatentyp
Eingabepaket

Das Eingabepaket, das extrahiert wird.

File
Ausgabeordner
(optional)

Der Ausgabeordner, in den der Inhalt des Pakets extrahiert wird.

Wenn der angegebene Ordner nicht vorhanden ist, wird ein Ordner erstellt.

Folder
Paket cachen
(optional)

Gibt an, ob eine Kopie des Pakets in Ihrem Profil gecacht wird.

Beim Extrahieren eines Pakets wird die Ausgabe zuerst in Ihr Benutzerprofil extrahiert und mit einer eindeutigen ID versehen, bevor in dem Verzeichnis, das im Parameter Ausgabeordner angegeben ist, eine Kopie erstellt wird. Beim Herunterladen und Extrahieren nachfolgender Versionen desselben Pakets erfolgt eine Aktualisierung nur an diesem Speicherort. Wenn Sie diesen Parameter verwenden, müssen Sie die gecachte Version des Pakets in Ihrem Benutzerprofil nicht manuell erstellen. Dieser Parameter ist nicht aktiv, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) oder ein Kachelpaket (.tpk und .tpkx) ist.

  • Aktiviert: Eine Kopie des Pakets wird extrahiert und in Ihrem Profil gecacht. Dies ist die Standardeinstellung.
  • Deaktiviert: Eine Kopie des Pakets wird nur an den angegebenen Ausgabeparameter extrahiert. Es wird nicht gecacht.
Boolean
Speicherformattyp
(optional)

Gibt das Speicherformat an, das für den extrahierten Cache verwendet wird. Dieser Parameter ist nur anwendbar, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) ist.

  • CompactDie Kacheln werden in Paketdateien im Compact V2-Speicherformat gespeichert. Dieses Format bietet eine bessere Performance bei Netzwerkfreigaben und Cloud-Speicher-Verzeichnissen. Dies ist die Standardeinstellung.
  • ExplodedJede Kachel wird als einzelne Datei gespeichert.
String
Einsatzbereites Cache-Dataset erstellen
(optional)

Gibt an, ob ein einsatzbereites Format für ArcGIS Enterprise erstellt wird. Dieser Parameter ist nur aktiv, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) oder ein Kachelpaket (.tpkx) ist.

  • Aktiviert: Eine Ordnerstruktur mit einem extrahierten Cache, mit dem in ArcGIS Enterprise ein Kachel-Layer erstellt werden kann, wird erstellt. Die Dateierweiterung des Ordners gibt seinen Inhalt an: .tiles (Cache-Dataset) für Kachel-Layer-Pakete oder .vtiles (Vektor-Cache-Dataset) für Vektorkachelpakete.
  • Deaktiviert: Eine Ordnerstruktur mit extrahiertem Paketinhalt wird erstellt. Dies ist die Standardeinstellung.
Boolean
Ziel-Cloud-Verbindung
(optional)

Die .acs-Zieldatei, in die der Paketinhalt extrahiert wird. Dieser Parameter ist nur aktiviert, wenn das Eingabepaket ein Szenen-Layer-Paket (.slpk), ein Vektorkachelpaket (.vtpk) oder ein Kachelpaket (.tpkx) ist.

Folder

arcpy.management.ExtractPackage(in_package, {output_folder}, {cache_package}, {storage_format_type}, {create_ready_to_serve_format}, {target_cloud_connection})
NameErläuterungDatentyp
in_package

Das Eingabepaket, das extrahiert wird.

File
output_folder
(optional)

Der Ausgabeordner, in den der Inhalt des Pakets extrahiert wird.

Wenn der angegebene Ordner nicht vorhanden ist, wird ein Ordner erstellt.

Folder
cache_package
(optional)

Gibt an, ob eine Kopie des Pakets in Ihrem Profil gecacht wird.

Beim Extrahieren eines Pakets wird die Ausgabe zuerst in Ihr Benutzerprofil extrahiert und mit einer eindeutigen ID versehen, bevor in dem Verzeichnis, das im Parameter output_folder angegeben ist, eine Kopie erstellt wird. Beim Herunterladen und Extrahieren nachfolgender Versionen desselben Pakets erfolgt eine Aktualisierung nur an diesem Speicherort. Wenn Sie diesen Parameter verwenden, müssen Sie die gecachte Version des Pakets in Ihrem Benutzerprofil nicht manuell erstellen. Dieser Parameter ist nicht aktiviert, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) oder ein Kachelpaket (.tpk und .tpkx) ist.

  • CACHEEine Kopie des Pakets wird extrahiert und in Ihrem Profil gecacht. Dies ist die Standardeinstellung.
  • NO_CACHEEine Kopie des Pakets wird nur an den angegebenen Ausgabeparameter extrahiert. Es wird nicht gecacht.
Boolean
storage_format_type
(optional)

Gibt das Speicherformat an, das für den extrahierten Cache verwendet wird. Dieser Parameter ist nur anwendbar, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) ist.

  • COMPACTDie Kacheln werden in Paketdateien im Compact V2-Speicherformat gespeichert. Dieses Format bietet eine bessere Performance bei Netzwerkfreigaben und Cloud-Speicher-Verzeichnissen. Dies ist die Standardeinstellung.
  • EXPLODEDJede Kachel wird als einzelne Datei gespeichert.
String
create_ready_to_serve_format
(optional)

Gibt an, ob ein einsatzbereites Format für ArcGIS Enterprise erstellt wird. Dieser Parameter ist nur aktiviert, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) oder ein Kachelpaket (.tpkx) ist.

  • READY_TO_SERVE_CACHE_DATASETEine Ordnerstruktur mit einem extrahierten Cache, mit dem in ArcGIS Enterprise ein Kachel-Layer erstellt werden kann, wird erstellt. Die Dateierweiterung des Ordners gibt seinen Inhalt an: .tiles (Cache-Dataset) für Kachel-Layer-Pakete oder .vtiles (Vektor-Cache-Dataset) für Vektorkachelpakete.
  • EXTRACTED_PACKAGEEine Ordnerstruktur mit extrahiertem Paketinhalt wird erstellt. Dies ist die Standardeinstellung.
Boolean
target_cloud_connection
(optional)

Die .acs-Zieldatei, in die der Paketinhalt extrahiert wird. Dieser Parameter ist nur aktiviert, wenn das Eingabepaket ein Szenen-Layer-Paket (.slpk), ein Vektorkachelpaket (.vtpk) oder ein Kachelpaket (.tpkx) ist.

Folder

Codebeispiel

ExtractPackage – Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie mit der Funktion ExtractPackage einsatzbereite Cache-Datasets generiert werden, die dann für Veröffentlichungs-Workflows in ArcGIS Enterprise verwendet werden können.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\MyVectorPackage.vtpk", 
                                r"C:\Data\packages\Extracted", "CACHE", 
                                "COMPACT", "READY_TO_SERVE_CACHE_DATASET")
ExtractPackage – Beispiel 2 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie mit der Funktion ExtractPackage Szenen-Layer-Pakete in einen Objektspeicher extrahiert werden, die dann für Veröffentlichungs-Workflows in ArcGIS Enterprise verwendet werden können.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\ChicagoBuildings.slpk", 
                                None, "CACHE", 
                                "COMPACT", "EXTRACTED_PACKAGE", 
                                r"C:\CloudConnections\AWS.acs")
ExtractPackage – Beispiel 3 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie mit der Funktion ExtractPackage Vektorkachel-Layer-Pakete in einen Objektspeicher extrahiert werden, die dann für Veröffentlichungs-Workflows in ArcGIS Enterprise verwendet werden können.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\London.vtpk", 
                                None, "CACHE", 
                                "COMPACT", "EXTRACTED_PACKAGE", 
                                r"C:\CloudConnections\AWS.acs")
ExtractPackage – Beispiel 4 (eigenständiges Skript)

Alle Geoverarbeitungspakete in einem angegebenen Ordner werden gesucht, und die Funktion ExtractPackage wird verwendet, um den Inhalt in den angegebenen Ordner zu extrahieren.

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

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen