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

摘要

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

使用情况

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

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

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

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

参数

对话框

标注	说明	数据类型
输入服务	将修改其缓存状态的地图影像图层。 可以通过在门户中浏览至所需的服务来对其进行选择，也可以从目录窗格的门户选项卡拖放一个 web 切片图层来提供此参数。	Image Service; Map Server
管理模式	删除缓存状态—删除服务器所使用的状态信息。 重建缓存状态—删除服务器所使用的状态信息，然后重新构建该状态信息。 重建包状态—在一个名为 Status.gdb 的新文件地理数据库中创建状态信息，此文件地理数据库位于在输出文件夹参数指定的文件夹中。 该选项用于为特定感兴趣区域或比例设置创建自定义状态报告。	String
比例 (可选)	将修改其状态的比例级别。 此参数仅适用于使用重建包状态选项为管理模式参数构建自定义状态的情况。	Double
缓存服务实例数 (可选)	定义用于更新/生成切片的实例数。 该参数的值将设置为无限 (-1)，且无法进行修改。	Long
输出文件夹 (可选)	Status.gdb 的输出文件夹。 此参数仅适用于使用重建包状态选项构建自定义状态的情况。	Folder
感兴趣区域 (可选)	感兴趣区(面)决定着状态报告将覆盖的地理形态。 此参数仅适用于使用重建包状态选项构建自定义状态的情况。	Feature Set
报告范围 (可选)	定义构建状态区域的矩形范围。 此参数仅适用于使用重建包状态选项构建自定义状态的情况。 请注意，感兴趣区参数可指定非矩形感兴趣区。 当前显示范围 - 范围基于活动地图或场景。 仅在存在活动地图时，才可使用此选项。 图层范围 - 范围基于活动地图图层。 使用下拉列表选择可用图层，或使用所有图层中数据的范围选项获取所有活动地图图层（不包括底图）的组合范围。 仅在存在具有图层的活动地图时，才可使用此选项。 浏览 - 范围基于现有数据集。 重置范围 - 将范围重置为默认值。 手动输入坐标 - 坐标必须是数值，并且与活动地图的坐标系相匹配。 地图可能使用不同的显示单位	Extent

派生输出

标注	说明	数据类型
输出地图服务 URL	输出服务 URL。	String

Python

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

名称	说明	数据类型
input_service	将修改其缓存状态的地图影像图层。 可以通过在门户中浏览至所需的服务来对其进行选择，也可以从目录窗格的门户选项卡拖放一个 web 切片图层来提供此参数。	Image Service; Map Server
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 参数可指定非矩形感兴趣区。 MAXOF - 将使用的所有输入的最大范围。 MINOF - 将使用的所有输入共用的最小范围。 DISPLAY - 范围与可见显示范围相等。 图层名称 - 将使用指定图层的范围。 Extent 对象 - 将使用指定对象的范围。 以空格分隔的坐标字符串 - 将使用指定字符串的范围。 坐标按 x-min、y-min、x-max、y-max 的顺序表示。	Extent

派生输出

名称	说明	数据类型
output_folder	输出服务 URL。	String

代码示例

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.server.ManageMapServerCacheStatus(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: 是