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

摘要

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

使用情况

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

• 只能使用此工具构建先前版本的 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
报告范围 (可选)	定义构建状态区域的矩形范围。 此参数仅适用于使用重建包状态选项构建自定义状态的情况。 请注意，感兴趣区参数可指定非矩形感兴趣区。 当前显示范围 - 范围基于活动地图或场景。 仅在存在活动地图时，才可使用此选项。 绘制范围 - 范围将基于在地图或场景上绘制的矩形。 此选项将在工程地理数据库中创建要素类并将图层添加至地图。 该要素类的坐标系将与地图相同。 注： 环境对话框中不提供此选项。 只能在具有范围数据类型的工具参数中或工具对话框的环境选项卡中找到此选项。 注： 当选中从“编辑”选项卡启用和禁用编辑编辑选项时，必须在编辑功能区选项卡上启用编辑才能绘制范围。 图层范围 - 范围基于活动地图图层。 使用下拉列表选择可用图层，或使用所有图层中数据的范围选项获取所有活动地图图层（不包括底图）的组合范围。 仅在存在具有图层的活动地图时，才可使用此选项。 每个地图图层具有以下选项： 所有要素 - 图层中所有要素的范围。 选定要素 - 图层中选定要素的范围。 可见要素 - 图层中可见要素的范围。 注： 选定要素 和可见要素 选项中的范围仅适用于要素图层。 浏览 - 范围基于现有数据集。 剪贴板 - 可在剪贴板中复制和粘贴范围。 复制范围 - 将范围坐标和坐标系复制到剪贴板。 使用粘贴范围 - 从剪贴板粘贴范围坐标和（可选）坐标系。 如果剪贴板值不包含坐标系，则范围将使用地图的坐标系。 注： 将使用与 ArcPy Extent 对象相同的格式和顺序从剪贴板中复制和粘贴范围坐标：x-min、y-min、x-max、y-max 和空间参考。 重置范围 - 将范围重置为默认值。 手动输入坐标 - 坐标必须是数值，并且与活动地图的坐标系相匹配。 警告： 地图可能使用与输入的坐标不同的显示单位。 不支持使用主方向（N、S、E、W）。 在南纬和西经坐标中使用负号。	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: 是