Administrar teselas de caché de servidor de mapas (Servidor)

Resumen

Crea y actualiza teselas en una caché de capa de teselas web existente (en ArcGIS Enterprise o ArcGIS Online), capas de imágenes de mapa web en ArcGIS Enterprise y servicios de imágenes o mapas en caché en un servidor independiente. Esta herramienta se utiliza para crear teselas nuevas, reemplazar teselas faltantes, sobrescribir teselas desactualizadas o eliminar teselas.

Uso

  • Esta herramienta puede tardar demasiado en ejecutarse para caché que cubren una extensión geográfica grande o escalas de mapas muy grandes. Si la herramienta se cancela, la creación de teselas se detiene, pero las teselas existentes no se eliminan. Esto significa que puede cancelar la herramienta si no tiene tiempo suficiente y volver a ejecutarla más tarde en la misma caché estableciendo el parámetro Modo Actualizar para Volver a crear teselas vacías (update_mode = "RECREATE_EMPTY_TILES" en Python).

Parámetros

EtiquetaExplicaciónTipo de datos
Servicio de entrada

La capa de teselas web, la capa de imágenes de mapas web o la capa de imágenes de mapas cuyas teselas de caché se actualizarán.

Image Service; Map Server
Escalas

Lista de niveles de escala a los cuales se crearán las teselas.

De forma predeterminada, las escalas enumeradas en el cuadro de diálogo de la herramienta se encuentran entre el mínimo y máximo de escalas en caché para el servicio. No puede cambiar el rango de escala de la caché del servicio en ArcGIS Pro.

Double
Modo Actualizar

Especifica el modo que se utilizará para actualizar la caché.

  • Volver a crear teselas vacíasSolo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios. Esta opción no está disponible para capas de teselas web publicadas en ArcGIS Online.
  • Volver a crear todas las teselasLas teselas existentes se sustituirán y se agregarán teselas nuevas si la extensión ha cambiado.
  • Eliminar teselasLas teselas se eliminarán de la caché. La estructura de la carpeta de caché no se eliminará.
String
Número de instancias de almacenamiento de servicios en caché
(Opcional)

La cantidad total de instancias del servicioSystem/CachingTools que desea dedicar a ejecutar esta herramienta. Si se usa el valor predeterminado de -1, se usarán todas las instancias de la herramienta de almacenamiento en caché de la configuración de ArcGIS Enterprise. Utilice un valor más bajo para utilizar menos instancias de la herramienta de almacenamiento en caché.

Puede aumentar el ajuste Cantidad máxima de instancias por equipo del servicio System/CachingTools utilizando la ventana Editor del servicio, que está disponible a través de una conexión administrativa a ArcGIS Server. Asegúrese de que los equipos servidores sean compatibles con el número de instancias elegido.

Cuando se conecta a un servidor independiente, el número predeterminado de instancias es igual al valor de la configuración Número máximo de instancias del servicio de la herramienta de almacenamiento en caché.

Long
Área de interés
(Opcional)

Un área de interés que restringirá dónde se van a crear o eliminar las teselas. Este parámetro es útil para administrar teselas para áreas con formas irregulares. También es útil cuando se almacenan previamente en caché algunas áreas y se dejan sin almacenar las áreas menos visitadas.

Si no proporciona un valor para este parámetro, el valor predeterminado es utilizar la extensión completa del mapa.

Feature Set
Actualizar extensión
(Opcional)

Una extensión rectangular usada para crear o eliminar teselas, según el valor del parámetro Modo actualizar. Si se especifican los valores de los parámetros Actualizar extensión y Área de interés, se utilizará el valor Área de interés.

  • Valor predeterminado: la extensión se basará en la extensión máxima de todas las entradas participantes. Esta es la opción predeterminada.
  • Extensión de visualización actual: la extensión es igual al marco de datos o visualización actual. La opción no está disponible cuando no hay ningún mapa activo.
  • Como se especifica en la parte inferior: la extensión se basará en los valores mínimo y máximo de extensión que se especifiquen.
  • Examinar: la extensión se basará en un dataset existente.
Extent
Esperar que se complete el trabajo
(Opcional)

