Skip to main content

changedbproperties

此 ArcGIS Data Store 实用程序与关系存储、对象存储和时空大数据存储一起使用。

changedbproperties 实用程序可用于根据运行的数据存储类型更改各种属性。

语法

changedbproperties --store {relational | spatiotemporal | object} [configuration options]

必须提供 --store 选项以及至少一个配置选项。 以下是支持的配置选项、选项描述以及各个选项适用的数据存储类型：

配置选项

描述

支持的数据存储类型

--disk-threshold-readonly

此选项用于控制何时将关系存储置于只读模式，以避免由于磁盘空间不足导致的数据丢失。

指定大小（以 MB 为单位）。 默认磁盘空间值为 1024 MB。

仅适用于关系存储

--max-connections

使用该参数指定关系存储所允许的最大连接数。

默认情况下，关系存储可最多接受 150 个连接。 使用 --max-connections 属性可更改允许的连接数。

请考虑到 ArcGIS Data Store 内部进程最多需要 5 个连接。 还需考虑 ArcGIS Data Store 计算机在保持性能良好的情况下可接受的最大并发连接数。 如果计算机运行 ArcGIS Data Store 时内存不足，您可能需要减少允许的连接数。

指定的数量不得小于 10。

当您更改允许的最大连接数时，将同时更改主数据存储计算机和备用数据存储计算机上的这一数量。

仅适用于关系存储

--pitr

该选项指示 ArcGIS Data Store 是否会创建关系存储的增量备份，以支持将关系存储恢复至一个时间点。

此选项的可用参数包括 enable 和 disable。

仅适用于关系存储

默认设置为 --pitr disable。

注意：

时间点恢复依赖于完整、自动备份的存在。 如果将 --pitr 选项设置为 enable，请勿禁用自动备份。

如果后续将使用随 Portal for ArcGIS 安装的 webgisdr 实用程序创建 ArcGIS Enterprise 部署的增量备份，则必须将 --pitr 选项设置为 enable。

--enablessl

此选项可控制在关系存储和托管服务器之间进行通信时，传输层安全性 (TLS) 协议的使用情况。

--enablessl 参数的受支持参数如下：

  • true - 这是默认设置。 如果您指定了 --store relational，则在关系存储与托管服务器进行通信时使用传输层安全性协议。

  • false - 指定 false 和 --store relational 在托管服务器与关系存储之间使用 HTTP 通信。

仅适用于关系存储

--heap-size

使用该参数更改用于时空大数据存储或对象存储的堆内存数（以 MB 为单位）。

默认情况下，时空大数据存储在启动时使用总 RAM 的 50% 或可用 RAM 的 70%（取较小值）。 您可以将堆大小更改为介于 512 MB 和 32,000 MB 之间的数量，但请确保指定的数量不超过计算机上的可用 RAM。 如果时空大数据存储包含多台计算机，则需要在每台计算机上运行 changedbproperties 实用程序，从而增加堆大小。

对象存储的默认堆使用量取决于计算机的可用 RAM 数量。

  • 通常情况下，对象存储使用总 RAM 的 50% 或可用 RAM 的 70%（取较小值）。

  • 对于 RAM 超过 20 GB 的计算机，如果可用 RAM 在 40% 到 70% 之间，对象存储启动时将使用 40% 的 RAM。

您可以将对象存储的堆大小设置在 1024 MB（最小值）到 124,000 MB（最大值）之间。 但是，需注意以下情况：

  • 当计算机的可用 RAM 介于 16 GB 到 32 GB 之间时，对象存储的最小堆大小应为 6 GB。

  • 确保您指定的堆大小不超过计算机的可用 RAM。

如果对象存储包含多台计算机，集群中的所有计算机都将更新，并且对象存储将在所有计算机上重新启动。

仅适用于时空大数据存储和对象存储

--rebalance

默认情况下，此选项设置为 true，意味着在任何一台计算机不可用时，时空大数据存储会将数据分发到其他计算机。

如果需要在一个时空大数据存储计算机上执行维护（例如对其进行升级），则可以通过指定 --rebalance false 来临时关闭重新平衡。 重新平衡选项将在为 --max-rebalance-off 参数设置的分钟数内暂停。

仅适用于时空大数据存储

--max-rebalance-off

此选项与 --rebalance 选项配合使用，可指示重新平衡的暂停时长。

默认情况下，--max-rebalance-off 设置为 60 分钟。 这意味着，如果您临时关闭重新均衡，它将在 60 分钟后再次启动。 如果您在执行使您暂停重新平衡的维护任务时需要比该时长更多或更少的时间，请更改 --max-rebalance-off 的时间设置。

仅适用于时空大数据存储

--prompt

您运行该实用程序时，系统将提示您确认指定的操作。 如果自动使用此实用程序，可指定 --prompt no，否则必须要回应提示消息，脚本才会继续。

该实用程序支持所有数据存储类型

示例

以下部分包括使用 changedbproperties 实用程序可用选项的示例。

更改关系存储的只读阈值

默认情况下，当可用磁盘空间降至 1024 MB 时，关系存储将处于只读模式。 在以下示例中，有其他应用程序写入计算机，因此管理员将关系存储配置为更快地处于只读模式：当计算机上的可用磁盘空间下降到 4000 MB 时：

./changedbproperties.sh --store relational --disk-threshold-readonly 4000

changedbproperties --store relational --disk-threshold-readonly 4000

You are changing the following database properties:
      ...disk space threshold to change relational store into READONLY mode to 4000MB)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

更改关系存储允许的连接数

在此示例中，关系存储允许的最大连接数设置为 100：

./changedbproperties.sh --store relational --max-connections 100

changedbproperties --store relational --max-connections 100

You are changing the following database properties:
      ...max number of connections to 100 (on all relational store machines)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

启用关系存储的时间点恢复

默认情况下，时间点恢复被禁用。 在此示例中，启用关系存储的时间点恢复：

./changedbproperties.sh --store relational --pitr enable

changedbproperties --store relational --pitr enable

You are changing the following database properties:
      ...enable point-in-time recovery for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

禁用 SSL

默认情况下，关系存储通过 HTTPS 与托管服务器通信。 在此示例中，--enablessl 参数用于配置关系存储通过 HTTP 与托管服务器通信。

./changedbproperties.sh --store relational --enablessl false

changedbproperties --store relational --enablessl false

You are changing the following database properties:
      ...disable ssl for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

更改时空大数据存储或对象存储的堆大小

您可以更改时空大数据存储或对象存储在启动时使用的 RAM 数量。 堆大小以 MB 为单位。

注意：

减小堆大小可能会阻止数据存储启动。 如果增加堆大小，请勿指定超出计算机可用 RAM 数量的数字。

在此示例中，时空大数据存储计算机的堆大小设置为 1600 MB。

./changedbproperties.sh --store spatiotemporal --heap-size 1600

changedbproperties --store spatiotemporal --heap-size 1600

You are changing the following database properties:
      ...heap size for spatiotemporal store to 1600MB (on current machine)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

在此示例中，对象存储计算机的堆大小设置为 2400 MB。

./changedbproperties.sh --store object --heap-size 2400

changedbproperties --store object --heap-size 2400

You are changing the following database properties:
      ...heap size to 2400MB for the object store installed on this machine
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

暂停时空大数据存储的重新均衡

在此示例中，管理员需要在时空大数据存储中的一台计算机上执行简短的维护程序，并且不希望数据存储重新平衡。 为此，使用 --rebalance 和 --max-rebalance-off 选项暂停重新均衡 30 分钟。 30 分钟后，时空大数据存储会自动将 rebalance 变为 true。

因为这种情况必须定期发生，所以管理员将以下语句保存在脚本中并将提示选项设置为“否”。

./changedbproperties.sh --store spatiotemporal --rebalance false --prompt no

./changedbproperties.sh --store spatiotemporal --max-rebalance-off 30 --prompt no

changedbproperties --store spatiotemporal --rebalance false --prompt no

changedbproperties --store spatiotemporal --max-rebalance-off 30 --prompt no