ArcGIS Data Store 实用程序参考—Portal for ArcGIS

随 ArcGIS Data Store 一同安装的实用程序可为数据存储管理员提供管理数据存储的工具。此页面描述实用程序并提供语法和示例。

所有实用程序均必须运行于 ArcGIS Data Store 计算机上。您可在 <ArcGIS Data Store installation directory>\datastore\tools 目录中找到这些实用程序。

您可输入实用程序名称并在其后加 --help 以获得语法协助。

注：

您的登录帐户必须是 Windows 管理员群组的成员，并且您必须使用以管理员身份运行选项打开“命令提示符”，才能使用 ArcGIS Data Store 实用程序。

allowconnection

该实用程序适用于关系数据存储。

出于安全方面的原因，默认通过 GIS Server 站点建立到数据存储的所有连接。如果您要打开从其他计算机连接的关系数据存储，可使用 allowconnection 实用程序。

只能在主关系数据存储计算机上运行 allowconnection 实用程序。

语法

allowconnection <host name> <username> [<database>]

指定要连接到关系数据存储的计算机的名称（主机名）和数据存储使用的一个数据库帐户（用户名）：数据存储管理员、复本所有者、地理数据库管理员或托管用户（发布要素图层数据的用户），您可以使用 listadminusers 实用程序或 listmanageduser 实用程序获取它们。您还可以指定主关系数据存储数据库的名称，但是，因为只有一个数据存储数据库，所以该值可选。

示例

在此示例中，当以 hqo.n_1E7 托管用户身份进行连接时，允许从 workcom 计算机连接到关系数据存储。

allowconnection workcom hqo.n_1E7

backupdatastore

该实用程序可用于所有数据存储类型。

如果您需要在计划的备份期间创建关系数据存储备份，请使用 backupdatastore 实用程序。升级数据存储前或对数据存储进行大量更改前，请使用此实用程序手动创建完整备份。

设置备份位置后，首次运行 backupdatastore 实用程序进行切片缓存数据存储时，备份副本由所有现有的切片缓存数据存储数据库构成。后续使用 backupdatastore 实用程序时，可创建自上次运行该实用程序起创建的任何切片缓存数据存储数据库的备份复本。

设置备份位置后，首次运行 backupdatastore 实用程序进行时空大数据存储时，系统将创建完整备份。因为时空大数据存储可能非常大，所以随后使用 backupdatastore 实用程序创建的备份文件仅包含自初始完整备份起的更改。

backupdatastore 实用程序用于为视频服务数据创建对象存储的完整备份。要素图层查询缓存不包含在备份文件中。

可以在主关系数据存储计算机上运行 backupdatastore 实用程序。此实用程序可在任何切片缓存或时空大数据存储成员计算机上运行。

在任何情况下，都请确保备份空间位置足以容纳备份内容。要更改数据存储备份位置，请使用 configurebackuplocation 实用程序。

有关 ArcGIS Data Store 备份的详细信息，请参阅管理数据存储备份。

语法

backupdatastore [<backup file name>] [--store {relational | tileCache | spatiotemporal | graph | object}] [--location <backup_arguments>] [--prompt {yes | no}]

--location 参数的参数如下且必须用分号 (;) 隔开：

type= - 有效类型为 fs（文件共享）、s3（Amazon Simple Storage Service (S3) 存储段）或 azure（Microsoft Azure Blob 存储容器）。
name= - 如果已向为数据存储配置的备份位置分配名称，则可使用该位置名称来指定在运行 backupdatastore 实用程序时创建备份文件的位置。
location= - 如果没有指定备份位置名称，则必须指定备份 type 和 location。如需共享文件，请提供文件路径。如存储在 S3 存储段，请提供存储段名称。如存储在 Azure Blob 存储容器，请提供容器名称。

示例

在本例中，将使用 backupdatastore 实用程序在为数据存储指定的备份位置处创建名为 project1bu 的完整备份文件。默认情况下，进行关系数据存储时将创建备份；因此，在以下示例中，系统将创建关系数据存储备份。

backupdatastore project1bu

You are going to back up the data store. This could take some time, depending on the size of your data store.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在此示例中，在文件共享位置为时空大数据存储创建了名称为 localbu5 的备份文件，在配置备份位置时您已将该共享位置命名为 gadbu。

backupdatastore localbu5 --store spatiotemporal --location name=gadbu

You are going to back up the data store. This could take some time, depending on the size of your data store.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在此示例中，在名称为 blob4backups 的 Azure Blob 存储容器中创建了时空大数据存储的备份，所创建备份文件的名称为 spds311016：

backupdatastore spds311016 --store spatiotemporal --location type=azure;location=blob4backups

You are going to back up the data store. This could take some time, depending on the size of your data store.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

changebackuplocation

旧版本：

Esri 已弃用 changebackuplocation 实用程序。它仍然存在以允许现有脚本继续运行。使用 configurebackuplocation 实用程序。

changedatastoremode

该实用程序适用于关系和时空大数据存储。

changedatastoremode 实用程序可用于将关系数据存储置于只读模式，同时对数据存储执行维护。例如，如果您需要执行会导致数据存储重启的维护任务（例如，将备份位置从一个驱动器更改为另一个驱动器或更改数据库属性），则您可以将关系数据存储置于只读模式，以便数据存储重启时，无任何用户会处于发布或编辑数据的过程中。

changedatastoremode 实用程序也可在完成维护或为主数据存储计算机增加足够磁盘空间后将关系数据存储转换回读写模式，从而使数据存储在读写模式下可以正常工作。

您必须在主关系数据存储计算机上而非备用计算机上运行 changedatastoremode 实用程序。

注：

如果 ArcGIS Data Store 由于磁盘空间不足而将关系数据存储置于只读模式，则系统也会禁用自动备份以避免进一步填满磁盘。因此，您必须在将关系数据存储转换回读写模式后使用 updatebackupschedule 实用程序重置自动备份计划。

当您的时空大数据存储即将用完磁盘空间时，ArcGIS Data Store 会将其置于只读模式，以避免数据损坏。您可以在为时空大数据存储计算机添加足够的磁盘空间之后，使用 changedatastoremode 实用程序将时空大数据存储返回到读写模式。

语法

changedatastoremode {readonly | readwrite} [--prompt {yes | no}] --store {relational | spatiotemporal}

示例

在此示例中，将关系数据存储恢复为读写模式，意味着客户端可在进行以下操作时恢复此类活动：向 ArcGIS Enterprise 发布托管要素图层、通过托管要素图层编辑数据或将 CSV 文件添加到 Map Viewer。

changedatastoremode readwrite --store relational --prompt no

要将时空大数据存储设置为读写模式，请使用 --store 选项指定 spatiotemporal，如以下示例所示：

changedatastoremode readwrite --prompt no --store spatiotemporal

changedbproperties

该实用程序适用于关系、切片缓存和时空大数据存储。

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

语法

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

以下是支持的配置选项：

