Skip To Content

ArcGIS Data Store REST 命令

配置 ArcGIS Data Store 时,需要将其与用作门户托管服务器的 GIS Server 站点关联。 可以从托管服务器的 ArcGIS Server 管理员目录中作为 ArcGIS Server 管理员执行更改或检查数据存储状态的操作。 (URL 格式为 https://gisserver.domain.com:6443/arcgis/admin。)您也可以从以主-备用模式运行的关系数据存储或切片缓存数据存储中移除备用计算机,并从 ArcGIS Server 管理员目录盅的 GIS Server 站点移除备用计算机。 以下章节概述了这些操作和 ArcGIS API 文档的链接。

如果您不是托管服务器的 ArcGIS Server 管理员,您需要与管理员合作完成此处描述的任务。

以下是 ArcGIS Server 管理员目录中的路径,您需要按照这些路径,访问每个数据存储类型的操作:

  • 关系数据存储 - 单击数据 > 项目 > enterpriseDatabases > <数据存储名称> > 计算机 > <计算机名称>
  • 时空大数据存储 - 单击数据 > 项目 > nosqlDatabases > AGSDataStore_bigdata_<数据存储名称> > 计算机 > <计算机名称>
  • 切片缓存数据存储 - 单击数据 > 项目 > nosqlDatabases > AGSDataStore_bigdata_<数据存储名称> > 计算机 > <计算机名称>
  • 图形存储 - 单击数据 > 项目 > nosqlDatabases > AGSDataStore_graph_<数据存储名称> > 计算机 > <计算机名称>
  • 对象存储 - 单击数据 > 项目 > objectStores > <数据存储名称> > 计算机 > <计算机名称>

更改数据存储计算机的状态

您可以停止或重新启动数据存储中的各计算机。 您也可以将备用关系数据存储计算机或主-备用切片缓存数据存储中的备用数据存储计算机提升为主数据存储计算机。

由于您在执行维护任务(如临时离线使用数据存储)时可能不希望出现任何故障,所以请停止主数据存储计算机,因为这么做不会导致数据存储在预置部署上出现故障。

例如,将数据存储计算机状态作为以下升级场景的一部分进行更改:

  • 停止备用计算机。
  • 升级备用计算机。
  • 启动备用计算机。
  • 使用 makePrimary 命令将备用计算机升级为主要计算机。
  • 停止以前的主要计算机。
  • 升级以前的主要计算机。
  • 启动以前的主要计算机。
  • 将以前的主要计算机作为备用计算机再次添加到数据存储。

ArcGIS Server 站点管理员的身份登录到托管服务器 ArcGIS Server 管理员目录并转到特定计算机,以使用以下任意命令更改数据存储计算机的状态:

  • 停止
  • start
  • makePrimary(仅主-备用模式的备用关系数据存储计算机或切片数据存储计算机)

验证数据存储

您可以使用验证 ArcGIS Server REST 命令检查数据存储中的计算机状态。

ArcGIS Server 站点管理员的身份登录到 ArcGIS Server Administrator Directory,前往您希望检查的特定数据存储类型的其中一台计算机,然后单击验证,查看与此数据存储相关的信息。 与数据存储状态相关的重要信息包括以下内容:

  • 整体健康状况 - 值如下:
    • 健康 - 所有成员计算机上的所有组件都可以访问并且工作正常。
    • 健康但有警告 - 此状态仅适用于对象和图形存储。 一个或多个组件不可用,但数据存储仍然可用。 对于包含多台计算机的对象存储,此时数据存储可能并非高度可用。
    • 不健康 - 如果数据存储中超过一半的计算机无法访问,则此数据存储将被视为不健康 ("datastore.overallhealth": "Unhealthy")。 如果计算机无法访问,则会被视为不健康 ("machine.overallhealth": "Unhealthy")。
  • 状态 - 对于关系或切片缓存数据存储,可能的值有:已开始已停止。 停止时,您无法向您的门户发布托管要素图层或托管场景图层。
  • clusterStatus - 对于时空大数据存储,有以下状态:
    • 绿色 - 所有数据均可用
    • 黄色 - 数据可用,但是数据的部分或全部副本不可用,且您的时空大数据存储当前不处于高度可用状态。 如果您配置了单击时空大数据存储,将始终看见该状态。 如果计算机正在重新平衡数据,或者时空大数据存储中的一或多台计算机无法访问时,您也可能看见该状态。 如果您拥有多机时空大数据存储,并看到黄色状态,请通过验证每台计算机来确认所有计算机仍然可用。 如果计算机均可用,请等待几个小时,再重新检查。 如果状态仍然是黄色,请检查 ArcGIS Server 日志来查找错误。
    • 红色 - 部分或所有数据无法访问。 检查日志并纠正错误。
  • 角色 - 该状态仅应用到关系数据存储或主-备用切片缓存数据存储中的计算机,用于指示计算机为计算机还是备用计算机。 对于对象存储,角色将为对应单个实例的主要角色,以及对应以聚类模式部署的对象存储的 cluster_member 角色。
  • 消息 - 您可以在此处看到与数据存储状态相关的警告和错误消息。 例如,如果您验证一个多机切片缓存数据存储,那么若场景缓存数据目前不具有较高的可用性(换言之,其中一个或多个场景缓存只有一个副本),您将收到消息。

您可以验证数据存储以确认计算机是否已停止或已启动,确认使用 makePrimary 命令后是否已将备用计算机升级为主机,确认您的切片缓存数据存储是否处于高度可用的状态,或(作为初始故障排除步骤)是否无法发布或访问托管要素图层或场景图层或者无法运行 GeoAnalytics Tools

移除备用计算机

您可以使用移除 ArcGIS Server REST 命令从关系数据存储或主-备用切片缓存数据存储中移除备用计算机。 例如,如果您希望将其他计算机用于备用计算机,您可以从数据存储中移除旧的备用计算机,然后在新计算机上安装 ArcGIS Data Store 并将新计算机配置为备用计算机。

ArcGIS Server 站点管理员的身份登录到托管服务器 ArcGIS Server Administrator Directory 以使用移除命令。

管理托管要素图层的查询响应缓存

对于被频繁查询的托管要素图层,托管服务器的 ArcGIS Server 管理员可以在单个图层上启用查询响应缓存以帮助提升性能。 一旦启用,每次要素服务接收到唯一查询时,要素和范围都将缓存在对象存储中。 根据缓存在对象存储运行的一台或多台计算机上的存储时间(缓存有效期策略)和磁盘可用空间,对象存储可能填充并停止运行。

作为 ArcGIS Data Store 管理员,您必须在与其他软件分开的一台或多台计算机上配置对象存储,并确保有足够的磁盘空间来存储这些缓存。 您也必须监视 ArcGIS Data Store 日志以检测对象存储何时接近容量。 您可以验证对象存储以查看对象存储计算机上的磁盘使用空间百分比,以及运行实用程序以确定哪些图层缓存最大。 如果需要,与 ArcGIS Server 管理员合作更改缓存有效期策略删除大图层缓存

启用要素图层的查询响应缓存

要在托管要素图层(要素服务)中的一个或多个图层上启用缓存,托管服务器站点的 ArcGIS Server 管理员必须登录到托管服务器的 ArcGIS Server Administrator 目录并使用更新定义 REST 操作来提交以下请求:

{
    "layerCache": {
        "enabled": true
    }
}

如果数据频繁更新,请勿启用缓存;每次图层更新时,都必须重建缓存,因此在经常编辑的要素图层上使用缓存的查询时,您不会看到任何性能提升。

设置或更改缓存有效期策略

将根据每条唯一查询创建缓存。 如果对象存储计算机上有足够的磁盘空间并且很多客户端访问图层,请将缓存设置为不过期。 上一部分显示的示例请求将启用无有效期的缓存。

对于不能连续访问的图层,或者如果考虑磁盘空间,请设置将图层的查询响应缓存保留多长时间(以天为单位)。

{
    "layerCache": {
        "enabled": true, 
        "expiration": <duration_in_days>
    }
}

请注意,缓存在 UTC 午夜时间到期。 如果将有效期策略设置为 1,则缓存最多可以保留两天,具体时间取决于创建缓存的时间。

例如,如果客户端在 4:00 UTC 访问要素图层,其缓存将保留至翌日的 24:00 UTC。

删除图层的缓存

如果对象存储的磁盘空间不足,您将在 ArcGIS Data Store 日志中看到警告,验证 REST 命令将显示已使用的磁盘空间。 您无法将磁盘空间或计算机添加到现有对象存储,因此您可能需要清理缓存以释放磁盘空间。 要执行此操作,托管服务器的 ArcGIS Server 管理员必须禁用该图层的缓存。

{
    "layerCache": {
        "enabled": false
    }
}