管理 Globe 服务器缓存切片 (服务器)

摘要

在现有 Globe 服务缓存中创建和更新切片。此工具用于创建新切片、恢复缺失切片、覆盖过时切片或添加新切片。所有这些操作都可通过矩形范围或面要素类定义。创建新切片时,可选择是仅创建空切片还是重新创建所有切片。

用法

语法

ManageGlobeServerCacheTiles_Server (server_name, object_name, {update_extent}, in_layers, {thread_count}, update_mode, {update_feature_class}, {ignore_status})
参数说明数据类型
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

选择缓存的更新模式。有两种模式可用:

  • 重新创建空切片只重新创建空切片。现有切片将保持不变。
  • 重新创建所有切片更换包括现有切片在内的所有切片。如果图层数据范围发生改变或已将新图层添加到 Globe 服务并已在此工具中列出,则将额外添加新的切片。
String
update_feature_class
(可选)

您可以根据要素类的要素范围使用面要素类来管理(创建/更新)切片。例如,如果您正在对一个国家/地区进行缓存,则可提供主要城区的要素类。您这样就可以要求服务器只预先创建覆盖这些市区的切片。其余区域可以根据客户端请求按需进行缓存。这样您就不必创建不需要的乡村区域切片,从而节省了时间和磁盘空间。

Feature Class
ignore_status
(可选)

如果您基于要素类边界创建切片,则可使用此参数追踪缓存的状态(请参阅 update_feature_class 参数)。

  • IGNORE_COMPLETION_STATUS_FIELD忽略要素类的已完成字段,并为要素类中的所有要素都创建切片。这是默认设置。
  • TRACK_COMPLETION_STATUS读取要素类的已完成字段(如果尚未存在此字段,则创建此字段)。此字段中标记为或空值的要素将进行缓存,在完成对要素的缓存后,会将其标记为。此字段中已标记为的要素将不进行缓存。
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"

环境

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

相关主题

许可信息

ArcView: 需要 3D Analyst
ArcEditor: 需要 3D Analyst
ArcInfo: 需要 3D Analyst

7/10/2012