disk-threshold-readonly - 仅适用于关系数据存储。
此设置用于控制何时将关系数据存储置于只读模式，以避免由于磁盘空间不足导致的数据丢失。指定大小（以 MB 为单位）。默认磁盘空间值为 1024 MB。
max-connections - 仅适用于关系数据存储。
使用该参数指定关系数据存储所允许的最大连接数。在默认情况下，关系数据存储可最多接受 150 个连接。您可以结合使用 --max-connections 属性和 changedbproperties 实用程序来更改允许的连接数。
当确定数据存储需要的连接数时，请考虑到 ArcGIS Data Store 内部过程最多需要五个连接。另考虑 ArcGIS Data Store 计算机可以接受且仍可以保持性能的并发连接数。如果计算机运行 ArcGIS Data Store 时内存不足，您可能需要减少允许的连接数。
指定的数量不得小于 10。当您更改允许的最大连接数时，将同时更改主数据存储计算机和备用数据存储计算机上的这一数量。该参数不支持时空大数据存储或切片缓存数据存储。
pitr - 仅适用于关系数据存储。
该设置指示 ArcGIS Data Store 是否会创建关系数据存储的增量备份，从而将关系数据恢复至一个时间点。此选项可能的输入为 enable 或 disable。默认情况下，时间点恢复被禁用。
注：
如您将使用 webgisdr 实用程序创建 ArcGIS Enterprise 部署的增量备份，则必须启用时间点恢复。
enablessl - 仅适用于关系和切片缓存数据存储。
此参数可控制在填充切片缓存数据存储时以及针对关系数据存储与托管服务器之间的通信使用传输层安全性 (TLS) 协议。
enablessl 参数的受支持参数如下：
- true - 这是默认设置。这意味着，当您指定 --store tileCache，将场景图层数据写入切片缓存数据存储时，以及指定 --store relational，在关系数据存储与托管服务器之间进行通信时，将使用传输层安全协议。
- false - 指定 false 和 --store tileCache 在写入切片缓存数据存储时，通过托管服务器进行 HTTP 通信。指定 false 和 --store relational 在托管服务器与关系数据存储之间使用 HTTP 通信。
heap-size - 仅适用于时空大数据存储。
使用该参数更改用于时空大数据存储的堆内存数（以 MB 为单位）。默认情况下，启动此类型的数据存储将使用一半的计算机 RAM（高达 70% 的可用 RAM）。您可以将堆大小更改为介于 512 MB 和 32,000 MB 之间的数量，但请确保指定的数量不超过计算机上可用的数量。
rebalance - 仅适用于时空大数据存储。
默认情况下，该参数设置为 true，这意味着如果任何一台计算机不可用，则时空大数据存储中的数据将数据分发到其他计算机。如果需要在一个时空大数据存储计算机上执行维护（例如对其进行升级），则可以通过将此参数设置为 false 来临时关闭重新均衡。重新平衡选项将在为 max-rebalance-off 参数设置的分钟数内暂停。
max-rebalance-off - 仅适用于时空大数据存储。
当 rebalance 参数设置为 false 时，使用此参数的设置。默认情况下，max-rebalance-off 设置为 60 分钟。这意味着，如果您临时关闭重新均衡，它将在 60 分钟后再次启动。如果您需要的时间多于或少于执行暂停重新平衡维护任务的时间，请更改 max-rebalance-off 的时间设置。
prompt - 您运行该实用程序时，系统将提示您确认指定的操作。如果您自动使用此实用程序，则将提示参数设置为“否”；否则必须回答提示问题，脚本才会继续。

示例

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

更改关系数据存储的只读阈值

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

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

You are changing the following database properties:
         ...disk space threshold to change relational data 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 --store relational --max-connections 100

