使用 web 工具的常见注意事项

上传和下载大型数据集

共享 web 工具时的上传数据和运行 web 工具时的下载输出数据都具有文件大小限制。 这种限制取决于托管 web 工具的联合服务器的堆大小。 默认服务器堆大小为 64 MB;但服务器管理员可根据需要修改此大小。 要增大以下实例中的堆大小,请联系您的服务器管理员:

  • 上传的栅格数据大于 64 MB
  • 上传的要素数据接近或大于 64 MB
  • 下载的要素数据接近或大于 64 MB

有关堆大小与上传和下载大型数据集之间关系的详细说明,请参阅 Web 工具属性高级设置的“堆大小”部分。

下载大型要素数据时,还应考虑服务器所返回的最大记录数。 默认记录大小为 1000 条。 如果返回的记录数将超过 1000 条,则可执行以下操作:

  • 在共享为 web 工具时通过 web 工具设置重置最大记录计数。
  • 如果未在共享过程中进行重置,则不会下载数据,而且地理处理历史中的 web 工具执行结果会包含消息:数据超出传输限制。 您必须登录联合服务器管理器,并重置托管 web 工具的最大地理处理服务记录数。
  • 使用带有输出要素服务的 Web 工具可以避免下载大量输出数据。

通过 Web 应用程序上传大型数据集

Web 应用程序使用“表述性状态转移 (REST) 上传”操作来上传文件。 此功能通过地理处理服务属性页面的上传功能设定。 默认的最大上传大小是 2 GB。 可按照 Web 工具属性高级设置的“上传大小”部分中所述的步骤将最大上传大小修改为小于 2 GB。 您不能将最大上传大小修改为大于 2 GB 的大小。

如果输入数据为 .txt.zip 或者 .jpg 格式的文件,您可以使用 uploads 资源操作来上传这些文件类型。 有关上传文件类型的设置的说明,请参阅 Web 工具属性高级设置的“上传类型”部分。

ArcMap 中的 Web 工具

您可以通过服务器连接文件使用 Web 工具。 如果从任意客户端将 Web 工具发布到 ArcGIS Enterprise 10.9.1 或更早版本,您可以将其与任意连接类型共享权限配合使用。 不支持从 ArcMap 发布到 ArcGIS Enterprise 11 和更高版本。 但是,您可以使用从 ArcGIS Pro 发布到 ArcGIS Enterprise 11 的 Web 工具,但需要满足以下要求:

  • 用户连接类型用于服务器连接。
  • Web 工具已与所有人共享。
  • 没有与 ArcGIS Pro 3.0 中相似的覆盖输出要素服务选项,但您可以使用输出要素服务参数运行工具。
  • 如果 Web 工具具有值表字段数据类型的参数,则只能将其与现有值一起使用。 不支持更改现有值或提供 ArcMap 中的值。

输入为要素或影像服务

您可以通过输入服务 URL,从内容列表中选择服务图层或从 ArcGIS Pro门户窗格中选择服务,来根据要素的要素服务和栅格数据类型的影像服务提供输入。

输出为要素服务

使用 Web 工具时,可以使用输出要素服务名称参数将输出生成为输出要素类或表或者输出要素服务。 如果输出要素的大小非常大,则此选项可以加快消耗过程。 它还可以从各种客户端(如 web 客户端、桌面应用程序和外业应用程序)中永久获取数据。 您可以在使用具有输出要素服务的 web 工具中阅读有关将输出另存为要素服务的更多详细信息。

使用自定义地理变换

有时,您可能希望对您共享的 web 工具使用自定义地理变换文件 (.gtf)。 在这种情况下,请确保 .gtf 文件位于托管 web 工具的联合服务器中。 有关创建 .gtf 文件并将其保存到服务器的详细信息,请参阅将地理处理服务与自定义地理变换配合使用ArcGIS Pro 中保存的 .gtf 文件路径与 ArcGIS Desktop 中保存的路径类似。 您仅需将 .gtf 路径的 Desktop10.x 部分替换为 ArcGISPro

使用环境

ArcGIS Pro 中使用 web 工具时,可以使用工具的环境选项卡来设置工具执行的环境设置。 除从下拉列表中进行选择外,某些环境(例如,输出坐标系和掩膜)还接受输入的要素服务或地图服务 URL。 除从下拉列表中进行选择外,某些环境(例如,捕捉栅格和像元大小)还接受输入的影像服务 URL。 使用 web 工具时,将不会处理在分析选项卡中指定的环境设置,该设置用于在 ArcGIS Pro 中进行本地地理处理。 以下是受支持的环境列表。

  • 输出坐标 - 输出坐标系、地理变换
  • 处理范围 - 范围
  • 并行处理 - 并行处理因子
  • 栅格分析 - 像元大小、像元大小投影方法、掩膜、捕捉栅格
  • 地理数据库 - 自动提交
  • M 值 - 输出包含 M 值
  • Z 值 - 默认输出 Z 值、输出包含 Z 值
  • 随机数 - 随机数生成器
  • 栅格存储 - NoData
  • 处理器类型 - 处理器类型、GPU ID

参数过滤器

在创作工具时,您可以在工具属性对话框上的参数选项卡上设置一个过滤器。 从 ArcGIS Server 10.7 开始,当您发布带有过滤器的工具时,也会发布过滤器信息。 除了“日期”过滤器外,系统仅支持受支持的输入数据类型的过滤器。

示例

在以下工具中,已为“双精度”参数设置了范围过滤器,其中最小值值为 213 且最大值为 123132.123。

更新工具的范围过滤器

如果发布了该工具,且将其用作 ArcGIS Pro 中的 web 工具,则过滤器范围之外的输入值将提示错误,以指示该值超出范围。

使用范围过滤器可防止在定义的范围之外使用值

Web 工具使用的 Python 环境

ArcGIS Pro 相似,ArcGIS Enterprise 使用 ArcGIS Server 中的 Python 环境。

默认情况下,发布自 ArcGIS Pro 的 web 工具使用默认的 Python 环境,其位于服务器计算机上的 ArcGIS Server 安装目录中。 如果您的 ArcGIS Server 位于默认的安装位置,则 Python 环境位于 C:\Program Files\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3

如果在创作分析时将自定义 Python 环境与第三方 Python 包搭配使用,这些 Python 包在发布过程期间将不会自动上传到 ArcGIS Server。 要上传您的包,请参阅为 ArcGIS Server 部署自定义 Python 包。 否则,web 工具将因 Python 错误而失败。

各种 ArcGIS Enterprise 部署类型的注意事项

提供了多种部署方案。 某些部署在特定情况下可能需要注意。

ArcGIS Enterprise 中的高可用性

如果您将 Web 工具发布到具有 NFS 文件共享的高可用性 ArcGIS Enterprise 部署,请确保未在 NFS 文件共享上设置 NOLOCK 选项。 利用文件锁定,可以确保使用异步地理处理服务记录 web 工具作业状态的基本文件具有适当的锁定机制。 如果在 NFS 文件共享上设置了 NOLOCK 选项,则多台计算机可能会处理相同的请求,从而导致结果重复。 有关此部署和 NAS 设备的详细信息,请参阅 ArcGIS Enterprise 中的高可用性ArcGIS Server 选择 NAS 设备

多机 ArcGIS Server 站点

如果您的多机 ArcGIS Server 站点正在使用第三方负载均衡器,请确保负载均衡器可以支持粘滞会话。 这允许使用异步地理处理服务的客户端提交作业并从同一台计算机获取作业状态、进度、输入和输出。 否则,如果负载均衡器将请求路由到运行作业的计算机以外的其他计算机,则客户端将无法获取作业状态。