导入地图服务器缓存 (服务器)

摘要

源文件夹可以是已注册的服务器缓存目录的子文件夹、之前已向其导出缓存的文件夹或切片包 (.tpk)。目标服务必须与源缓存使用相同的切片方案和存储格式。

使用情况

  • 使用此工具将全部或部分缓存从一个文件夹导入到另一个文件夹。

  • 覆盖切片参数允许导入的切片完全覆盖现有的切片,而不是混合影像。 仍可将导入的切片限制在感兴趣区域。

参数

标注说明数据类型
输入服务
Image Service; Map Server
源缓存类型

将缓存从缓存数据集或切片包导入到服务器上运行的缓存地图或影像服务。

  • CACHE_DATASET使用 ArcGIS Server 生成的地图或影像服务缓存。 其可用于 ArcGIS Desktop 并通过 ArcGIS Server 地图或影像服务对其进行使用。
  • TILE_PACKAGE将缓存数据集作为图层添加并合并以便实现共享的单个压缩文件。 可用于 ArcGIS Desktop、ArcGIS Runtime 和移动应用程序。
String
源缓存数据集
(可选)

将导入的切片所在的路径位置。 浏览时此路径由栅格数据集图标表示。 您不必指定已注册的服务器缓存目录;多数情况下,需要指定磁盘上之前已导入切片的位置。 ArcGIS Server 帐户应能访问此位置。 如果无法向 ArcGIS Server 帐户授予此位置的访问权限,则请选中将数据上传到服务器参数。

Raster Dataset
源切片包
(可选)

将导入的切片包所在的路径。 ArcGIS Server 帐户应能访问此位置。 将切片包文件导入到缓存地图或影像服务时会自动启用将数据上传到服务器参数。

File
将数据上传到服务器
(可选)

如果 ArcGIS Server 帐户没有源缓存的读取权限,请选中此参数。 工具会在源缓存移至 ArcGIS Server 缓存目录前将其上传到 ArcGIS Server 上传目录。

  • 选中 - 将切片放到服务器上传目录中,且随后将其移至服务器缓存目录。 如果源缓存类型参数设置为 TILE_PACKAGE,则此选项默认处于活动状态。
  • 未选中 - 将切片直接导入服务器缓存目录。 ArcGIS Server 帐户必须有源缓存的读取权限。
Boolean
比例
(可选)

导入切片时使用的比例级别列表。

默认情况下,工具对话框中所列出的比例介于该服务的最小和最大缓存比例之间。 要更新比例范围,请转至服务编辑器 > 缓存选项卡,然后使用滑块更新最小和最大缓存比例。

Double
缓存服务实例数
(可选)
Long
感兴趣区域
(可选)

对将切片导入到缓存时所处的位置进行空间约束的感兴趣区。 此参数在您想要导入形状不规则区域的切片时非常有用,因为该工具会按像素分辨率裁剪与面相交的缓存数据集,然后将其导入到服务器缓存目录。

如果未提供该参数的值,则将使用导入范围参数的值。 默认情况下将使用地图的全图范围。

Feature Set
导入范围
(可选)

定义要导入到缓存的切片的矩形范围。 默认情况下,此范围将设置为要导入切片所属的地图服务的全图范围。 请注意此感兴趣区工具中的可选参数,此工具允许您使用不规则的形状对所导入的切片进行空间约束。 如果为两个参数都提供了值,则感兴趣区参数的优先级高于导入范围

  • 当前显示范围 地图视图 - 范围基于活动地图或场景。 仅在存在活动地图时,才可使用此选项。
  • 绘制范围 Draw Extent - 范围将基于在地图或场景上绘制的矩形。 此选项将在工程地理数据库中创建要素类并将图层添加至地图。 该要素类的坐标系将与地图相同。
    注:

    环境对话框中不提供此选项。 只能在具有范围数据类型的工具参数中或工具对话框的环境选项卡中找到此选项。

    注:

    当选中从“编辑”选项卡启用和禁用编辑编辑选项时,必须在编辑功能区选项卡上启用编辑才能绘制范围。

  • 图层范围 图层 - 范围基于活动地图图层。 使用下拉列表选择可用图层,或使用所有图层中数据的范围选项获取所有活动地图图层(不包括底图)的组合范围。 仅在存在具有图层的活动地图时,才可使用此选项。

    每个地图图层具有以下选项:

    • 所有要素 全选 - 图层中所有要素的范围。
    • 选定要素Area from Selected Features - 图层中选定要素的范围。
    • 可见要素 Extent Indicator - 图层中可见要素的范围。
      注:

      选定要素 Area from Selected Features可见要素 Extent Indicator 选项中的范围仅适用于要素图层。

  • 浏览 浏览 - 范围基于现有数据集。
  • 剪贴板 粘贴 - 可在剪贴板中复制和粘贴范围。
    • 复制范围 复制 - 将范围坐标和坐标系复制到剪贴板。
    • 使用粘贴范围 粘贴 - 从剪贴板粘贴范围坐标和(可选)坐标系。 如果剪贴板值不包含坐标系,则范围将使用地图的坐标系。
    注:

    将使用与 ArcPy Extent 对象相同的格式和顺序从剪贴板中复制和粘贴范围坐标:x-min、y-min、x-max、y-max 和空间参考。

  • 重置范围 重置 - 将范围重置为默认值。
  • 手动输入坐标 - 坐标必须是数值,并且与活动地图的坐标系相匹配。
    警告:

    地图可能使用与输入的坐标不同的显示单位。 不支持使用主方向(N、S、E、W)。 在南纬和西经坐标中使用负号。