You are changing the following database properties:
         ...max number of connections to 100 (on all relational data 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 --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 --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（及 70% 的可用 RAM）。减小堆大小可能会阻止数据存储启动。如果增加堆大小，请勿指定超出计算机可用 RAM 数量的数字。

在此示例中，堆大小设置为 1,600 MB。

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

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

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

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

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

changeloglocation

该实用程序可用于所有数据存储类型。

如果不希望数据存储使用 <ArcGIS Data Store directory>\arcgisdatastore\logs 的默认错误日志文件位置，则可以运行 changeloglocation 实用程序在其他目录中创建错误日志文件。

ArcGIS Data Store 帐户必须具有您指定的文件夹的写入权限。

语法

changeloglocation <directory path>

示例

在本示例中，将在本地目录 d:\datastorefiles\logs 中创建日志文件。

changeloglocation 'd:\datastorefiles\logs'

changenosqldslocation

该实用程序适用于切片缓存数据存储。

如果您在切片数据存储中存储了大量高分辨率切片，则切片缓存数据存储可能会变大。在这种情况下，您可能需要将数据移动到同一服务器的另一驱动器中，或者移动到另一服务器的共享位置处。

如果您将数据移动到共享目录，必须向运行 ArcGIS Data Store 进程 (Linux) 或服务 (Microsoft Windows) 的用户授予目录的读写权限。

语法

changenosqldslocation <path> [--prompt {yes | no}]

示例

在本示例中，将在计算机 server2 上名为 dstorecache 的共享目录下创建存储场景图层缓存的数据库。

changenosqldslocation \\server2\dstorecache

changepassword

该实用程序适用于关系数据存储。

ArcGIS Data Store 将为关系数据存储使用的数据库帐户随机生成用户名和密码。如果您的站点要求设置您自己的密码，则获取数据存储帐户的密码，然后运行 changepassword 来重置密码。

使用 listadminusers 实用程序获取管理员用户的用户名和密码；使用 listmanageduser 实用程序获取要素数据所有者的用户名和密码。

只能在主关系数据存储计算机上运行 changepassword 实用程序。

语法

changepassword <username> <new password> [--prompt {yes | no}]

提示：

如果需要编写密码更改脚本（包括禁用确认提示符的标记），则请按以下示例操作：

changepassword gwi_n2Te0 Phfl4mp --prompt no

示例

在本示例中，用户 gwi_n2Te0 的密码被更改为 Phfl4mp!。

changepassword gwi_n2Te0 Phfl4mp

You are going to change the password for user gwi_n2Te0.
Do you want to continue (Yes or No)?Yes

changestaginglocation

该实用程序适用于关系和切片缓存数据存储以及图形存储。

恢复关系或切片缓存数据存储后，ArcGIS Data Store 会在过渡位置提取压缩的备份文件。这表示您必须具有可兼容此未压缩数据的过渡位置。如果关系或切片缓存数据存储中存在大量数据，请设置单独过渡位置并为恢复操作指定单独过渡位置。

相似地，如果使用 configurebackuplocation 实用程序为关系存储、切片存储或图形存储备份文件定义 S3 存储段或 Azure BLOB 存储容器，则在将备份文件复制到云存储位置之前，将使用过渡位置来打包备份文件。

语法

changestaginglocation <directory path>

示例

本例中指定的过渡位置是 \\netserver\rbustage。

changestaginglocation \\netserver\rbustage

configurebackuplocation

该实用程序可用于所有数据存储类型。

使用 configurebackuplocation 实用程序可以指定 ArcGIS Data Store 为计划备份以及使用 backupdatastore 实用程序创建的备份写入备份文件的位置。您还可以通过 configurebackuplocation 实用程序更改备份位置的属性并移除备份位置。

使用默认的本地备份位置创建关系数据存储。为避免数据损失，可通过使用 change 选项注册远程文件共享，以配置默认备份位置。

以主-备用模式创建的切片缓存数据存储将具有默认备份位置；而以集群模式创建的切片缓存数据存储则没有该位置。无论哪种情况，都可使用 register 选项运行 configurebackuplocation 实用程序，以指定共享网络位置、Amazon Simple Storage Service (S3) 存储段或 Microsoft Azure Blob 存储容器，从而安全地存储切片缓存数据存储备份。如果数据存储正在集群模式下运行，则不能将本地驱动器用于切片缓存备份文件。

将不会使用默认备份位置创建时空大数据存储、图谱存储和对象存储。开始创建备份前，必须使用 register 选项运行 configurebackuplocation 实用程序，以为这些备份指定文件共享位置、Amazon Simple Storage Service (S3) 存储段或 Microsoft Azure Blob 存储容器。

注：

时空大数据存储备份文件不能使用本地驱动器。

您可以注册第二个备份位置，以存储使用 backupdatastore 实用程序创建的备份。可以使用共享文件目录、S3 存储段或 Azure Blob 存储容器作为辅助备份位置。

有关 ArcGIS Data Store 备份的详细信息，请参阅管理数据存储备份。

语法

configurebackuplocation --store {relational | tileCache | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]

所需选项包括以下内容：

--store {relational | tileCache | spatiotemporal | graph | object} - 指定您要配置或查询备份位置的 ArcGIS Data Store 的类型。默认值为 relational。
--operation {change | register | unregister | list | setdefault} - 默认值是 change。以下是对各参数的解释：
- change - 使用此参数可更改以下任意内容：
  - 为计划关系数据存储备份指定其他的共享文件位置。使用 change 参数设置的位置将始终作为关系数据存储的默认备份位置。
  - 更改您分配到备份位置的名称。
  - 更新您在 Azure 或 S3 上为备份位置设置的身份验证信息。对于 S3，您可以使用 username 和 password 选项更改您之前指定的信息。对于 Azure，您可以更改 password 值。
- register - 使用此参数以注册备份位置。您为以集群模式运行的时空大数据存储、图谱存储或切片缓存数据存储定义的第一个备份位置将被设置为默认备份位置。当您为切片缓存数据存储（主-备用或集群模式）、时空大数据存储或图谱存储注册另一个备份位置时，将注册一个辅助备份位置。
  使用关系数据存储指定 register 参数时，将始终注册一个辅助备份位置。可以使用该辅助备份位置来存储使用 backupdatastore 实用程序生成的手动备份。
  注：
  使用 register 参数时，必须为 --location 选项提供信息。
- unregister - 可以使用此参数从数据存储中移除辅助备份位置。如果仅注册一个备份位置，则可以使用取消注册参数以完全移除切片缓存或时空大数据存储或图谱存储的备份位置。
- list - 列出为使用 --store 选项指定的数据存储注册的所有备份位置。该列表将指示物理备份位置、备份位置的名称（如果在注册位置时已指定一个名称）以及注册为默认备份位置的位置。
- setdefault - 如果图谱存储、切片缓存数据存储或时空大数据存储有多个备份位置，则可以使用 setdefault 以指定其中一个备份位置作为默认位置。该位置是计划备份的写入位置，如果在不指定备份位置的情况下运行 backupdatastore、listbackups 或 restoredatastore 实用程序，则该位置也会用作默认位置。

当注册或更改备份位置时，请使用 --location 选项以指定 ArcGIS Data Store 存储备份文件的位置。如果未配置备份名称，则在设置默认备份位置或者移除备份位置时，请使用 --location 选项。

对于切片缓存数据存储和时空大数据存储或注册关系数据存储的辅助备份位置，请指定以分号 (;) 分隔的以下参数：--location "type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>]"。

以下列表中提供了 --location 选项支持的每个参数的说明：

type= - 此参数为必需项。指定备份所使用的位置类型。可指定 s3 在 Amazon S3 存储段中存储备份，指定 azure 以在 Azure Blob 存储容器中存储备份，或指定 fs 以在文件共享中存储备份（此为默认设置）。
location= - 此参数为必需项。如需共享文件，请指定文件路径。对于 Amazon S3 存储段，请指定存储段名称和存储段的路径。对于 Blob 存储容器，请指定容器名称和容器的路径。
name= - 可为备份位置分配一个名称。例如，如果备份位置是文件路径，如 \\sharedserver_sharedfolders_datastorebackups，则可为该位置指定一个名称，如 dsbackups。在运行 backupdatastore、listbackups 或 restoredatastore 实用程序时，请提供该名称，而不必提供整个路径。
如果在配置数据存储备份位置时没有提供名称，则 ArcGIS Data Store 会分配一个默认名称。
username= - 如果备份位置为 S3 存储段或 Blob 存储容器，则此参数为必需项。 S3 存储段需要您提供 Amazon Web Services (AWS) 帐户访问密钥 ID。 Azure Blob 存储容器需要您提供能访问该 Blob 存储容器的 Microsoft Azure 存储帐户名称。
password= - 如果备份位置为 S3 存储段或 Blob 存储容器，则此参数为必需项。 S3 存储段需要您提供 AWS 帐户保密密钥。 Azure Blob 存储容器需要您提供使用 username 参数指定的 Azure 帐户的密钥。
endpointsuffix= - 该参数用于指示 Azure Blob 存储容器所在位置。默认情况下，endpointsuffix 假定为 core.windows.net。如果容器在 Microsoft Azure Government 云端环境中，请设置 endpointsuffix=core.usgovcloudapi.net。如果容器在私有云中，请将 endpointsuffix 设置为 Azure 私有云的 EndpointSuffix。仅当将备份存储在 Azure Blob 存储容器中时，才会使用此参数。
region= - 如果备份位置为 S3 存储段，则此参数为必需项。您必须提供地区代码。例如，如果存储段部署在亚太（悉尼）地区，请将该地区设置为 ap-southeast-2。有关地区代码，请参阅 AWS 文档。

您可以为 configurebackuplocation 实用程序提供的其他选项如下：

--force {true | false} - 此选项仅配合关系数据存储使用，可用于更改默认备份位置，即使现有默认备份位置不可用时也是如此。
更改关系数据存储的默认备份位置时，ArcGIS Data Store 会将现有备份文件从旧位置复制到新位置。如果 ArcGIS Data Store 无法访问旧位置，则无法复制文件。在之前版本中，这可能会造成 configurebackuplocation 工具运行失败。如果您希望继续更改默认备份位置，而不复制现有备份文件，请指定 --force true。
此选项的默认值为 false，这意味着如果 ArcGIS Data Store 无法访问现有默认位置，则您无法更改默认备份位置。
--prompt {yes | no} - 默认值是 yes。

示例

下面几节提供了更改、设置或列出数据存储的备份位置的示例。

更改关系数据存储的默认备份位置

在第一个示例中，关系数据存储的备份位置设置为计算机 myshare 上名为 fsdata_bu 的目录。

configurebackuplocation --operation change --store relational --location "type=fs;location=\\myshare\fsdata_bu"

You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)? Yes

添加关系数据存储的备份位置

在此示例中，将在 Azure 上为同一个相关数据存储注册第二个备份位置。

configurebackuplocation --operation register --store relational --location "type=azure;location=mybackups;
name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"

You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)? Yes

设置图谱存储的备份位置

在此示例中，为图谱存储注册了网络共享上的备份位置。 fshare 名称会分配到备份位置。

configurebackuplocation --operation register --store graph 
--location "type=fs;location=\\sharedmachine\g_bu;name=fshare"

添加备份位置并设置默认位置

在此示例中，将为个时空大数据存储指定第二个备份位置。其他备份位置位于 Azure 存储中。

configurebackuplocation --operation register --store spatiotemporal --location "type=azure;location=myblobs;
name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount"

在本示例中，将在 AWS 上为同一个时空大数据存储指定欧洲（西班牙）地区中的第二个备份位置。 awsloc 名称会分配到备份位置。

configurebackuplocation --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;
username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2"

在此示例中，使用备份位置的名称 (awsloc) 将 S3 存储段设置为时空大数据存储的默认备份位置。

configurebackuplocation --operation setdefault --store spatiotemporal --location "name=awsloc"

获取数据存储的所有备份位置的列表

在此示例中，列出了时空大数据存储的所有备份位置。

configurebackuplocation --operation list --store spatiotemporal
Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       \\sharedmachine\ge_bu        false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false

configuredatastore

该实用程序可用于所有数据存储类型。

