Cache-Kacheln für Kartenserver verwalten (Server)

Zusammenfassung

Erstellt und aktualisiert in einem vorhandenen Web-Kachel-Layer-Cache (in ArcGIS Enterprise oder ArcGIS Online), in Webkartenbild-Layern in ArcGIS Enterprise und in gecachten Karten- oder Image-Services auf einem eigenständigen Server Kacheln. Dieses Werkzeug wird verwendet, um neue Kacheln zu erstellen, fehlende Kacheln zu ersetzen, veraltete Kacheln zu überschreiben und Kacheln zu löschen.

Verwendung

  • Die Ausführung dieses Werkzeugs kann für Caches, die eine große geographische Ausdehnung oder sehr große Kartenmaßstäbe abdecken, ggf. einen langen Zeitraum in Anspruch nehmen. Wenn das Werkzeug abgebrochen wird, wird die Kachelerstellung beendet, aber die vorhandenen Kacheln werden nicht gelöscht. Dies bedeutet, dass Sie das Werkzeug aus Zeitgründen abbrechen können. Später können Sie es dann für denselben Cache erneut ausführen, indem Sie den Parameter Aktualisierungsmodus auf Fehlende Kacheln erstellen (update_mode = "RECREATE_EMPTY_TILES" in Python) festlegen.

Parameter

BeschriftungErläuterungDatentyp
Eingabeservice

Der Web-Kachel-Layer, Webkarten-Bilddaten-Layer oder Kartenbild-Layer, dessen Cache-Kacheln aktualisiert werden.

Image Service; Map Server
Maßstäbe

Eine Liste mit Maßstabsebenen, auf denen Kacheln erstellt werden.

Standardmäßig liegen die im Werkzeugdialogfeld aufgelisteten Maßstäbe zwischen dem Minimum und dem Maximum der für den Service gecachten Maßstäbe. Der Cache-Maßstabsbereich des Service kann in ArcGIS Pro nicht geändert werden.

Double
Aktualisierungsmodus

Legt den Modus fest, der zum Aktualisieren der Kacheln verwendet wird.

  • Fehlende Kacheln erstellenEs werden nur Kacheln erstellt, die leer sind. Vorhandene Kacheln werden unverändert beibehalten. Diese Option ist für Web-Kachel-Layer, die in ArcGIS Online veröffentlicht werden, nicht verfügbar.
  • Alle Kacheln neu erstellenVorhandene Kacheln werden ersetzt und neue Kacheln werden hinzugefügt, wenn die Ausdehnung geändert wurde.
  • Kacheln löschenKacheln werden aus dem Cache gelöscht. Die Cache-Ordnerstruktur wird nicht gelöscht.
String
Anzahl der Caching-Service-Instanzen
(optional)

Die Gesamtzahl der Instanzen des Service System/CachingTools, die zum Ausführen dieses Werkzeugs reserviert sind. Wenn der Standardwert -1 verwendet wird, werden alle Caching-Werkzeuginstanzen des ArcGIS Enterprise-Setups verwendet. Geben Sie einen niedrigeren Wert an, um weniger Caching-Werkzeuginstanzen zu verwenden.

Sie können die Einstellung Maximale Anzahl von Instanzen pro Computer des Service System/CachingTools mithilfe des Fensters Service-Editor erhöhen, das über eine administrative Verbindung zu ArcGIS Server verfügbar ist. Stellen Sie sicher, dass die Servercomputer die ausgewählte Anzahl von Instanzen unterstützen können.

Bei einer Verbindung mit einem eigenständigen Server entspricht die standardmäßige Anzahl an Instanzen dem Wert der Einstellung Maximale Anzahl der Instanzen im Caching-Werkzeug-Service.

Long
Interessenbereich
(optional)

Ein Interessenbereich, der einschränkt, wo Kacheln erstellt oder gelöscht werden. Dieser Parameter ist bei der Verwaltung von unregelmäßig geformten Bereichen hilfreich. Zudem ist er für das Vorab-Caching von bestimmten Bereichen nützlich, wobei weniger frequentierte Bereiche ungecacht gelassen werden.

Wenn Sie keinen Wert für diesen Parameter angeben, wird als Standardwert die volle Ausdehnung der Karte verwendet.

Feature Set
Aktualisierungsausdehnung
(optional)

