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

摘要

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

使用情况

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

参数

对话框

标注	说明	数据类型
输入服务	待更新缓存切片所属的 web 切片图层或地图影像图层。 可以通过在门户中浏览至所需的服务来对其进行选择，也可以从工程窗格的门户选项卡拖放一个 web 切片图层来提供此参数。	Image Service; Map Server
比例	创建切片时使用的比例级别列表。 默认情况下，工具对话框中所列出的比例介于该服务的最小和最大缓存比例之间。 在 ArcGIS Pro 中，无法更改服务的缓存比例范围。	Double
更新模式	缓存的更新模式。 重新创建空切片—只对空的切片重新创建。 现有切片将保持不变。 此选项不适用于发布至 ArcGIS Online 的 web 切片图层。 重新创建所有切片—如果范围发生改变，则需要更换现有切片并添加新切片。 删除切片—将从缓存中删除切片。 缓存文件夹结构不会删除。	String
缓存服务实例数 (可选)	定义用于更新/生成切片的实例数。 该参数的值将设置为无限 (-1)，且无法进行修改。	Long
感兴趣区域 (可选)	定义感兴趣区以对将创建或删除的切片进行约束。 该参数用于为形状不规则的区域管理切片。 它对您要对某些区域进行预缓存或让较少访问的区域保持未缓存的状态等情形也同样有用。 若未提供该参数的值，则会默认使用地图的全图范围。	Feature Set
更新范围 (可选)	创建或删除切片时所参照的矩形范围，具体取决于更新模式参数的值。 建议不要同时提供更新范围和感兴趣区两个参数值。 如果同时提供了两个参数的值，则会使用感兴趣区的值。 默认 - 该范围将基于所有参与输入的最大范围设定。这是默认设置。 当前显示范围 - 该范围与数据框或可见显示范围相等。如果没有活动地图，则该选项将不可用。 如下面的指定 - 该范围将基于指定的最小和最大范围值。 浏览 - 该范围将基于现有数据集。	Extent
等待作业完成 (可选)	可以通过该参数查看在 ArcGIS Online 或 Portal for ArcGIS 上运行的缓存作业的进度。 选中 - 此工具将继续在 Pro 中运行，同时缓存作业在 Portal for ArcGIS 或 ArcGIS Online 中运行。 使用此选项，您可以随时请求详细的进度报告并查看显示的地理处理消息。 未选中 - 此工具会将作业提交至门户，允许您在 ArcGIS Pro 中执行其他地理处理任务或将其关闭。 在您选择在发布服务之际自动构建缓存时使用此选项，您还可在您所构建的任何其他缓存中设置此选项。	Boolean
门户 URL (可选)	门户 URL。	String

派生输出

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

Python

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; Map Server
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_extent 和 area_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。	String

环境

当前工作空间

特殊情况

许可信息

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