安装 ArcGIS Data Store 后，您可运行 configuredatastore 实用程序创建数据存储并将其注册到 GIS Server 站点。您可使用此实用程序创建以下数据存储类型：

更新数据存储中所有计算机上的 ArcGIS Data Store 软件后，您还可以运行 configuredatastore 实用程序来升级数据存储。

语法

configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores {relational | tileCache | spatiotemporal | graph | object}] [--mode {singleInstance | primaryStandby | cluster}]

<ArcGIS Server admin URL> - 此为已用作或将用作 ArcGIS Enterprise 托管服务器的 GIS Server 站点。 ArcGIS Server 管理 URL 的格式为 https://gisserver.domain.com:6443。
注：
即使 GIS Server 站点使用 web 适配器或负载均衡器，您也必须提供前面所提及格式的 URL。
<ArcGIS Server administrator> - 为在 GIS Server 站点中具有管理员权限的内置（非组织特定）用户提供用户名。
<ArcGIS Server administrator password> - 提供上述所使用帐户的密码。
<data directory> - 数据目录是在本地计算机上您要创建数据存储文件的位置。
{relational | tileCache | spatiotemporal | graph | object} - 指定要创建的数据存储的类型。虽然您可以指定由逗号分隔（不含空格）的每种存储类型以在同一台计算机上配置多个类型的数据存储，但不建议您这样操作。例如，要在同一台计算机的共享数据存储目录下配置关系和切片缓存数据存储，请指定 --stores relational,tileCache。Esri 强烈建议您在独立于其他数据存储或软件的计算机上运行时空大数据存储和图谱存储。如果不这样做，则可能导致性能下降，甚至导致数据存储不可用。
--mode - 此可选选项仅适用于切片缓存数据存储、对象存储和图谱存储。默认情况下，切片缓存数据存储、图谱存储和对象存储将在 primaryStandby 模式下创建。
以 primaryStandby 模式创建的切片缓存数据存储可包含两台计算机。备用切片缓存数据存储中包含的数据与主数据存储相同。如果主数据存储运行失败，则备用数据存储将成为主切片缓存数据存储。如果您需要存储大量的场景图层缓存，并因此需要切片缓存数据存储进行扩展以包括三台或更多台计算机，请在 cluster 模式创建切片缓存数据存储。可以使用模式选项将切片缓存数据存储从 primaryStandby 模式切换到集群模式。
以 primaryStandby 模式创建的对象存储当前仅可包含一台计算机。如果在对象存储中需要多台计算机以提供高可用性，可以以集群模式部署对象存储。使用集群模式时，对象存储必须包含至少三台计算机。有关详细信息，请参阅向数据存储添加计算机。

配置数据存储的特定类型

您可以使用 --stores 选项的以下设置来指定要创建的数据存储类型：

relational
tileCache
spatiotemporal
graph
object

要在同一计算机上配置多个数据存储类型，请使用逗号来分隔各个类型。例如，要在同一台计算机上配置关系和切片缓存数据存储，请指定 --stores relational,tileCache。

注：

在同一计算机上配置的数据存储将争抢内存和其他资源，这对性能有消极影响，并可能会造成数据存储停止工作。对于时空大数据存储、图谱存储和对象存储则更是如此；不要在同一计算机上将时空大数据存储、图谱存储或对象存储配置为其他数据存储或其他 ArcGIS 组件。

如果要编写创建多个时空大数据存储计算机的脚本，则必须通过 GIS Server 站点手动配置一台时空大数据存储计算机，然后才可编写创建其他时空大数据存储计算机的脚本。在您的脚本中包括等待时间，以确保不会同时添加其他时空大数据存储计算机。

有关详细信息，请参阅创建数据存储。

在升级 ArcGIS Data Store 安装文件后配置数据存储。

作为升级 ArcGIS Data Store 的一部分，您必须对现有数据存储计算机进行配置。在每台数据存储计算机上安装完成新版 ArcGIS Data Store 并取代现有 ArcGIS Data Store 后，可登录任何数据存储计算机，并运行 configuredatastore 实用程序以结束特定数据存储的升级。例如，您可以在主关系数据存储计算机上运行 configureatastore，而备用计算机也会升级。

如果计算机同时包含关系和切片缓存数据存储，则在运行 configuredatastore 实用程序时指定 --stores relational,tileCache，这将升级两个数据存储中的全部计算机。

要重新配置升级后的时空大数据存储计算机，请登录到时空大数据存储中的任何一台计算机，然后运行 configuredatastore 实用程序。这将对时空大数据存储中的所有计算机进行升级。

如果尚未在所有计算机上安装新版本 ArcGIS Data Store，则配置无法进行。

有关详细信息，请参阅升级 ArcGIS Data Store。

更改切片缓存数据存储模式

要确定切片缓存数据存储设置的当前模式，请在切片缓存数据存储计算机上运行 describedatastore 实用程序。

如果您需要将切片缓存数据存储模式从 primaryStandby 更改为集群模式，请在运行 configuredatastore 实用程序时将 --mode 选项设置为 cluster。

注：

可以使用 --mode 选项在创建数据存储或者将切片缓存数据存储模式从主-备用模式更改为集群模式时，指定切片缓存数据存储、对象存储或图谱存储模式，但在升级切片缓存数据存储时您将无法更改此模式，无法将切片缓存数据存储模式从集群模式更改为主-备用模式，也无法更改对象存储或图谱存储的模式。

示例

在该示例中，创建了托管要素图层数据的数据存储（关系数据存储）。 GIS Server 站点中使用数据存储的 URL 是 https://gisserver.domain.com:6443，站点管理员用户名和密码分别为 admin 和 Iph33l$ik，数据存储的数据目录是 C:\datastore\data\。

configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\data\ --stores relational

在以下示例中，现有切片缓存数据存储（主-备用）被更改为集群模式：

configuredatastore https://gisserver.mydomain.com:6443 portaladmin S00perSecret c:\datastore\scenedata\ --stores tileCache --mode cluster

configureserviceaccount

该实用程序可用于所有数据存储类型。

configureserviceaccount 实用程序可更改 ArcGIS Data Store 帐户使用的登录信息。使用该实用程序设置帐户时，可将帐户信息导出到文件中。注意，文件中密码已加密。在某些情况下您可以使用该文件来导入同一帐户信息，例如，设置另一 ArcGIS Data Store 并希望使用相同的帐户时。在这种情况下，则在新的计算机上运行 configureserviceaccount 实用程序并导入包含帐户信息的文件。

您也可以使用此实用程序更新 ArcGIS Data Store 帐户的密码。如果 Windows 帐户密码发生变化，则运行该实用程序并为帐户指定新的密码。

如果您将 ArcGIS Data Store 帐户设置为组托管服务帐户，则您指定了用户名参数的帐户可以在帐户名称末尾包括 $ 或将其省略。使用组托管服务帐户时，不需要指定密码参数。

语法

configureserviceaccount [--username <Windows account>] [--password <account password>] [--readconfig <user configuration file>] [--writeconfig <user configuration file>]

示例

在此示例中，configureserviceaccount 设置 mynetwork\datastore 帐户以运行 ArcGIS Data Store 服务并授予此帐户 ArcGIS Data Store 系统文件夹和文件的所需权限。

configureserviceaccount --username mynetwork\datastore --password SewL0ng

在本示例中，针对 ArcGIS Data Store 帐户使用了组托管服务帐户：

configureserviceaccount --username mydomain\datastore-gmsa$ --writeconfig c:\temp\domainaccountconfig.xml

请注意服务运行时更改帐户可导致服务重新启动。

在此示例中，ArcGIS Data Store 帐户已更改，且帐户信息已写入位于 C:\adminfiles 的文件 (adsainfo) 中。

configureserviceaccount --username mynetwork\datastore --password SewL0ng --writeconfig C:\adminfiles\adsainfo.xml

在此示例中，ArcGIS Data Store 安装在不同的计算机上，且管理员使用在上一示例中创建的文件运行 configureserviceaccount 实用程序以设置同一帐户。

configureserviceaccount --readconfig C:\adminfiles\adsainfo

deletebackup

此实用程序与关系数据存储和对象存储配合使用。

deletebackup 实用程序用于删除为关系数据存储或对象存储创建的备份文件。首先，可以运行 configurebackuplocation 实用程序并将 --operation 选项设置为 list 以获取为数据存储配置的所有备份位置的列表。接下来，对其中一个位置运行 listbackups 实用程序，以查看该位置中备份的名称和创建时间。针对每个备份位置重复该步骤。然后，您可以运行 deletebackup 实用程序以删除不再需要的备份文件。必须为要删除备份文件的每个位置单独运行 deletebackup。

注：

您只能删除恢复数据存储时不需要的备份。例如，您不能删除关系数据存储的最近完整备份。

语法

deletebackup <backup name> [--store {relational | object}] [--location "<backup-location>"] [--prompt {yes | no}]

示例

在以下示例中，将从默认备份位置删除名为 featuresMarchbu 的关系数据存储备份。

deletebackup featuresMarchbu --store relational
You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible.

Do you wish to continue (Yes or No)?yes

Operation completed successfully

在本示例中，将从名为 videobucket 的备份位置删除对象存储的 june-videobu。

deletebackup june-videobu --store object -- location "videobucket"
You are attempting to delete backup 'june-videobu'. This operation is irreversible.

Do you wish to continue (Yes or No)?yes

Operation completed successfully

describedatastore

该实用程序可用于所有数据存储类型。

通过 describedatastore 实用程序，您可以查看有关 ArcGIS Data Store 安装的以下信息：

在计算机上安装的数据存储类型（在可用 ArcGIS 数据存储下列出）
注：
如果在计算机上安装了数据存储，但未对其进行配置，则其将显示为可用 ArcGIS Data Store，但不会返回该数据存储类型的其他信息。
ArcGIS Data Store 安装的软件版本号
用于恢复数据的数据存储所使用的过渡位置
数据存储的日志文件位置
已安装 ArcGIS Data Store 的计算机上的剩余可用磁盘空间量
关系和时空大数据存储将置于只读模式且切片缓存数据存储将停止的可用磁盘空间阈值
每种类型的数据存储所使用的默认备份位置
关系或切片缓存数据存储的备份位置是否已在网络上共享
数据存储创建备份的频率（备份计划）
保留关系数据存储备份文件的天数和是否可以将关系数据存储恢复至特定时间点
数据存储是否正在运行（数据存储状态）
是否在关系数据存储上启用 SSL 通信
备用图谱存储、关系数据存储或切片缓存数据存储（主-备用模式）成为主数据存储的日期和时间（上次故障转移）；如果从未发生故障转移，则不会显示此属性
参与关系或切片缓存数据存储的计算机的名称（成员计算机）
关系数据存储允许的最大连接
数据存储注册到 GIS Server 站点的 URL（所属系统 URL）
使用 GIS Server 站点作为其托管服务器的门户 URL（门户 URL）
连接到关系数据存储的当前要素图层数
当前参与时空大数据存储的所有计算机的列表（时空集群中的计算机）
当前指定为协调计算机的时空大数据存储内部的计算机（集群内的当前协调计算机）
切片缓存、时空大数据存储集群或者图谱或对象存储中所有计算机的列表（已注册的<数据存储类型>计算机）；显示所有计算机（无论其处于何种状态）
为切片缓存数据存储、对象存储或图谱存储配置的部署模式
关系或时空大数据存储是否为读写或只读模式（数据存储模式）

语法

describedatastore

示例

describedatastore 实用程序将返回适用于计算机上所有数据存储的常规信息并返回包含特定于每种类型数据存储信息的单独部分。

您应该将不同的数据存储放置在不同的计算机上，但是要允许查看每种类型返回的信息，以下输出显示了在同一台计算机具有所有 ArcGIS Data Store 类型的计算机上。第一部分（常规信息）始终返回。 describeatastore 返回的数据存储部分取决于计算机上存在的数据存储类型。

describedatastore

Available ArcGIS Data Stores
==============================================================
Relational Data Store
Tile Cache Data Store
Spatiotemporal Big Data Store
Graph Store
Object Store

General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....11.2.0.1234
Staging location.............C:\arcgisdatastore\staging
Log location.................C:\arcgisdatastore\logs
Free disk space..............174.00GB
Threshold for READONLY mode..2048MB

