Résumé
Convertit le stockage d’un cache de service d’imagerie ou de carte entre le format éclaté et le format compact. L’outil convertit le format in situ, ce qui signifie qu’il ne fait pas de copie du format existant du cache. Il crée plutôt le nouveau format du cache dans le même dossier de cache et supprime l’ancien format.
Utilisation
Dans ArcGIS Enterprise, le paramètre Service d’entrée est une chaîne qui contient l’extrémité REST du service. Assurez-vous que votre portail ArcGIS Enterprise est le portail actif.
Sur une instance ArcGIS Server autonome, le paramètre Service d’entrée est une chaîne qui contient les informations relatives au serveur et au service. Pour construire la chaîne, ajoutez le chemin complet d’accès au fichier de connexion ArcGIS Server (.ags), avec des identifiants de connexion Publication ou Administration, au nom du service sur le serveur autonome, par exemple : "C:\path_to_the connection_file_of_standAloneServer\arcgis on MyServer.com_6443.ags\ServiceName.MapServer". Pour plus d’informations, reportez-vous à la rubrique Se connecter à un serveur SIG.
L’outil détecte le format de stockage actuel du service en entrée et définit en conséquence le format cible au format opposé. Vous pouvez indiquer le nombre d’instances de service à consacrer à la conversion du cache à l’aide du paramètre Nombre d’instances de service de mise en cache. La valeur par défaut -1 utilise toutes les instances d’outil de mise en cache de l’installation ArcGIS Enterprise. Définissez une valeur inférieure pour utiliser moins d’instances d’outil de mise en cache. Vous pouvez augmenter la valeur du paramètre Nombre maximum d’instances par machine du service System/CachingTools dans la fenêtre Éditeur de services, disponible via une connexion de niveau administrateur à ArcGIS Server. Assurez-vous que les machines serveur peuvent prendre en charge le nombre d’instances défini. Dans le cas d’une connexion à un serveur autonome, le nombre par défaut d’instances correspond à la valeur du paramètre Nombre maximal d’instances du service d’outil de mise en cache.
Syntaxe
arcpy.server.ConvertMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})
Paramètre | Explication | Type de données |
input_service | Service de carte ou d’imagerie dont le format du cache doit être converti. Cette chaîne contient les informations relatives au serveur et au service. Pour savoir comment construire cette chaîne, ouvrez ArcCatalog, sélectionnez le service dans l’arborescence du Catalogue et notez le texte dans la barre d’outils Emplacement. Ensuite, remplacez les barres obliques inverses par des barres obliques, par exemple comme suit : GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer. | Image Service; Map Server |
num_of_caching_service_instances (Facultatif) | Nombre total d'instances du service System/CachingTools qui seront utilisées pour exécuter cet outil. Vous pouvez augmenter le paramètre Nombre maximum d'instances par machine du service System/CachingTools dans la fenêtre Éditeur de services disponible via une connexion administrateur à ArcGIS Server. Assurez-vous que vos machines serveur peuvent prendre en charge le nombre d'instances sélectionné. | Long |
Sortie dérivée
Nom | Explication | Type de données |
out_job_url | L’URL en sortie. | String |
Exemple de code
Exemple d’utilisation de l’outil ConvertMapServerCacheStorageFormat
Convertit le format de stockage du cache d’un service.
# Name: ConvertMapServerCacheStorageFormat.py
# Description: The following stand-alone script demonstrates how to convert map
# server cache storage format to the alteranate storage format
# Requirements: os, sys, time, traceback modules
# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
# "sys.argv[]"
# Import system modules
import arcpy
from arcpy import env
import os, sys, time, string, datetime, traceback
# Set environment settings
env.workspace = "C:/data"
# Set local variables for mapservice properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
numOfCachingServiceInstances = "2"
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')
# One can leave the variable for storage format marked "COMPACT" to "" (default)
# Execute ConvertMapServerCacheFormat
try:
starttime = time.clock()
result = arcpy.ConvertMapServerCacheStorageFormat_server(inputService,
numOfCachingServiceInstances)
finishtime = time.clock()
elapsedtime = finishtime - starttime
#print messages to a file
while result.status < 4:
time.sleep(0.2)
resultValue = result.getMessages()
report.write ("completed " + str(resultValue))
print "Converted Map Server Cache Storage format for " + serviceName + " in "
str(elapsedtime) + " sec \n on" + arg2
except Exception, e:
# If an error occurred, print line number and error message
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 "
Environnements
Cet outil n'utilise pas d’environnement de géotraitement.
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui