管理 Globe 服务器缓存切片 (服务器)
摘要
在现有 Globe 服务缓存中创建和更新切片。此工具用于创建新切片、恢复缺失切片、覆盖过时切片或添加新切片。所有这些操作都可通过矩形范围或面要素类定义。创建新切片时,可选择是仅创建空切片还是重新创建所有切片。
用法
-
此工具应被用于更新现有 Globe 服务器缓存。要更新缓存,请指定托管 Globe 服务的 ArcGIS Server。此工具会自动列出该服务器上所有可用的 Globe 服务。
-
如果运行更新时并未指定范围,服务的整个范围都将得到更新。
-
如果您只需要更新 Globe 服务缓存的一部分,则运行更新很有用。指定 level_from 和 level_to 时,请务必指定生成切片时要用到的全部细节等级。level_from 定义了数据缓存起始的最低细节等级。level_to 定义了希望数据缓存具有的最高分辨率。
语法
| 参数 | 说明 | 数据类型 |
server_name |
用于托管您正在管理的切片所属 Globe 服务的 ArcGIS Server 计算机。 | String |
object_name |
切片将被修改的 Globe 服务。 | String |
update_extent (可选) |
创建或删除切片所依据的矩形范围,具体取决于更新模式。输入范围值或从现有数据源中选择一个范围即可。 | Extent |
in_layers [in_layers,...] |
选择要包含在缓存中的图层。 您需要为每个图层提供缓存开始时的细节等级 level_from 以及缓存结束时的细节等级 level_to。如果将最小细节等级和最大细节等级分别用作 level_from 和 level_to,将为图层建立完全缓存。 | Value Table |
thread_count (可选) |
运行此工具时使用的 Globe 服务实例的数量。默认情况下,使用实例的最大允许数量(对于 ArcGIS Server 服务,其默认值是 2)。如果服务器功能更强大,则可以在服务属性 中增加实例的最大允许数量,然后在运行此工具时增大此参数。 | Long |
update_mode |
选择缓存的更新模式。有两种模式可用:
| String |
update_feature_class (可选) |
您可以根据要素类的要素范围使用面要素类来管理(创建/更新)切片。例如,如果您正在对一个国家/地区进行缓存,则可提供主要城区的要素类。您这样就可以要求服务器只预先创建覆盖这些市区的切片。其余区域可以根据客户端请求按需进行缓存。这样您就不必创建不需要的乡村区域切片,从而节省了时间和磁盘空间。 | Feature Class |
ignore_status (可选) | 如果您基于要素类边界创建切片,则可使用此参数追踪缓存的状态(请参阅 update_feature_class 参数)。
| Boolean |
代码示例
在本例中,将为 Globe 服务创建一个完全缓存。
#ManageGlobeServerCacheTiles example (stand-alone script)
# Name: ManageGlobeServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to update the
# globe map server cache tiles
# Requirements: os, sys, time & traceback modules
# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default values
# 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
server = "MyServer"
globeServerObject = "tstGlobeService"
inputLayers = ""
extents = ""
cacheDir = "C:\\arcgisserver\\arcgiscache\\GlobeCache"
threadCount = "2"
updateMode = "Recreate All Tiles"
pathToFeatureClass = ""
ignoreStatus = "IGNORE_COMPLETION_STATUS_FIELD"
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:
starttime= time.clock()
result = arcpy.ManageGlobeServerCacheTiles_server (server, globeServerObject,
extents, updateMode,
inputLayers, threadCount,
pathToFeatureClass,
ignoreStatus)
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 "Created the GlobeServer cache successfully for mapservice "
+ globeServerObject + "\n at " + cacheDir + globeServerObject
+ " 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 1 \n" "Line %i" % tb.tb_lineno)
report.write(e.message)
report.close()
print "Created the globe server cache successfully"