Speicherformat des Kartenserver-Cache konvertieren (Server)

Zusammenfassung

Konvertiert das Speicherformat eines Kartenbild-Layers oder eines Karten- bzw. Image-Service-Cache zwischen dem Format "Erweitert" und dem Format "CompactV2" konvertiert.

Vorsicht:

Das Werkzeug konvertiert das Format direkt am Speicherort, sodass keine Kopie des bestehenden Cache-Formats erstellt wird. Stattdessen wird das neue Format im selben Cache-Ordner erstellt, wobei das alte Format gelöscht wird. Erstellen Sie vor der Ausführung dieses Werkzeugs eine Sicherung des Cache, um ggf. das alte Format wiederherstellen zu können.

Verwendung

  • In ArcGIS Enterprise ist der Parameter Eingabeservice eine Zeichenfolge, die den REST-Endpunkt des Service enthält. Stellen Sie sicher, dass Ihr ArcGIS Enterprise-Portal das aktive Portal ist.

    Auf einer eigenständigen ArcGIS Server-Bereitstellung ist der Parameter Eingabeservice eine Zeichenfolge, die sowohl Server- als auch Service-Informationen enthält. Um die Zeichenfolge auf einem eigenständigen Server zu erstellen, fügen Sie dem Service-Namen den vollständigen Pfad zur ArcGIS Server-Verbindungsdatei (.ags) inklusive Publisher- oder Administrator-Anmeldeinformationen hinzu. Beispiel: "C:\path_to_the connection_file_of_standAloneServer\arcgis on MyServer.com_6443.ags\ServiceName.MapServer". Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einem GIS-Server.

  • Das aktuelle Speicherformat des Eingabeservice wird bestimmt, um so das Zielformat auf das jeweils andere Format festzulegen. Über den Parameter Anzahl der Caching-Service-Instanzen können Sie die Anzahl der Service-Instanzen angeben, die für die Cache-Konvertierung reserviert werden. Beim Standardwert -1 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.

Parameter

BeschriftungErläuterungDatentyp
Eingabeservice

Der Karten- oder Image-Service, dessen Cache-Format konvertiert wird. In ArcGIS Enterprise ist dies eine Zeichenfolge mit dem REST-Endpunkt des Kartenbild-Layers. Auf einer eigenständigen ArcGIS Server-Bereitstellung ist dies eine Zeichenfolge, die sowohl Server- als auch Service-Informationen enthält.

Image Service; Map Server
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

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Kartenservice-URL der Ausgabe

Die Ausgabe-URL.

String

arcpy.management.ConvertMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})
NameErläuterungDatentyp
input_service

Der Karten- oder Image-Service, dessen Cache-Format konvertiert wird. In ArcGIS Enterprise ist dies eine Zeichenfolge mit dem REST-Endpunkt des Kartenbild-Layers. Auf einer eigenständigen ArcGIS Server-Bereitstellung ist dies eine Zeichenfolge, die sowohl Server- als auch Service-Informationen enthält.

Image Service; Map Server
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

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_job_url

Die Ausgabe-URL.

String

Codebeispiel

ConvertMapServerCacheStorageFormat: Beispiel

Konvertieren des Speicherformats des Kartenserver-Cache in das alternative Speicherformat

# Name: ConvertMapServerCacheStorageFormat.py
# Description: The following stand-alone script demonstrates how to convert map
#               server cache storage format to the alteranate storage format for
#               a weblayers/map or image service based on
#               ArcGIS Enterprise or a stand alone ArcGIS Server

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:/results/report_%s.txt' % arg1

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

try:
    #result = arcpy.server.ConvertMapServerCacheStorageFormat(myPortalServiceURL, -1)
    result = arcpy.server.ConvertMapServerCacheStorageFormat(myServerServiceURL, -1)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))
    
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 ("Converted Map Server Cache Storage format for " + serviceName)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.