Eine rechteckige Ausdehnung, bei der Kacheln je nach Wert des Parameters Aktualisierungsmodus erstellt oder gelöscht werden. Wenn der Parameter Aktualisierungsausdehnung als auch der Parameter Interessenbereich angegeben ist, wird der Wert für Interessenbereich verwendet.

  • Default: Die Ausdehnung basiert auf der maximalen Ausdehnung aller beteiligten Layer. Dies ist die Standardeinstellung.
  • Aktuelle Anzeigeausdehnung: Die Ausdehnung entspricht dem Datenrahmen oder der sichtbaren Anzeige. Die Option ist nicht verfügbar, wenn keine aktive Karte vorhanden ist.
  • Wie unten angegeben: Die Ausdehnung basiert auf den angegebenen Minimal- und Maximalwerten der Ausdehnung.
  • Durchsuchen: Die Ausdehnung basiert auf einem vorhandenen Dataset.
Extent
Auf Auftragsabschluss warten
(optional)

Gibt an, ob das Werkzeug weiter ausgeführt wird, während der Cache-Auftrag in ArcGIS Online oder Portal for ArcGIS ausgeführt wird.

  • Aktiviert: Das Werkzeug wird weiterhin ausgeführt, während der Cache-Auftrag in Portal for ArcGIS oder ArcGIS Online ausgeführt wird. Mit dieser Option können Sie jederzeit detaillierte Fortschrittsberichte anfordern und die Geoverarbeitungs-Meldungen anzeigen, wenn sie auftreten. Dies ist die Standardeinstellung.
  • Deaktiviert: Ein Auftrag wird an das Portal übermittelt, wo Sie in ArcGIS Pro weitere Geoverarbeitungs-Tasks ausführen oder ArcGIS Pro schließen können. Nutzen Sie diese Option, wenn Sie bei der Veröffentlichung des Service automatisch einen Cache erstellen. Sie können diese Option auch für jeden anderen Cache, den Sie erstellen, festlegen.
Boolean
Portal-URL
(optional)

Die URL des Portals.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Kartenservice-URL der Ausgabe

Die Ausgabe-URL.

String

arcpy.server.ManageMapServerCacheTiles(input_service, scales, update_mode, {num_of_caching_service_instances}, {area_of_interest}, {update_extent}, {wait_for_job_completion}, {portal_url})
NameErläuterungDatentyp
input_service

Der Web-Kachel-Layer, Webkarten-Bilddaten-Layer oder Kartenbild-Layer, dessen Cache-Kacheln aktualisiert werden.

Image Service; Map Server
scales
[scales,...]

Eine Liste mit Maßstabsebenen, auf denen Kacheln erstellt werden.

Double
update_mode

Legt den Modus fest, der zum Aktualisieren der Kacheln verwendet wird.

  • RECREATE_EMPTY_TILESEs werden nur Kacheln erstellt, die leer sind. Vorhandene Kacheln werden unverändert beibehalten. Diese Option ist für Web-Kachel-Layer, die in ArcGIS Online veröffentlicht werden, nicht verfügbar.
  • RECREATE_ALL_TILESVorhandene Kacheln werden ersetzt und neue Kacheln werden hinzugefügt, wenn die Ausdehnung geändert wurde.
  • DELETE_TILESKacheln werden aus dem Cache gelöscht. Die Cache-Ordnerstruktur wird nicht gelöscht.
String
num_of_caching_service_instances
(optional)

Die Gesamtzahl der Instanzen des Service System/CachingTools, die zum Ausführen dieses Werkzeugs reserviert sind. Wenn der Standardwert -1 verwendet wird, werden alle Caching-Werkzeuginstanzen des ArcGIS Enterprise-Setups verwendet. Geben Sie einen niedrigeren Wert an, um weniger Caching-Werkzeuginstanzen zu verwenden.

Sie können die Einstellung Maximale Anzahl von Instanzen pro Computer des Service System/CachingTools mithilfe des Fensters Service-Editor erhöhen, das über eine administrative Verbindung zu ArcGIS Server verfügbar ist. Stellen Sie sicher, dass die Servercomputer die ausgewählte Anzahl von Instanzen unterstützen können.