Information for relational data store ds_sthiu0_5T
==============================================================
Backup location...........\\nwshare\dsbackups
Is backup folder shared...true
Backup schedule...........{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained......31
Data store status.........Started
SSL enabled...............true
Last failover.............20150130190334005
Member machines...........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM
Maximum connections.......150
Owning system URL.........https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal
Number of connections.....8 connection(s) to managed database
Data Store mode.....................READWRITE
Is Point-in-time recovery enabled...No
Query optimizer enabled.............Yes

Information for tile cache data store ds_wztxj7um
==============================================================
Data location...................C:\arcgisdatastore\nosqldata
Data store status...............Started
Backup location.................\\mybackups\scenebackup
Backup schedule.................{schedule-frequency":"Every 1 DAYS"}
Is backup folder shared.........true
Mode............................cluster
Member tile cache machines......MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Registered tile cache machines..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...............https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL...........https://portal_webadaptor.domain.com/portal

Information for spatiotemporal data store ds_qpko99Cl
==============================================================
Backup location.....................\\nwshare2\sbds_bu
Max rebalance off time..............60 minutes
Automatic rebalance ................On
Machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Current coordinator in cluster......MACHINE1.DOMAIN.COM
Registered spatiotemporal machines..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal
Data Store mode.....................READWRITE

Information for graph store x2b7s0n
==============================================================
Deployment mode..................primaryStandby
Access endpoint..................MACHINE1:9829
Backup location..................\\nwshare3\graphbu
Registered graph store machines..MACHINE1.DOMAIN.COM
Owning system URL................https://gisserver_webadaptor.domain.com/server
Portal for ArcGIS URL............https://portal_webadaptor.domain.com/portal

Information for object store w1tiknx
==============================================================
Deployment mode...................singleInstance
Access endpoint...................MACHINE1:9900
Backup location...................\\nwshare4\myfiles\ods_bu
Registered object store machines..MACHINE1.DOMAIN.COM
Owning system URL.................https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL.............https://portal_webadaptor.domain.com/portal

磁盘清理

该实用程序适用于关系、切片缓存和时空大数据存储。

磁盘清理实用程序将移除操作（例如 restoredatastore 和升级 ArcGIS Data Store）留下的临时文件。升级后会保留某些文件，以便您对失败的升级或恢复操作进行故障排除。确认升级或恢复操作成功并且系统按预期工作后，您可以运行此工具来移除这些临时文件并重新获得数据存储计算机上的可用磁盘空间。

此实用程序每次清理一台计算机上的磁盘空间。如果您需要清理同一数据存储中多台计算机上的文件，则必须在每台计算机上运行该工具。

语法

diskcleanup

示例

要运行磁盘清理实用程序，必须确认要继续。

diskcleanup

You are attempting to cleanup some archived data generated as part of ArcGIS Data Store upgrades or backup-restore operations. Once removed, this data can't be recovered. Do you want to continue (Yes or No)?

exportmanageddb

旧版本：

Esri 已在 10.5.1 上弃用了 exportmanageddb 实用程序。此功能已整合到 backupdatastore 实用程序中。改用 backupdatastore 实用程序来创建备份文件。

importmanageddb

旧版本：

importmanageddb 实用程序在其相关实用程序—exportmanageddb—被弃用后，保留了几个版本以允许您使用较旧的导出文件。但是，从 ArcGIS Data Store 11 开始，使用 backupdatastore 实用程序创建备份文件并使用 restoredatastore 实用程序从备份文件恢复数据存储，而不是从导出文件导入关系和切片缓存数据存储。

listadminusers

该实用程序可用于所有数据存储类型。

Listadminusers 实用程序针对关系数据存储的管理员、复本所有者和地理数据库管理员返回用户名和密码。该实用程序返回切片缓存和时空大数据存储和图谱存储的管理员。

语法

listadminusers

示例

在此示例中，listadminusers 在仅安装了关系数据存储的计算机上运行。

listadminusers

Admin users for relational data store ds_abcd1234
=================================================
Database Admin User.... adm_32ret / tT30sbYk22jF
Database Repl User..... dsrepuser / uWn/MV0678h4
GDB Admin User......... sde / iO=Qst751epb

在此示例中，listadminusers 在仅安装了时空大数据存储的计算机上运行。

listadminusers

Admin users for spatiotemporal big data store bds_abcd1234
=================================================
Store admin user.... els_321ret / B1as70fF1

在此示例中，listadminusers 在仅安装了图谱存储的计算机上运行。

listadminusers

Admin users for graph store s2t0ic1
=================================================
Store admin user....root / ypz5kx2c5tk4fequ

在此示例中，listadminusers 在仅安装了对象存储的计算机上运行。

listadminusers

Admin users for object store w1tiknx
=================================================
Store admin user....n6o96nl53vzkm36d / bpvifyjz73xwhot4

listbackups

该实用程序可用于所有数据存储类型。

当关系数据存储运行时，listbackups 实用程序将仅在主数据存储计算机中运行。

运行 listbackups 实用程序以确定以下内容：

备份操作开始的时间
备份已完成，还是仍在运行
备份是使用 backupdatastore 实用程序创建，还是由 ArcGIS Data Store 自动创建
您拥有的备份文件数量，用于确定是否需要删除任何文件
运行 deletebackup 实用程序之前，需要确认备份文件名称

运行 listbackups 实用程序时，请为备份文件列表指定备份位置。如果未指定位置，listbackups 实用程序会为默认备份位置返回备份。

语法

listbackups [--store {relational | tileCache | spatiotemporal | graph | object}] [--location <location_arguments>]

如果您没有指定数据存储类型，实用程序会默认选择 relational，并返回此计算机上运行的关系数据存储的备份。如果运行该实用程序的计算机上不存在关系数据存储，则该实用程序将返回错误消息。

location 参数用于指示备份文件的存储位置。参数如下：

name=：备份位置名称。在配置备份位置时指定该名称，或如果未指定名称，ArcGIS Data Store 会分配一个默认名称。
location=：共享文件目录的路径、S3 存储段或者 Blob 存储容器。

示例

在本示例中，将列出关系数据存储默认备份位置的备份：

listbackups --store relational

Backup_Name              Status           Backup_Time         Mode
=======================================================================
phase1proj_bu            BackupComplete   2023-03-08 14:12    manual
phase2proj_bu            BackupComplete   2023-02-21 11:43    manual
ds_gdt1omh-2023020130    BackupComplete   2023-02-01 03:00    scheduled

Backups located at: '\\myserver.net.com\dsbackups'

在本例中，为名称为 sbdsbu 的备份位置列出了时空大数据存储备份：

listbackups --store spatiotemporal --location "name=sbdsbu"

Backup_Name          Status           Backup_Time         Mode
==================================================================
backup1						        BackupComplete   2023-07-11 09:47    manual

Backups located at: '\\myserver.net.com\spatiotemporal'

listdatasources

该实用程序适用于时空大数据存储。

由于 10.8.1 中的漏洞，使用方形或六边形聚合的 ArcGIS GeoEvent Server 地图服务在升级到 10.9 或更高版本后不会渲染。要更正此问题，您可以运行 listdatasources 实用程序获取 GeoEvent Server 地图服务的名称，并使用通过 upgradedatasource 实用程序返回的服务名称来更新各个服务的数据。

listdatasources 实用程序可以在时空大数据存储中的任何计算机上运行。

语法

listdatasources

示例

在命令提示符处运行 listdatasources 实用程序以返回 GeoEvent Server 地图服务列表。

listdatasources

listmanageduser

该实用程序可用于所有数据存储类型。

listmanageduser 实用程序将返回关系和时空大数据存储中托管要素图层数据所有者帐户的用户名和密码。此实用程序还将返回切片缓存数据存储场景缓存所有者和图谱存储中图谱所有者的用户名和密码。

语法

listmanageduser

示例

在以下示例中，listmanageduser 在包含关系和切片缓存数据存储的计算机上运行。此计算机为主关系数据存储。

listmanageduser

Managed user for relational data store ds_abcd1234
===================================================
UserName     Password       Database
gwi_n2Te0    4cXddhZhve=Y   db_qv5e1

Managed user for tile cache data store tcs_e41f0rj2
===================================================
UserName     Password
usr_n8778    y47ccno913

在本例中，listmanageduser 在时空大数据存储计算机上运行。

listmanageduser

Managed user for spatiotemporal big data store bds_6udbx4321
=============================================================
UserName     Password
fmr_o1He3    5vZggkPbaw+T

在以下示例中，listmanageduser 在图谱存储计算机上运行。

listmanageduser

Managed user for graph store s2t0ic1 
================================================ 
UserName   Password 
mu_vwmp8c6 m5c2so76y3b0qczf

在以下示例中，listmanageduser 在对象存储计算机上运行。

listmanageduser

Managed user for object store w1tiknx
=============================================================
Store credential........n6o96nl53vzkm36d / bpvifyjz73xwhot4

registerdatastore

该实用程序可用于所有数据存储类型。

数据存储保留有关 GIS Server 站点计算机名称的信息。如果您将 GIS Server 站点移动到新的计算机上（例如，如果您获得新的硬件或者现有的 GIS Server 计算机出现故障），您必须从 GIS Server 站点中取消注册数据存储才能移除该信息。在一台或多台新计算机上配置 GIS Server 后，您可以使用 registerdatastore 实用程序将数据存储注册到 GIS Server 站点。

注：

registerdatastore 实用程序用于将数据存储注册到之前注册到的同一 GIS Server 站点。数据存储包含现有 GIS Server 站点上的托管图层的数据。将其注册到其他 GIS Server 站点不会重新创建托管图层。

可在主关系数据存储计算机或运行在主-备用模式下的切片缓存数据存储或对象存储的主计算机上运行 registerdatastore 实用程序。该实用程序可在任何切片缓存数据存储或以集群模式运行的对象存储或时空大数据存储计算机上运行。

语法

registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator username> <ArcGIS Server site administrator password> --stores {relational | tileCache | spatiotemporal | graph | object}

如果您在同一台计算机上安装了多个不同类型的数据存储，则您可通过指定用逗号分隔（不含空格）的数据存储类型同时注册这些数据存储；例如，输入 --stores relational,tileCache。

示例

在本示例中，关系数据存储使用 URL GIS Server 重新注册到 https://gisserver.domain.com:6443 站点。 ArcGIS Server 主站点管理员用户名为 agsadmin，密码为 Tan$p0n。

registerdatastore https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational

removemachine

该实用程序适用于关系、切片缓存和时空大数据存储和图谱存储。

使用 removemachine 实用程序从包含多台计算机的数据存储中移除计算机。可将 removemachine 实用程序用于以下场景：

从关系数据存储或图谱存储中移除备用计算机。可在备用计算机上运行此实用程序；如果备用计算机不可用，也可在主计算机上运行。
从切片缓存数据存储中移除计算机。可以在切片缓存数据存储中的任何计算机上运行此实用程序，但是不能在仅由一台计算机组成的切片缓存数据存储上运行 removemachine。
从时空大数据存储中移除计算机。可以在时空大数据存储中的任何计算机上运行此实用程序，但是不能在仅由一台计算机组成的时空大数据存储上运行 removemachine。

语法

removemachine <machine name> --store {relational | tileCache | spatiotemporal | graph} [--force {true | false}] [--prompt {yes | no}]

--force - 默认情况下，此选项被设置为 false。只有在已注册的 ArcGIS Server 站点可用时，才能将此选项指定为 true。

--prompt - 默认情况下，此选项被设置为 yes。如果不想确认操作，则将此选项指定为 no。

示例

在此示例中，时空大数据存储计算机 gefour 已从数据存储中移除。

removemachine gefour --store spatiotemporal

在此示例中，托管服务器站点不可用，并从数据存储中移除了名为 fsdata 的关系数据存储计算机。

removemachine fsdata --store relational --force true

removestandbymachine

旧版本：

Esri 已弃用 removestandbymachine 实用程序。它仍然存在以允许现有脚本继续运行，但您应开始改用 removemachine 实用程序。

restoredatastore

该实用程序可用于所有数据存储类型。

如果您无法访问托管图层所使用的数据，请使用备用文件和 restoredatastore 实用程序来恢复数据存储。

如果无法恢复数据存储，请在新计算机上安装 ArcGIS Data Store，请勿配置数据存储，然后将上次完整备份恢复到新计算机。

如果您使用关系数据存储且要将托管要素图层数据回滚到过去的某个特定时间，请在现有关系数据存储的上方进行恢复。请注意，您只能恢复到备份文件可用时的先前关系数据存储状态。例如，如果您只保留了五天的备份，则只能将数据存储恢复到这五天以内的某个时间点。

如果您需要替换多机切片缓存数据存储中的其中一台计算机，您很可能需要在切片缓存数据存储中重新平衡场景图层缓存。在该过程中您需要恢复切片缓存数据存储，将 replicatedata 选项设置为 true。有关说明，请参阅恢复数据存储。

可以在主关系数据存储计算机上运行 restoredatastore 实用程序。该实用程序可以在任何切片缓存数据存储、时空大数据存储、图谱存储或对象存储计算机上运行。

语法

restoredatastore [options]

支持的选项如下：

[--store {relational | tileCache | spatiotemporal | graph | object}] - 指示要恢复的数据存储类型。
[--target {most-recent | <yyy-mm-dd-hh:mm:ss> | <name of backup file>}] - 所有数据存储类型均支持具有 target 选项的备份文件名称。时间戳和 most-recent 仅适用于关系数据存储。
[--source-loc <parent directory of the source backup file location>] - 这是您要用于恢复数据存储的备份文件所在的顶级目录。这将是文件共享位置的路径或备份位置名称或 Amazon S3 或 Azure Blob 的存储备份位置。
提示：
可以运行 configurebackuplocation 实用程序并将 --operation 选项设置为 list 以获取备份源位置。如果无法运行 configurebackuplocation 实用程序（例如，如果数据存储计算机崩溃并且您正在恢复到新计算机以恢复数据存储），则可以通过名为 agsds_backup_sig 的文件来标识备份源位置。
[--bound {true | false}] - --bound 选项仅支持关系数据存储。
[--data-dir <new data store directory>] - 这是要恢复数据库的计算机上的 ArcGIS Data Store 目录。如果要将数据存储恢复到新计算机，则需要使用 --data-dir。恢复到新计算机时，还须指定 --source-loc 选项。
[--server-url <ArcGIS Server URL registered with data store>] - 如果指定 --bound true 以使此数据存储与创建备份时的数据存储注册在同一 GIS Server 站点，请指定 GIS Server 站点的 URL。如果指定 --bound true 且已将服务移动至新的 GIS Server 站点，则使用 --server-url 选项指定新 GIS Server 站点的 URL。请注意，如果您指定了新站点 URL，但并未将服务移动至该新服务器，则无法访问数据存储中的数据。
[--server-admin <username of ArcGIS Server admin>] - 如果指定 --bound true 或者未指定 --bound 选项，则需要此选项。提供 ArcGIS Server 管理员的用户名。
[--server-password <password of ArcGIS Server admin>] - 如果指定 --bound true 或者未指定 --bound 选项，则需要此选项。提供 ArcGIS Server 管理员的密码。
[--loaddata {true | false}] - 支持切片缓存和时空大数据存储以及图谱和对象存储。当您需要将数据存储恢复到一组新的计算机时，请将此选项设置为 false，但数据将不适用于第一台计算机。这样可以恢复数据存储的方案，将更多的计算机添加至数据存储以容纳所有数据，然后再次运行 restoredatastore 实用程序并将 --loaddata 设置为 true 以恢复数据。默认情况下，此选项设置为 true。
[--replicatedata {true | false}] - 支持切片缓存数据存储。当您需要在将计算机添加到切片缓存数据存储后重新平衡场景缓存数据时，请将此选项设置为 true。
[--mode {primaryStandby | cluster}] - 当您将切片缓存数据存储恢复到新计算机时，请指定是要使用两台计算机的切片缓存数据存储来实现高可用性 (primaryStandby) 还是使用多机切片缓存数据存储来实现可扩展性 (cluster)。
[--prompt {yes | no}]

在发生故障后恢复关系数据存储或移动关系数据存储，请指定 --target most-recent。如果将关系数据存储恢复到某个时间点，请指定您要将数据存储恢复到的日期和时间（UTC 格式）。如果您想要恢复某个特定的备份文件，请指定备份文件名称。如果您没有指定目标，系统会恢复最近的备份。

默认情况下，恢复的数据存储与其 GIS Server 站点相关联（绑定）。如果您要恢复数据存储而不保持数据存储与 GIS Server 站点关联，请只指定 --bound false。除非之前的 GIS Server 站点丢失且不可恢复，否则尽量不要这样做；您可以恢复未绑定的数据存储，并使用新的联合 GIS Server 站点对其进行配置。但是，使用数据存储中的数据的图层将不会存在。您必须连接到数据存储数据库才能将数据提取为其他格式，并将其重新发布到 ArcGIS Enterprise。

示例

在本示例中，最新备份位于名为 rdsbackups 的备份位置，并将恢复到现有数据存储中。由于默认存储类型为关系存储，且在默认情况下该数据存储仍会受到所注册的 GIS Server 站点的限制，因此您无需指定 --store relational 或 --bound true。但是，必须指定 GIS Server URL 和管理员凭据。

restoredatastore --target most-recent --source-loc rdsbackups --server-url https://gisserver.domain.com:6443 
--server-admin siteadmin --server-password $Aup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在本示例中，已启用时间点恢复的关系数据存储将从网络共享上的关系数据存储备份位置恢复至 2014 年 7 月 17 日下午 2：30 (UTC) 时的状态。

restoredatastore --target 2014-07-17-14:30:00 --source-loc \\sharedserver\entbackups\relds --server-url https://gisserver.domain.com:6443 
--server-admin siteadmin --server-password $Aup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在本示例中，可以使用名为 movedatastore 的备份文件将关系数据存储恢复到新计算机。恢复到新计算机时，必须指定备份文件的位置和新 ArcGIS Data Store 数据目录的位置。由于托管要素服务仍运行在关系数据存储所注册的同一 GIS Server 站点，因此不需要 --bound true，但是需要 GIS Server URL 和管理员凭据。

restoredatastore --target movedatastore --source-loc \\buserver\data\backups --data-dir C:\datastore 
--server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在以下示例中，可将切片缓存数据存储恢复到新计算机。恢复到新计算机时，必须指定备份文件的位置和新 ArcGIS Data Store 数据目录的位置。由于场景服务仍运行在切片数据存储所注册的同一 GIS Server 站点，因此不需要 --bound true，但是需要 GIS Server URL 和管理员凭据。

restoredatastore --store tilecache --source-loc \\buserver\scenedata\backups --data-dir C:\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $SAup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在本示例中，切片缓存数据存储将从名为 mybackupfilename 的文件中恢复，以在向切片缓存数据存储中添加新计算机后重新平衡场景缓存数据。

restoredatastore --store tilecache --target mybackupfilename --serverurl https://gisserver.domain.com:6443 --server-admin siteadmin --server-password myAdminPWd! --replicatedata true

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在以下示例中，将时空大数据存储备份文件 (bds1) 从指定名称 (awsloc) 的备份位置中恢复。

restoredatastore --target bds1 --store spatiotemporal --source-loc name=awsloc --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

有关硬件故障后恢复时空大数据存储的步骤和示例，请参阅恢复数据存储。

revokeconnection

该实用程序适用于关系数据存储。

如果您使用 allowconnection 实用程序暂时允许另一客户端直接连接到关系数据存储，您可以通过运行 revokeconnection 实用程序撤销连接功能。

只能在主关系数据存储计算机上运行 revokeconnection 实用程序。

语法

revokeconnection <host name> <username> [<database>]

示例

在本示例中，当以用户 hqo.n_1E7 的身份登录时，数据存储数据库不会再接受 workcom 计算机的连接。

revokeconnection workcom hqo.n_1E7

unregisterdatastore

该实用程序可用于所有数据存储类型。

您可以使用 unregisterdatastore 实用程序执行下列操作：

从托管 GIS Server 站点取消注册任意类型的单机数据存储。
注销对象存储后，必须重新启动托管服务器。
在以主-备用模式运行的数据存储中，可以在移除备用计算机后取消注册主计算机。
对于在集群模式下运行的时空大数据存储和切片缓存数据存储，可以在从集群中移除所有其他计算机后取消注册最后一台计算机。

注：

如要取消注册数据存储以将其从部署中永久移除，请在取消注册该数据存储之前删除使用该数据的托管图层。例如，如果组织成员曾测试 GeoAnalytics Tools并将时空大数据存储用于工具创建的图层，但该成员确定图层可以存储在关系数据存储中，在这种情况下，可在取消注册时空大数据存储之前删除测试使用的托管时空要素图层。如果不执行此操作，门户中将留有不可用的图层项目，且托管服务器中将运行不可用的服务。

从数据存储中取消注册计算机时，托管 GIS Server 站点（如果使用的是知识图谱，则为 ArcGIS Knowledge Server 站点）无法再连接到该计算机，并且所有包含未注册数据存储中的数据的服务均无法再正常运行。但是，此实用程序并不会删除数据；如果您决定仍然需要数据存储，则可使用 registerdatastore 或 configuredatastore 实用程序重新添加数据。

语法

unregisterdatastore --stores {relational | tileCache | spatiotemporal | graph | object} [--prompt {yes | no}]

如果您在同一台计算机上安装有多个类型的数据存储并希望一次取消注册多个数据存储，则指定用逗号分隔（不含空格）的每个数据存储类型。例如，要取消注册关系和切片缓存数据存储，则输入 --stores relational,tileCache。

示例

在此处运行 unregisterdatastore 实用程序以取消注册托管 GIS Server 站点中的关系和切片缓存数据存储。系统将返回提示信息（此为默认行为）。要禁止提示符，指定 --prompt No。

unregisterdatastore --stores relational,tileCache

You are going to unregister the data store.
Do you want to continue (Yes or No)?Yes

updatebackupretaindays

该实用程序适用于关系数据存储。

默认情况下，ArcGIS Data Store 将保留关系数据存储备份文件 7 天。通过运行 updatebackupretaindays 实用程序，您可以更改从备份目录中清除备份文件的频率。

只能在主关系数据存储计算机上运行 updatebackupretaindays 实用程序。

语法

updatebackupretaindays <number of days>

示例

在接下来的示例中会将备份文件保留时间更改为 10 天：

updatebackupretaindays 10

updatebackupschedule

该实用程序可用于所有数据存储类型。

默认情况下，ArcGIS Data Store 每四天创建一次关系数据存储的完整备份。您可以通过运行 updatebackupschedule 实用程序更改创建完整备份的频率。

切片缓存或时空大数据存储或图谱存储没有默认的自动备份。要为时空大数据存储设置自动备份计划，首先必须设置有效的备份位置。

可以使用 24 小时时钟表示法指定开始时间，例如，00:00:00 表示午夜以及 13:00:00 表示下午 1 点。可以使用 frequency 选项以指定备份间隔的天数。要禁用自动备份，将频率设置为 0。如果禁用自动备份，请确保运行 backupdatastore 实用程序以手动创建备份。

您可在主关系数据存储计算机上运行 updatebackupschedule 实用程序。该工具可在任何切片缓存或时空大数据存储计算机上运行。

有关 ArcGIS Data Store 备份的详细信息，请参阅管理数据存储备份。

语法

updatebackupschedule [--store {relational | tileCache | spatiotemporal | graph | object}] [--starttime <local server time>] --frequency <number of days>

如果未指定新开始时间，则不会更改现有开始时间设置。如果未指定数据存储类型，则将假设为关系数据存储。

示例

在本示例中，将以每 10 天的频率在下午 11 点（本地服务器时间）对关系数据存储进行完整备份。

updatebackupschedule --starttime 23:00:00 --frequency 10

在本示例中，将为切片缓存数据存储设置备份计划。对所有切片缓存数据存储数据库的副本进行初始备份后，ArcGIS Data Store 每 14 天使用 configurebackuplocation 将新创建的数据存储数据库复制到指定位置一次。

updatebackupschedule --store tileCache --frequency 14

updatesslcertificate

该实用程序可用于所有数据存储类型。

您可以将用于验证托管服务器与数据存储之间的通信以及数据存储计算机间通信的自签名证书替换为由认证机构 (CA) 验证和签名的证书或域名证书。

有关详细信息，请参阅替换 ArcGIS Data Store SSL 证书。

语法

updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>

示例

收到 CA 签名证书文件后，运行 updatesslcertificate 以替换 ArcGIS Data Store 自签名证书。

updatesslcertificate C:\myfiles\mysignedcert.pfx "ps4mycert" dsmachinename

upgradedatasource

该实用程序适用于时空大数据存储。

由于 10.8.1 中的漏洞，使用方形或六边形聚合的 ArcGIS GeoEvent Server 地图服务在升级到 10.9 或更高版本后不会渲染。要更正此问题，请运行 upgradedatasource 实用程序来更新与这些 GeoEvent Server 地图服务的源数据关联的索引。

更新索引时，没有人可以访问地图服务。

upgradedatasource 实用程序可以在时空大数据存储中的任何计算机上运行。

语法

upgradedatasource [<service name>]

示例

在此示例中，所有 GeoEvent Server 地图服务源都已升级：

upgradedatasource

在此示例中，upgradedatasource 实用程序将更新 GeoEvent Server 地图服务侦查使用的索引。服务名称是使用 listdatasources 实用程序确定的。

upgradedatasource recon

有关此主题的反馈?