导入地图服务器缓存 (Server)
摘要
将切片从磁盘上的文件夹中导入到地图或影像服务缓存。源文件夹可以是已注册的服务器缓存目录的子文件夹、之前已向其导出缓存的文件夹或切片包 (.tpk)。目标服务必须与源缓存使用相同的切片方案和存储格式。
用法
- 使用此工具将全部或部分缓存从一个文件夹导入到另一个文件夹。
在 10.1 Service Pack 1 中，向该工具中添加了“覆盖切片 (Overwrite Tiles)”参数，此参数允许导入的切片完全覆盖现有切片，而不是混合图像。仍可将导入的切片限制在感兴趣区域。
注:在 10.1 版本中，此工具的各个参数都发生了变化。在 10.1 版本之前使用该工具编写的模型或脚本均需要经过修改才能在 10.1 版本中使用。
在迁移至 10.1 Service Pack 1 时，必须打开并验证使用该工具的模型，因为该工具具有新参数。此过程将在使用地理处理工具自动执行缓存创建和更新中进行说明。
语法
ImportMapServerCache_server (input_service, source_cache_type, {source_cache_dataset}, {source_tile_package}, {upload_data_to_server}, {scales}, {num_of_caching_service_instances}, {import_extent}, {area_of_interest}, {overwrite_tiles})
| 参数 | 说明 | 数据类型 |
input_service | 要向其导入切片的地图或影像服务。 这是一个包含服务器和服务器信息的字符串。要查看构建此字符串的方法，请打开 ArcCatalog，选择“目录”树中的服务，并注意位置 工具条中的文本。然后将反斜线改为正斜线，例如，MYSERVER (admin)/USA.MapServer 上的 GIS Servers/arcgis。 | String |
source_cache_type |
选择将缓存从 CACHE_DATASET 或 TILE_PACKAGE 导入到服务器上运行的缓存地图或影像服务。
| String |
source_cache_dataset (可选) | 与数据框名称相匹配的缓存文件夹的路径。您不必输入已注册的服务器缓存目录；实际上，多数情况下需要输入磁盘上之前已导入切片的位置。ArcGIS Server 帐户应能访问此位置。如果无法向 ArcGIS Server 帐户授予此位置的访问权限，请将 upload_data_to_server 设置为 UPLOAD_DATA。 | Raster Dataset |
source_tile_package (可选) |
将导入的切片包 (.tpk) 所在的路径。ArcGIS Server 帐户应能访问此位置。将切片包文件导入到缓存地图/影像服务时，upload_data_to_server 参数被忽略，因为它将被自动设置为 UPLOAD_DATA。 | File |
upload_data_to_server (可选) | 如果 ArcGIS Server 帐户没有源缓存的读取权限，请将此参数设置为 UPLOAD_DATA。工具会在源缓存移至 ArcGIS Server 缓存目录前将其上传到 ArcGIS Server 上传目录。
| Boolean |
scales [scales,...] (可选) |
导入切片时使用的比例级别列表。 | Double |
num_of_caching_service_instances (可选) | 专用于运行该工具的系统/缓存工具服务实例的总数。您可以通过与 ArcGIS Server 的管理连接，使用 服务编辑器 窗口，增加系统/缓存工具服务的每台计算机的最大实例数。确保您的服务器计算机可以支持所选数量的实例。 | Long |
import_extent (可选) |
定义要导入到缓存的切片的矩形范围。默认情况下，此范围被设置为要导入切片所属的地图服务的全图范围。请注意此感兴趣区工具中的可选参数，此工具允许您使用不规则的形状对所导入的切片进行空间约束。如果为两个参数都提供了值，则感兴趣区的优先级高于导入范围。 | Extent |
area_of_interest (可选) |
对将切片导入到缓存时所处的位置进行空间约束的感兴趣区。它可能是一个要素类，也可能是在 ArcMap 中以交互方式定义的要素。此参数在您想要导入形状不规则区域的切片时非常有用，因为该工具会按像素分辨率裁剪与面相交的缓存数据集，然后将其导入到服务器缓存目录。 如果未提供该参数的值，则将使用导入范围参数的值。默认情况下将使用地图的全图范围。 | Feature Set |
overwrite_tiles (可选) |
| Boolean |
代码实例
示例 1
将 CACHE_DATASET 导入到默认比例级数的缓存服务。接收缓存中的切片将被正在导入的切片所覆盖。
# Name: ImportMapServerCache.py
# Description: The following stand-alone script demonstrates how to import map
# server cache from a source directory with CACHE_DATASET and
# OVERWRITE existing cache on the service for the number
# of scales specified without Uploading data to server
# 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.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
sourceCacheType = "CACHE_DATASET"
sourceCacheDataset = "C:/data/destination_folder/Layers"
sourceTilePackage = ""
uploadDataToServer = "DO_NOT_UPLOAD"
scales = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest = ""
importExtents = ""
overwriteTiles = "OVERWRITE"
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.ImportMapServerCache_server(inputService, sourceCacheType,
sourceCacheDataset,
sourceTilePackage,
uploadDataToServer, scales,
numOfCachingServiceInstances,
areaOfInterest, importExtents,
overwriteTiles)
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 "Imported Map server Cache Tiles successfully for" + serviceName
" from" + sourceCacheDataset + "\n in " + str(elapsedtime)+ "sec 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)
print "Imported Map server Cache Tiles "
report.close()
示例 2
将感兴趣区的缓存切片从 TILE_PACKAGE 导入到缓存服务
# Name: ImportMapServerCache.py
# Description: The following stand-alone script demonstrates how to import map
# server cache from a source directory with Tile Package to an existing service for
# the default number of scales specified using an AOI by uploading data to remote server
# To Import cache tiles for the scales specified for given feature class
# Requirements: os, sys, time and traceback modules
# Author: ESRI
# 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.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
sourceCacheType = "TILE_PACKAGE"
sourceCacheDataset = ""
sourceTilePackage = "C:\\data\\destination_folder\\TPK\\Rainfall.tpk"
uploadDataToServer = "UPLOAD_DATA"
scales = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
cacheDir = "c:\\arcgisserver\\arcgiscache"
areaOfInterest = "C:/data/101/Portland/Portland_Metro.shp"
importExtents = ""
overwriteTiles = "MERGE"
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.ImportMapServerCache_server(inputService, sourceCacheType,
sourceCacheDataset,
sourceTilePackage,
uploadDataToServer, scales,
numOfCachingServiceInstances,
areaOfInterest, importExtents,
overwriteTiles)
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 "Imported Map server Cache Tiles successfully for " + serviceName
" from " + sourceTilePackage + " to " + cacheDir + "\n using "+ areaOfInterest
" 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 2 \n" "Line %i" % tb.tb_lineno)
report.write(e.message)
report.close()
print "Imported Map server Cache Tiles for the given feature class"
环境
此工具不使用任何地理处理环境
相关主题
许可信息
ArcGIS for Desktop Basic:是
ArcGIS for Desktop Standard:是
ArcGIS for Desktop Advanced:是
9/15/2013