Bei einer Verbindung mit einem eigenständigen Server entspricht die standardmäßige Anzahl an Instanzen dem Wert der Einstellung Maximale Anzahl der Instanzen im Caching-Werkzeug-Service.

Long
area_of_interest
(optional)

Ein Interessenbereich, der einschränkt, wo Kacheln erstellt oder gelöscht werden. Dieser Parameter ist bei der Verwaltung von unregelmäßig geformten Bereichen hilfreich. Zudem ist er für das Vorab-Caching von bestimmten Bereichen nützlich, wobei weniger frequentierte Bereiche ungecacht gelassen werden.

Wenn Sie keinen Wert für diesen Parameter angeben, wird als Standardwert die volle Ausdehnung der Karte verwendet.

Feature Set
update_extent
(optional)

Eine rechteckige Ausdehnung, bei der Kacheln je nach Wert des Parameters update_mode erstellt oder gelöscht werden. Wenn der Parameter update_extent als auch der Parameter area_of_interest angegeben ist, wird der Wert für area_of_interest verwendet.

  • MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet.
  • MINOF: Die kleinste gemeinsame Fläche aller Eingaben wird verwendet.
  • DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige.
  • Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet.
  • Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet.
  • Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.
Extent
wait_for_job_completion
(optional)

Gibt an, ob das Werkzeug weiter ausgeführt wird, während der Cache-Auftrag in ArcGIS Online oder Portal for ArcGIS ausgeführt wird.

  • WAITDas Werkzeug wird weiterhin ausgeführt, während der Cache-Auftrag in Portal for ArcGIS oder ArcGIS Online ausgeführt wird. Mit dieser Option können Sie jederzeit detaillierte Fortschrittsberichte anfordern und die Geoverarbeitungs-Meldungen anzeigen, wenn sie auftreten. Dies ist die Standardeinstellung. Diese Option sollten Sie in Python-Skripts verwenden.
  • DO_NOT_WAITEin Auftrag wird an den Server übermittelt, sodass Sie weitere Geoverarbeitungs-Tasks ausführen können. Nutzen Sie diese Option, wenn Sie bei der Veröffentlichung des Service automatisch einen Cache erstellen. Sie können diese Option auch für jeden anderen Cache, den Sie erstellen, festlegen.
Boolean
portal_url
(optional)

Die URL des Portals.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_job_url

Die Ausgabe-URL.

String

Codebeispiel

ManageMapServerCacheTiles – Beispiel (eigenständiges Skript)

Im Folgenden wird veranschaulicht, wie mithilfe eines Interessenbereichs alle Cache-Kacheln für einen Karten- oder Image-Service neu erstellt werden.

# Name: ManageMapServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to Recreate all 
#               cache tiles for for a map or image service using an area of interest.
#               This tool works for weblayers published to ArcGIS Enterprise and ArcGIS Online.
#               and for map and image services on a stand alone ArcGIS Server

# Example: This sample script updates map cache tiles.

import arcpy
import os

# Sign in to portal
myPortal= "https://www.myArcGISEnterprise.com/webadaptor"
arcpy.SignInToPortal(myPortal, "MyUserName", "MyPassword")
serviceName= "MyCounty"
serviceType= "MapServer"
myPortalServiceURL = (myPortal + "/" + "rest/services" +"/" + serviceName + "/" + serviceType)


# Stand alone ArcGIS Server
target_server_connection = r"C:\Project\gisserver.ags.esri.com (publisher).ags"
serviceName= "MyCounty"
serviceType= "MapServer"
myServerServiceURL= target_server_connection + "/" + serviceName + "." + serviceType


#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1


# List of input variables for map or image service 
scales = [500000,250000]
numOfCachingServiceInstances = 8
updateMode = "RECREATE_ALL_TILES"
areaOfInterest = "C:/data/shp/CaTxFlMaMin.shp"
waitForJobCompletion = "WAIT"
updateExtents = ""
portalURL =""

# Variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1

# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ManageMapServerCacheTiles(mytest, scales, updateMode,
                                                    numOfCachingServiceInstances, areaOfInterest,
                                                    updateExtents, waitForJobCompletion,
                                                    portalURL)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Created cache tiles for given schema successfully for " + serviceName )
    
except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()

print ("Completed update of cache tiles for " + serviceName)

Lizenzinformationen

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

Verwandte Themen