Extent
覆盖切片
(可选)

指定目标缓存中的图像是与原始缓存中的切片合并,还是被其覆盖。

  • 选中 - 导入过程会替换感兴趣区域的所有像素,并用原始缓存中的切片有效覆盖目标缓存中的切片。
  • 未选中 - 导入切片后,默认情况下将忽略原始缓存中的透明像素。 将导致目标缓存中的图像合并或混合。 这是默认设置。
Boolean

派生输出

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

输出 URL。

String

arcpy.management.ImportMapServerCache(input_service, source_cache_type, {source_cache_dataset}, {source_tile_package}, {upload_data_to_server}, {scales}, {num_of_caching_service_instances}, {area_of_interest}, {import_extent}, {overwrite})
名称说明数据类型
input_service
Image Service; Map Server
source_cache_type

将缓存从缓存数据集或切片包导入到服务器上运行的缓存地图或影像服务。

  • CACHE_DATASET使用 ArcGIS Server 生成的地图或影像服务缓存。 其可用于 ArcGIS Desktop 并通过 ArcGIS Server 地图或影像服务对其进行使用。
  • TILE_PACKAGE将缓存数据集作为图层添加并合并以便实现共享的单个压缩文件。 可用于 ArcGIS Desktop、ArcGIS Runtime 和移动应用程序。
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 上传目录。

  • UPLOAD_DATA将切片放到服务器上传目录中,且随后将其移至服务器缓存目录。 如果 source_cache_typeTILE_PACKAGE,则将默认启用此功能。
  • DO_NOT_UPLOAD将切片直接导入服务器缓存目录。 ArcGIS Server 帐户必须有源缓存的读取权限。
Boolean
scales
[scales,...]
(可选)

导入切片时使用的比例级别列表。

Double
num_of_caching_service_instances
(可选)
Long
area_of_interest
(可选)

对将切片导入到缓存时所处的位置进行空间约束的感兴趣区。 此参数在您想要导入形状不规则区域的切片时非常有用,因为该工具会按像素分辨率裁剪与面相交的缓存数据集,然后将其导入到服务器缓存目录。

如果未提供该参数的值,则将使用导入范围参数的值。 默认情况下将使用地图的全图范围。

Feature Set
import_extent
(可选)

定义要导入到缓存的切片的矩形范围。 默认情况下,此范围将设置为要导入切片所属的地图服务的全图范围。 请注意此感兴趣区工具中的可选参数,此工具允许您使用不规则的形状对所导入的切片进行空间约束。 如果为两个参数都提供了值,则感兴趣区参数的优先级高于导入范围

  • MAXOF - 将使用的所有输入的最大范围。
  • MINOF - 将使用的所有输入共用的最小范围。
  • DISPLAY - 范围与可见显示范围相等。
  • 图层名称 - 将使用指定图层的范围。
  • Extent 对象 - 将使用指定对象的范围。
  • 以空格分隔的坐标字符串 - 将使用指定字符串的范围。 坐标以 x-min,y-min,x-max,y-max 的顺序表示。
Extent
overwrite
(可选)

指定目标缓存中的图像是与原始缓存中的切片合并,还是被其覆盖。

  • OVERWRITE导入过程会替换感兴趣区域的所有像素,并用原始缓存中的切片有效覆盖目标缓存中的切片。
  • MERGE导入切片后,默认情况下将忽略原始缓存中的透明像素。 将导致目标缓存中的图像合并或混合。 这是默认设置。
Boolean

派生输出

名称说明数据类型
out_job_url

输出 URL。

String

代码示例

ImportMapServerCache 示例 1(独立脚本)

将缓存数据集导入到默认比例级数的缓存服务。 接收缓存中的切片将被正在导入的切片所覆盖。

# 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.server.ImportMapServerCache(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 as 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(str(e))

print("Imported Map server Cache Tiles ")

report.close()
ImportMapServerCache 示例 1(独立脚本)

将感兴趣区的缓存切片从切片包导入到缓存服务。

# 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.server.ImportMapServerCache(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 as 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(str(e))

report.close()

print("Imported Map server Cache Tiles for the given feature class")

环境

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