Especifica si la herramienta continuará ejecutándose mientras se ejecuta el trabajo de caché en ArcGIS Online o Portal for ArcGIS.

  • Activado: La herramienta seguirá ejecutándose mientras el trabajo de la caché se ejecute en Portal for ArcGIS o ArcGIS Online. Con esta opción, puede solicitar informes de progreso detallados en cualquier momento y ver los mensajes de geoprocesamiento cuando aparecen. Esta es la opción predeterminada.
  • Desactivado: Se enviará un trabajo al portal, de modo que podrá realizar otras tareas de geoprocesamiento en ArcGIS Pro o cerrarlo. Utilice esta opción cuando esté creando una caché automáticamente en el momento de publicar el servicio. También puede configurar esta opción en cualquier otra caché que cree.
Boolean
URL del portal
(Opcional)

La URL del portal.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Dirección URL del servicio de mapas de salida

La URL de salida.

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})
NombreExplicaciónTipo de datos
input_service

La capa de teselas web, la capa de imágenes de mapas web o la capa de imágenes de mapas cuyas teselas de caché se actualizarán.

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

Lista de niveles de escala a los cuales se crearán las teselas.

Double
update_mode

Especifica el modo que se utilizará para actualizar la caché.

  • RECREATE_EMPTY_TILESSolo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios. Esta opción no está disponible para capas de teselas web publicadas en ArcGIS Online.
  • RECREATE_ALL_TILESLas teselas existentes se sustituirán y se agregarán teselas nuevas si la extensión ha cambiado.
  • DELETE_TILESLas teselas se eliminarán de la caché. La estructura de la carpeta de caché no se eliminará.
String
num_of_caching_service_instances
(Opcional)

La cantidad total de instancias del servicioSystem/CachingTools que desea dedicar a ejecutar esta herramienta. Si se usa el valor predeterminado de -1, se usarán todas las instancias de la herramienta de almacenamiento en caché de la configuración de ArcGIS Enterprise. Utilice un valor más bajo para utilizar menos instancias de la herramienta de almacenamiento en caché.

Puede aumentar el ajuste Cantidad máxima de instancias por equipo del servicio System/CachingTools utilizando la ventana Editor del servicio, que está disponible a través de una conexión administrativa a ArcGIS Server. Asegúrese de que los equipos servidores sean compatibles con el número de instancias elegido.

Cuando se conecta a un servidor independiente, el número predeterminado de instancias es igual al valor de la configuración Número máximo de instancias del servicio de la herramienta de almacenamiento en caché.

Long
area_of_interest
(Opcional)

Un área de interés que restringirá dónde se van a crear o eliminar las teselas. Este parámetro es útil para administrar teselas para áreas con formas irregulares. También es útil cuando se almacenan previamente en caché algunas áreas y se dejan sin almacenar las áreas menos visitadas.

Si no proporciona un valor para este parámetro, el valor predeterminado es utilizar la extensión completa del mapa.

Feature Set
update_extent
(Opcional)

Una extensión rectangular usada para crear o eliminar teselas, según el valor del parámetro update_mode. Si se especifican los valores de los parámetros update_extent y area_of_interest, se utilizará el valor area_of_interest.

  • MAXOF: se utilizará la extensión máxima de todas las entradas.
  • MINOF: se utilizará el área mínima en común de todas las entradas.
  • DISPLAY: la extensión es igual a la visualización actual.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent
wait_for_job_completion
(Opcional)

Especifica si la herramienta continuará ejecutándose mientras se ejecuta el trabajo de caché en ArcGIS Online o Portal for ArcGIS.

  • WAITLa herramienta seguirá ejecutándose mientras el trabajo de la caché se ejecute en Portal for ArcGIS o ArcGIS Online. Con esta opción, puede solicitar informes de progreso detallados en cualquier momento y ver los mensajes de geoprocesamiento cuando aparecen. Esta es la opción predeterminada. Se recomienda que utilice esta opción en las secuencias de comandos de Python.
  • DO_NOT_WAITSe enviará un trabajo al servidor, de modo que podrá realizar otras tareas de geoprocesamiento. Utilice esta opción cuando esté creando una caché automáticamente en el momento de publicar el servicio. También puede configurar esta opción en cualquier otra caché que cree.
Boolean
portal_url
(Opcional)

La URL del portal.

String

Salida derivada

NombreExplicaciónTipo de datos
out_job_url

La URL de salida.

String

Muestra de código

Ejemplo de ManageMapServerCacheTiles (script independiente)

A continuación, se muestra cómo volver a crear todas las teselas de caché para un mapa o servicio de imágenes utilizando un área de interés.

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

Entornos

Casos especiales

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados