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

描述

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

使用方法

• 手动将切片复制到缓存目录或按需构建切片后，您可使用此工具重建缓存状态。

• 只能使用此工具构建先前版本的 ArcGIS Server 或 Portal for ArcGIS 所创建的缓存的状态。

• 您也可以选择使用此工具只针对自定义感兴趣区域及比例级别创建状态报告，而无需为整个缓存创建状态。通过将管理模式参数（Python 中的 manage_mode）设置为 REPORT_BUNDLE_STATUS 可实现此操作。该报告存储在一个名为 Status.gdb 的新文件地理数据库中，具体位置是在名为 TaskStatus 的要素类中。

  请注意，缓存目录同时包含一个与整个缓存相关的 Status.gdb，并在其他管理模式选项用于此工具时更新。在此位置无法替换自定义 Status.gdb。

语法

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

参数	说明	数据类型
input_service	将修改其缓存状态的地图影像图层。可以通过在门户中浏览至所需的服务来对其进行选择，也可以从目录窗格的门户选项卡拖放一个 web 切片图层来提供此参数。	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 （可选）	定义用于更新/生成切片的实例数。该参数的值将设置为无限 (-1)，且无法进行修改。	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 as 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(str(e))

report.close()

环境

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

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是