管理地图服务器缓存切片 (服务器)

描述

在现有 web 切片图层缓存中创建和更新切片。此工具用于创建新切片、恢复缺失切片、覆盖过时切片以及删除切片。

使用方法

  • 对于涉及较大地理范围或较大地图比例的缓存,此工具可能会需要较长的运行时间。如果取消此工具,将停止切片创建,但不删除现有切片。这意味着,如果您的时间不足,可以先取消工具,随后再通过将更新模式参数设置为重新创建空切片(Python 中为 update_mode="RECREATE_EMPTY_TILES"),来在同一缓存上重新运行该工具。

语法

arcpy.server.ManageMapServerCacheTiles(input_service, scales, update_mode, {num_of_caching_service_instances}, {area_of_interest}, {update_extent}, {wait_for_job_completion}, {portal_url})
参数说明数据类型
input_service

待更新缓存切片所属的 web 切片图层或地图图像图层。

Image Service; MapServer
scales
[scales,...]

运行此工具时创建或删除切片所依据的比例级别取决于 update_mode

Double
update_mode

缓存的更新模式。

  • RECREATE_EMPTY_TILES只对空的切片重新创建。现有切片将保持不变。此选项不适用于发布至 ArcGIS Online 的 web 切片图层。
  • RECREATE_ALL_TILES如果范围发生改变,则需要更换现有切片并添加新切片。
  • DELETE_TILES将从缓存中删除切片。缓存文件夹结构不会删除。
String
num_of_caching_service_instances
(可选)

定义用于更新/生成切片的实例数。该参数的值将设置为无限 (-1),且无法进行修改。

Long
area_of_interest
(可选)

定义感兴趣区以对将创建或删除的切片进行约束。该参数用于为形状不规则的区域管理切片。它对您要对某些区域进行预缓存或让较少访问的区域保持未缓存的状态等情形也同样有用。

若未提供该参数的值,则会默认使用地图的全图范围。

Feature Set
update_extent
(可选)

创建或删除切片所参照的矩形范围取决于 update_mode 参数的值。建议不要同时提供 update_extentarea_of_interest 两个参数的值。如果同时提供了两个参数的值,则将使用 area_of_interest 的值。

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

可以通过该参数查看在 Portal 上运行的缓存作业的进度。

  • WAIT该工具将继续在 Python 窗口中运行,同时缓存作业在 Portal for ArcGIS 或 ArcGIS Online 上运行。使用此选项,您可以随时请求详细的进度报告并查看显示的地理处理消息。这是默认选项。建议在 Python 脚本中使用此选项。
  • DO_NOT_WAIT地理处理工具会将作业提交至服务器,以便您执行其它地理处理任务。在您选择在发布服务之际自动构建缓存时使用此选项,您还可在您所构建的任何其他缓存中设置此选项。要追踪缓存作业的状态,请打开 ArcMap,右键单击目录窗口中的服务,然后单击查看缓存状态。您也可以使用工具生成消息中所提供的 URL。
Boolean
portal_url
(可选)

门户 URL。

String

派生输出

名称说明数据类型
out_job_url

输出 URL。

字符串

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题