管理地图服务器缓存状态 (服务器)—ArcMap

描述
使用方法
语法
代码示例
环境
许可信息

描述

管理服务器所保存的与地图或影像服务缓存中的构建切片有关的内部数据。

使用方法

此工具可移除或重建在 ArcMap 或 ArcGIS Server 管理器中报告的缓存完成状态信息。
手动将切片复制到缓存目录或按需构建切片后，您可使用此工具重建缓存状态。
只能使用此工具构建先前版本的 ArcGIS Server 或 Portal for ArcGIS 所创建的缓存的状态。
您也可以选择使用此工具只针对自定义感兴趣区域及比例级别创建状态报告，而无需为整个缓存创建状态。通过将管理模式参数（Python 中的 manage_mode）设置为 REPORT_BUNDLE_STATUS 可实现此操作。该报告存储在一个名为 Status.gdb 的新文件地理数据库中，具体位置是在名为 TaskStatus 的要素类中。
请注意，缓存目录同时包含一个与整个缓存相关的 Status.gdb，并在其他管理模式选项用于此工具时更新。在此位置无法替换自定义 Status.gdb。

语法

arcpy.server.ManageMapServerCacheStatus(input_service, manage_mode, {scales}, {num_of_caching_service_instances}, {report_folder}, {area_of_interest}, {report_extent})

参数	说明	数据类型
input_service	将修改其状态的地图或影像服务。这是一个包含服务器和服务器信息的字符串。要查看构建此字符串的方法，请打开 ArcCatalog，选择目录树中的服务，并注意位置工具栏中的文本。将反斜线改为正斜线，例如 GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer。	Image Service; MapServer
manage_mode	DELETE_CACHE_STATUS —删除服务器所使用的状态信息。 REBUILD_CACHE_STATUS —删除服务器所使用的状态信息，然后重新构建该状态信息。 REPORT_BUNDLE_STATUS —在一个名为 Status.gdb 的新文件地理数据库中创建状态信息，此文件地理数据库位于在输出文件夹参数指定的文件夹中。该选项用于为特定感兴趣区域或比例设置创建自定义状态报告。	String
scales [scales,...] （可选）	将修改其状态的比例级别。此参数仅适用于使用 REPORT_BUNDLE_STATUS 选项为 manage_mode 参数构建自定义状态的情况。	Double
num_of_caching_service_instances （可选）	专用于运行该工具的 System/CachingTools 服务实例的总数。您可以通过 ArcGIS Server 的管理连接，使用服务编辑器窗口，增加 System/CachingTools 服务的每台计算机的最大实例数设置。确保您的服务器计算机可以支持所选数量的实例。默认情况下，此工具使用三个实例（如果允许使用三个）。在此工具中使用较大数量的实例可能会导致操作速度减慢。	Long
report_folder （可选）	Status.gdb 的输出文件夹。此参数仅适用于使用 REPORT_BUNDLE_STATUS 选项构建自定义状态的情况。	Folder
area_of_interest （可选）	感兴趣区(面)决定着状态报告将覆盖的地理形态。此参数仅适用于使用 REPORT_BUNDLE_STATUS 选项构建自定义状态的情况。	Feature Set
report_extent （可选）	定义构建状态区域的矩形范围。此参数仅适用于使用 REPORT_BUNDLE_STATUS 选项构建自定义状态的情况。请注意，area_of_interest 参数可指定非矩形感兴趣区。	Extent

派生输出

名称	说明	数据类型
output_folder	输出服务 URL。	字符串

代码示例

ManageMapServerCacheStatus 示例（独立脚本）

删除缓存的状态信息。

# Name: ManageMapServerCacheStatus.py
# Description: The following stand-alone script demonstrates how to delete 
# status of cache using ManageMapServerCachStatus tool  

# Requirements: os, sys, time and 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, datetime, traceback, string

# Set environment settings
env.workspace = "C:/data"

# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapService"
inputService = connectionFile + "\\" + server + "\\" + serviceName
scales = ""
manageMode = "DELETE_CACHE_STATUS"
numOfCachingServiceInstances = "2"
outputFolder = ""
areaOfInterest = ""
reportExtents = ""


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

# use "scales[0]","scales[-1]","scales[0:3]"

try:
    starttime = time.clock()
    result = arcpy.ManageMapServerCacheStatus_server(inputService, 
                                                     manageMode, scales,
                                                     numOfCachingServiceInstances,
                                                     outputFolder,
                                                     areaOfInterest, 
                                                     reportExtents)                                           
    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 "Reported the Bundle status for scale =" + str(scales[-1]) + "of " +\
    serviceName + "at " + outputFolder + "\n using specified feature class " +\
    areaOfInterest + " 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 3 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)

report.close()

环境

此工具不使用任何地理处理环境。

许可信息

Basic: 是
Standard: 是
Advanced: 是