命令实用程序随 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> <user name> [<database>]
指定要连接到关系数据存储的计算机的名称(主机名)和数据存储使用的一个数据库帐户(用户名):数据存储管理员、复本所有者、地理数据库管理员或托管用户(发布要素图层数据的用户),您可以使用 listadminusers 实用程序或 listmanageduser 实用程序获取它们。您还可以指定主关系数据存储数据库的名称,但是,因为只有一个数据存储数据库,所以该值可选。
示例
在此示例中,当以 hqo.n_1E7 托管用户身份进行连接时,允许从 workcom 计算机连接到关系数据存储。
allowconnection workcom hqo.n_1E7
backupdatastore
适用于关系、切片缓存和时空大数据存储。
如果您需要在计划的备份期间创建关系数据存储备份,请使用 backupdatastore 实用程序。升级数据存储前或对数据存储进行大量更改前,请使用此实用程序手动创建完整备份。
首次运行 backupdatastore 实用程序进行切片缓存数据存储时,备份副本由所有现有的切片缓存数据存储数据库构成。后续使用 backupdatastore 实用程序时,可创建自上次运行该实用程序起创建的任何切片缓存数据存储数据库的备份复本。
首次运行 backupdatastore 实用程序进行时空大数据存储时,系统将创建完整备份。由于时空大数据存储可能非常大,所以随后使用 backupdatastore 实用程序创建的备份文件仅包含自初始完整备份起的更改。
可在主关系或切片缓存数据存储计算机上运行 backupdatastore 实用程序。此实用程序可在任何时空大数据存储成员计算机上运行。
在任何情况下,都请确保备份空间位置足以容纳备份内容。要更改数据存储备份位置,请使用 configurebackuplocation 实用程序。
语法
backupdatastore [<backup name>] [--store {relational|tileCache|spatiotemporal}] [--prompt <yes | no>]
示例
在本例中,使用 configurebackuplocation 实用程序在为数据存储指定的备份位置处创建名为 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
在本例中,将创建时空大数据存储的备份,所创建备份文件的名称为 spds311016:
backupdatastore spds311016 --store spatiotemporal 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 实用程序。
在默认情况下,关系数据存储备份文件存储在与数据存储相同的计算机上。如果无法访问安装有 ArcGIS Data Store 的计算机,您应该将备份文件移到另一台计算机上以确保可以访问。
使用域帐户设置要运行的 ArcGIS Data Store 服务,授予该帐户对共享网络目录的读写权限,并使用 changebackuplocation 实用工具将您的数据存储备份文件移动到其他计算机上的共享目录中。
changebackuplocation 实用程序仅适用于为关系数据存储创建的备份。
语法
changebackuplocation <new directory path> [--is-shared-folder <true|false>] [--keep-old-backups <true|false>]
如果备份位置在共享网络计算机上,请指定 --is-shared-folder true。如果您要将现有备份文件移动到新的位置,请指定 --keep-old-backups true。
changedatastoremode
适用于关系数据存储。
changedatastoremode 实用程序可用于将关系数据存储置于只读模式,同时对数据存储执行维护。例如,如果您需要执行会导致数据存储重启的维护任务(例如,将备份位置从一个驱动器更改为另一个驱动器或更改数据库属性),则您可以将关系数据存储置于只读模式,以便数据存储重启时,无任何用户会处于发布或编辑数据的过程中。
changedatastoremode 实用程序也可在完成维护或为主数据存储计算机增加足够磁盘空间后将关系数据存储转换回读写模式,从而使数据存储在读写模式下可以正常工作。
只能在主关系数据存储计算机上运行 changedatastoremode 实用程序。
注:
如果 ArcGIS Data Store 由于磁盘空间不足而将关系数据存储置于只读模式,则系统也会禁用自动备份以避免进一步填满磁盘。因此,您还需要在将关系数据存储转换回读写模式后使用 updatebackupschedule 实用程序重置自动备份计划。
语法
changedatastoremode readonly|readwrite [--prompt <yes|no>]
示例
在本例中,将关系数据存储转换回读写模式,表示客户端可在进行以下操作时恢复此类活动:将托管要素图层发布到门户、通过托管要素图层编辑数据或将 CSV 文件添加到门户地图查看器。
changedatastoremode readwrite --prompt no
changedbproperties
适用于关系和时空大数据存储。
changedbproperties 实用程序允许您根据运行的数据存数类型更改不同的属性。
语法
changedbproperties --store <relational | spatiotemporal> [configuration operations]
支持的配置操作:
- disk-threshold-readonly:此设置用于控制何时将关系数据存储置于只读模式,以避免由于磁盘空间不足导致的数据丢失。默认磁盘空间值为 1024 MB。指定大小(以 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 部署的备份,则必须启用时间点恢复。
此选项为 ArcGIS Data Store 10.5.1 的新功能。
- heap-size:使用该参数更改用于时空大数据存储的堆内存数(以 MB 为单位)。默认情况下,启动此类型的数据存储将使用一半的可用 RAM。该参数不支持关系或切片缓存数据存储。
- rebalance:默认情况下,该参数设置为 true,这意味着如果任何一台计算机不可用,则时空大数据存储中的数据将数据分发到其他计算机。如果需要在一个时空大数据存储计算机上执行维护(例如对其进行升级),则可以通过将此参数设置为 false 来临时关闭重新均衡。Rebalance 将在为 max-rebalance-off 参数设置的时间内暂停。该参数只适用于时空大数据存储。
旧版本:
在 ArcGIS 10.4.x 中,此选项为 reallocation。
- max-rebalance-off:当 rebalance 参数设置为 false 时使用此参数的设置。默认情况下,max-rebalance-off 设置为 60 分钟。这意味着,如果您临时关闭重新均衡,它将在 60 分钟后再次启动。如果您需要比暂停重新均衡所执行的维护任务更多或更少的时间,请更改 max-rebalance-off 的时间设置。该参数只适用于时空大数据存储。
旧版本:
在 ArcGIS 10.4.x 中,此选项为 max-allocation-off。
- prompt:您运行该实用程序时,系统将提示您确认指定的操作。如果您自动使用此实用程序,则将提示参数设置为 false;否则必须回答提示问题,脚本才会继续。
示例
在此示例中,关系数据存储允许的最大连接数设置为 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
在本示例中,max-rebalance-off 操作使用的分钟数设置为 15 时,时空大数据存储会自动将 rebalance 更改为 true。
changedbproperties --store spatiotemporal --max-rebalance-off 15
changeloglocation
适用于关系、切片缓存和时空大数据存储。
如果不希望数据存储使用 <ArcGIS Data Store installation directory>\arcgisdatastore\logs 的默认错误日志文件位置,则可以运行 changeloglocation 实用程序在其他目录中创建错误日志文件。
ArcGIS Data Store 帐户必须具有您指定的文件夹的写入权限。
语法
changeloglocation <directory path>
示例
在本示例中,将在本地目录 d:\datastorefiles\logs 中创建日志文件。
changeloglocation 'd:\datastorefiles\logs'
changenosqldslocation
适用于切片缓存数据存储。
如果您在切片数据存储中存储了大量高分辨率切片,则切片缓存数据存储可能会变大。在这种情况下,您可能需要将数据移动到同一服务器的另一驱动器中,或者移动到另一服务器的共享位置处。
如果您将数据移动到共享目录,必须向运行 ArcGIS Data Store 进程 (Linux) 或服务 (Windows) 的用户授予目录的读写权限。
语法
changenosqldslocation <path> [--prompt {yes | no}]
示例
在本示例中,将在计算机 server2 上名为 dstorecache 的共享目录下创建存储场景图层缓存的数据库。
changenosqldslocation \\server2\dstorecache
changepassword
适用于关系数据存储。
ArcGIS Data Store 会为关系数据存储使用的数据库帐户随机生成用户名和密码。如果您的站点要求设置您自己的密码,则获取数据存储帐户的密码,然后运行 changepassword 来重置密码。
使用 listadminusers 实用程序获取管理员用户的用户名和密码;使用 listmanageduser 实用程序获取要素数据所有者的用户名和密码。
只能在主关系数据存储计算机上运行 changepassword 实用程序。
语法
changepassword <user name> <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 会在过渡位置提取压缩的备份文件。这表示您需要具有可兼容此未压缩数据的过渡位置。如果关系数据存储中存在大量数据,则您可能希望设置单独过渡位置并为恢复操作指定单独过渡位置。
语法
changestaginglocation <directory path>
示例
本例中指定的过渡位置是 \\netserver\stage。
changestaginglocation \\netserver\stage
configurebackuplocation
适用于关系、切片缓存和时空大数据存储。
configurebackuplocation 可用于指定 ArcGIS Data Store 写入备份文件的位置。如果您不再需要 ArcGIS Data Store 备份,则此命令还可用于移除备份位置。
使用默认的本地备份位置创建关系和切片缓存数据存储。使用 change 操作以指定更为安全的关系数据存储的备份位置。
不使用默认位置创建时空大数据存储。在开始创建备份前,必须使用 register 操作运行 configurebackuplocation 实用程序以指定这些备用文件的共享网络位置。时空大数据存储需要共享网络位置;无法使用这些备份文件的本地驱动器。
语法
configurebackuplocation --location <backup_location> [operations]
支持的操作如下:
- --store <relational|tileCache|spatiotemporal>:默认值为 relational。
- --operation <change|register|unregister>:默认值为 change。
- --prompt <yes | no>:默认值为 yes。
register 和 unregister 操作仅适用于时空大数据存储。
如果未指定 --store 操作,则将假设为关系存储。
注:
如果指定注册或更改操作,则需要使用位置操作。
示例
在第一个示例中,关系数据存储的备份位置设置为计算机 myshare 上名为 fsdata_bu 的目录。
configurebackuplocation --operation change --store relational
--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
在本例中,已为时空大数据存储注册网络共享的备份位置。
configurebackuplocation --operation register --store spatiotemporal
--location \\sharedmachine\ge_bu
configuredatastore
适用于关系、切片缓存和时空大数据存储。
安装 ArcGIS Data Store 后,您可运行 configuredatastore 实用程序创建数据存储并将其注册到 GIS Server 站点。您可使用该命令创建以下数据存储类型:
- 托管要素图层数据的数据存储(关系数据存储)
- 托管场景图层切片缓存的数据存储(切片缓存数据存储)
- 运行 GeoAnalytics Tools 时创建的数据的数据存储或用于存档 ArcGIS GeoEvent Server 中的观察数据的数据存储(时空大数据存储)
数据存储升级后,您也可以使用 configuredatastore 实用程序对其进行重新配置。
语法
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores <relational|tileCache|spatiotemporal>] [--nosql-only true|false]
ArcGIS Server 管理 URL 的格式为 https://gisserver.domain.com:6443/arcgis。注意,即使您的 GIS Server 站点使用的是 Web Adaptor,也需提供采用前面所提及格式的 URL。
为在 GIS Server 站点中具有管理员权限的内置(非企业级)用户提供用户名和密码。
数据目录是在本地计算机上您要创建数据存储文件的位置。
虽然您可以指定由逗号分隔(不含空格)的每种存储类型以在同一台计算机上配置多个类型的数据存储,但不建议您这样操作。例如,要在同一台计算机的共享数据存储目录下配置关系和切片缓存数据存储,请指定 --stores relational,tileCache。Esri 强烈建议您在独立于其他数据存储或软件的计算机上运行时空大数据存储。
旧版本:
在之前的版本中,您可指定 --nosql-only 操作设置为 true 以创建仅用于场景图层缓存切片的数据存储。此操作仍存在,以便现有脚本继续运行。在未来,改用 --stores 操作设置为 tileCache。
配置数据存储的特定类型
您可以通过 --stores 操作指定关系,从而配置托管要素图层数据的 ArcGIS Data Store。
要发布托管场景图层,需要使用场景缓存的数据存储和托管要素图层数据的数据存储,因为当您发布托管场景图层时,ArcGIS 将创建托管要素图层、托管场景图层和场景缓存。您可以通过 --stores 操作指定 relational,tileCache 来配置两种类型的数据存储,也可以通过 --stores 操作仅指定 tileCache 并使用自己的托管数据库作为托管要素图层数据的数据存储。
注:
请注意,如果您将您自己的托管数据库用于托管要素图层数据,您不能使用 ArcGIS Data Store 工具来管理数据库。换言之,您可以使用对 DBMS 可用的工具管理用户和备份。您也无法利用 ArcGIS Data Store 提供的高可用性功能,且与托管服务器使用关系数据存储时创建的托管要素图层相比,发布到门户的托管要素图层既没有其功能多,也没有其扩展性好。
如果使用 ArcGIS GeoEvent Server 并且希望存储高容量和高速观察数据,则通过 --stores 操作指定时空来创建时空大数据存储。
有关使用时空大数据存储的详细信息,请参阅 ArcGIS GeoEvent Server 帮助。
如果要在门户地图查看器或 GeoAnalytics Tools 中使用 ArcGIS Pro,则通过 --stores 操作指定时空来创建时空大数据存储。
请注意,如果要编写创建多个时空大数据存储计算机的脚本,则必须在 GIS Server 中配置一个时空大数据存储,然后从才可编写创建其他时空大数据存储计算机的脚本。
您可以在同一台计算机上创建多个类型的数据存储,甚至可以在同一台计算机上创建所有三个类型的数据存储;但是,Esri 不建议您这么做,因为数据存储会争夺内存和其他资源,从而降低服务性能。
示例
在该示例中,创建了托管要素图层数据的数据存储(关系数据存储)。GIS Server 站点中使用数据存储的 URL 是 https://dataserver.mydomain.com:6443/arcgis,站点管理员用户名和密码分别为 admin 和 Iph33l$ik,数据存储的数据目录是 C:\datastore\data\。
configuredatastore https://dataserver.mydomain.com:6443/arcgis admin Iph33l$ik c:\datastore\data\ --stores relational
configureserviceaccount
适用于关系、切片缓存和时空大数据存储。
configureserviceaccount 实用程序可更改 ArcGIS Data Store 帐户使用的登录信息。使用该实用程序设置帐户时,可将帐户信息导出到文件中。注意,文件中密码已加密。在某些情况下您可以使用该文件来导入同一帐户信息,例如,设置另一 ArcGIS Data Store 并希望使用相同的帐户时。在这种情况下,则在新的计算机上运行 configureserviceaccount 实用程序并导入包含帐户信息的文件。
也可以使用此实用程序更新 ArcGIS Data Store 帐户的密码。如果 Windows 登录密码发生变化,则运行该实用程序并为现有 Windows 帐户指定新的密码。
语法
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 帐户已更改,且帐户信息已写入位于 C:\adminfiles 的文件 (adsainfo) 中。
configureserviceaccount --username mynetwork\datastore --password SewL0ng --writeconfig C:\adminfiles\adsainfo
在此示例中,ArcGIS Data Store 安装在不同的计算机上,且管理员使用在上一示例中创建的文件运行 configureserviceaccount 实用程序以设置同一帐户。
configureserviceaccount --readconfig C:\adminfiles\adsainfo
deletebackup
适用于关系数据存储。
deletebackup 实用程序用于删除为关系数据存储创建的备份文件。首先,运行 listbackups 实用程序以查看手动备份的名称和创建时间。然后,您可以运行 deletebackup 实用程序以删除不再需要的手动备份。
请注意,您只能删除不需要恢复备份。例如,您不能删除关系数据存储的最近完整备份。
语法
deletebackup <backup name> [--prompt <yes | no>]
示例
deletebackup featuresMarchbu You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
describedatastore
适用于关系、切片缓存和时空大数据存储。
通过 describedatastore 实用程序,您可以查看有关 ArcGIS Data Store 安装的以下信息:
- ArcGIS Data Store 安装程序的软件版本号
- 恢复数据存储所使用的过渡位置
- 数据存储的日志文件位置
- 已安装 ArcGIS Data Store 的计算机上的剩余可用磁盘空间量
- 关系数据存储将置于只读模式且时空大数据存储将停止的可用磁盘空间阈值
- 每类数据存储所使用的备份位置
- 关系或切片缓存数据存储的备份位置是否已在网络上共享
- 数据存储创建备份的频率(备份计划)
- 保留关系数据存储备份文件的天数
- 数据存储是否正在运行(数据存储状态)
- 备用关系或切片缓存数据存储成为主数据存储的日期和时间(上次故障转移);如果从未发生故障转移则不显示
- 参与关系或切片缓存数据存储的计算机的名称(成员计算机)
- 关系数据存储允许的最大连接
- 数据存储注册到 GIS Server 站点的 URL(所属系统 URL)
- 使用 GIS Server 站点作为其托管服务器的门户 URL(门户 URL)
- 连接到关系数据存储的当前要素图层数
- 当前参与时空大数据存储的所有计算机的列表(时空集群中的计算机)
- 当前指定为主计算机的时空大数据存储内部的计算机(集群内的当前主计算机)
- 时空大数据存储集群中所有计算机的列表(已注册的时空计算机);显示集群中的所有计算机(无论其处于何种状态)
语法
describedatastore
示例
describedatastore 实用程序将返回适用于计算机上所有数据存储的常规信息并返回包含特定于每种类型数据存储信息的特定单独部分。
虽然您很可能会将不同的数据存储放置在不同的计算机上,但是以下输出显示了将三种类型放置在同一台计算机上,以便您可以查看每个类型的不同部分:
describedatastore General Information of ArcGIS Data Store on machine.domain.com ============================================================== ArcGIS Data Store release....10.5.0.7777 Staging location.............C:\arcgisdatastore\staging Log location.................C:\arcgisdatastore\logs Free disk space..............174.00GB Threshold for READONLY mode..1024MB 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 Last failover.............20150130190334005 Member machines...........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM Maximum connections.......150 Owning system URL.........https://gisserver_webadaptor.domain.com/server/admin Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal Number of connections.....8 connection(s) to managed database Information for tile cache data store ds_wztxj7um ============================================================== Data location.......................C:\arcgisdatastore\nosqldata Data store status...................Started Backup location............C:\arcgisdatastore\backup Is backup folder shared.............false Tile cache location.................C:\arcgisdatastore\nosqldata Member machines.....................MACHINE1.DOMAIN.COM Owning system URL...................https://gisserver_webadaptor.domain.com/server/admin Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal Information for spatiotemporal data store ds_qpko99Cl ============================================================== Max rebalance off time..............60 minutes Automatic rebalance ................On Machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM Current master machine 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:6443/arcgis/admin
exportmanageddb
旧版本:
Esri 已在 10.5.1 上弃用了 exportmanageddb 实用程序。此功能已整合到 backupdatastore 实用程序中。为使现有脚本继续运行,exportmanageddb 实用程序仍存在,但您应使用 backupdatastore 实用程序创建备份文件,然后使用 restoredatastore 实用程序从备份文件中恢复数据存储。
适用于关系和切片缓存数据存储。
exportmanageddb 实用程序创建关系数据存储的转储文件、有关数据存储的元数据以及所有存储托管场景图层切片缓存的数据库。如果您需要备份,以便在使用不同操作系统的计算机上恢复到 ArcGIS Data Store 安装或恢复到其他 ArcGIS Data Store 版本的安装,可导出数据存储。
在向新计算机导入数据存储之前,确保没有人编辑要素图层或向门户发布图层的用户。另请确保您导出数据存储的位置包含足以保存关系数据存储转储文件的存储空间以及所有托管场景图层缓存数据库的副本。
exportmanageddb 实用程序不能导出时空大数据存储。
语法
exportmanageddb <output location> <backup name> [operations]
输出位置即磁盘中创建文件夹 (<backup name>) 和导出文件的位置。您必须对该位置具有写入权限。
支持的操作如下:
- [--stores {relational|tileCache}]:指示要导出的数据存储类型。如果关系和切片缓存数据存储在同一台计算机上运行并且您希望导出这两种数据存储,则指定用逗号分隔的两种数据存储;例如,输入 --stores relational,tileCache。如果未指定 --stores 操作,则将假设为关系存储。
- [--include-tilecache <true|false>]:进行此操作是为了实现向后兼容性。如果未指定 --stores 操作或指定 --stores relational,则可以控制是否使用此操作导出切片缓存数据存储。
- [--prompt {yes|no}]:确定您是否必须回答提示问题才能运行实用程序。
示例
在以下示例中,将转储文件、托管场景图层缓存数据库副本及相关数据存储文件输出到 backupserver 服务器上名为 movedsfirstexp 的共享网络目录中。
exportmanageddb \\backupserver movedsfirstexp --stores relational,tileCache You are attempting to back up database 'db_e3hsm and nosql databases'. This 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
importmanageddb
适用于关系和切片缓存数据存储。
如果您导出的 ArcGIS Data Store 包含托管要素图层或托管场景图层缓存数据库(或两者),则可使用 importmanageddb 实用程序恢复数据存储。您可以恢复到升级后的 ArcGIS Data Store 计算机,或者与源 ArcGIS Data Store 使用不同操作系统的计算机上的 ArcGIS Data Store 安装。
如果您希望如之前一样通过同一个 ArcGIS Data Store 站点注册 GIS Server,则指定--bound true 且不指定 --server-url。请注意,默认情况下 --bound 设置为 true。请确保恢复前重新启动 GIS Server 站点。
如果您进行恢复且希望将数据存储注册到新 GIS Server 站点,则请在导入数据存储时指定 --server-url。
默认情况下,导入导出文件中组成切片缓存数据存储的关系数据存储和所有托管场景图层缓存数据库。如果您不想包括托管场景图层缓存数据库,请指定 --include-tilecache 操作设置为 false。
importmanageddb 实用程序不能导入时空大数据存储。
语法
importmanageddb <source backup location> <backup name> [operations]
支持的操作如下:
- [--server-url <ArcGIS Server URL registered with data store>] :如果指定 --bound true 且已将服务移动至新的 GIS Server 站点,则使用 --server-url 操作指定新 GIS Server 站点的 URL。但是请注意,除非您已将服务移动至该新服务器,否则将无法访问数据存储中的数据。
- [--server-admin <user name of ArcGIS Server admin>]:此操作仅在指定 --bound false 时可选;否则,您必须提供 ArcGIS Server 管理员的用户名。
- [--server-password <password of ArcGIS Server admin>]:此操作仅在指定 --bound false 时可选;否则,您必须提供 ArcGIS Server 管理员的密码。
- [--data-dir <data store data directory>]:ArcGIS Data Store 目录。默认情况下,此为当前注册数据存储的 ArcGIS Data Store 目录。
- [--stores {relational|tileCache}]:指示要导入的数据存储类型。如果关系和切片缓存数据存储在同一台计算机上运行并且您希望导入这两种数据存储,则指定用逗号分隔的两种数据存储;例如,输入 --stores relational,tileCache。如果未指定 --stores 操作,则将假设为关系存储。
- [--include-tilecache <true|false>]:进行此操作是为了实现向后兼容性。如果未指定 --stores 操作或指定 --stores relational,则可以控制是否使用此操作恢复切片缓存数据存储。
- [--bound {true|false}]:--bound 操作有三个不同的场景可供选择。
- 如果指定 --bound true 或未指定 --bound 操作,则必须进行 --server-url 操作指定 GIS Server 站点的 URL。如果您导入的 GIS Server 站点与 ArcGIS Data Store 导出数据存储时已注册的站点相同,则请指定 GIS Server 站点的 URL 并提供 ArcGIS Server 管理员的用户和密码。要将数据存储绑定至新 GIS Server 站点,请提供新站点的 URL 和管理员凭据。
注:
仅在将 web 服务移至该新的 GIS Server 站点后为此新 GIS Server 站点指定信息。
- 如果您的数据存储不再使用之前的 GIS Server 站点且您尚未将所有服务移至新的 GIS Server 站点,则指定 --bound false。然后必须运行 registerdatastore 实用程序,以便在将服务移动至新站点后使用新的 GIS Server 站点配置数据存储。
- 如果指定 --bound true 或未指定 --bound 操作,则必须进行 --server-url 操作指定 GIS Server 站点的 URL。如果您导入的 GIS Server 站点与 ArcGIS Data Store 导出数据存储时已注册的站点相同,则请指定 GIS Server 站点的 URL 并提供 ArcGIS Server 管理员的用户和密码。要将数据存储绑定至新 GIS Server 站点,请提供新站点的 URL 和管理员凭据。
- [--prompt {yes|no}]:确定您是否必须回答提示问题才能运行实用程序。
示例
在下面的示例中,数据存储恢复到版本较新的 ArcGIS Data Store 安装。新的 ArcGIS Data Store 数据目录已指定。数据存储仍与现有 GIS Server 站点绑定,因此数据存储和现有托管要素和场景图层仍然可用。重新启动 GIS Server 站点以允许托管要素和场景图层发布到新计算机上。
importmanageddb \\backupserver\expdir preupgradeexp --data-dir c:\arcgis\datastore --server-admin siteadmin --server-password $Aup.4s --bound true
在本例中,GIS Server 站点和关系数据存储均已移动至新的计算机上。Web 服务已移动至新的 GIS Server 站点中,因此新站点的 URL 通过 --server-url 操作进行指定。备份名称是 movedbexp,且备份存储在 \\backupserver\expdir 下。
importmanageddb \\backupserver\expdir movedbexp --data-dir c:\arcgis\datastore --server-admin siteadmin --server-password $Aup.4s --stores relational --bound true --server-url https:\\mynewserver.domain.com:6443
在本例中,Web 服务尚未移动至新的 GIS Server 站点中。如果未移动服务并随后将数据存储注册到新的 GIS Server 站点中,则切片缓存和关系数据存储将无法使用。备份名称是 movedsfirstexp,且备份存储在 \\backupserver\expdir\movingexp2 下。
importmanageddb \\backupserver\dbdump\movingexp2 movedsfirstexp --data-dir c:\arcgis\datastore --server-admin siteadmin --server-password $Aup.4s --stores relational,tileCache --bound false
listadminusers
适用于关系数据存储。
Listadminusers 实用程序针对关系数据存储的管理员、复本所有者和地理数据库管理员返回用户名和密码。
语法
listadminusers
示例
listadminusers Admin users for relational data store ds_abcd1234 ================================================= Database Admin User.... adm_32ret / tT30!bYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751*pb
listbackups
适用于关系、切片缓存和时空大数据存储。当关系或切片缓存数据存储运行时,listbackups 实用程序将仅在主数据存储计算机中运行。
listbackups 实用程序返回完整关系数据存储备份的名称以及写入的位置。Listbackups 实用程序也返回备份状态(无论是否完成),开始备份的时间,以及备份是通过手动使用 backupdatastore 实用程序创建还是由 ArcGIS Data Store 自动创建。
您可以运行 listbackups 以查看备份已完成还是仍在运行、确定您的手动备份数量或在运行 deletebackup 实用程序之前确认文件名称。
语法
listbackups [--store <relational|tileCache|spatiotemporal>]
如果未指定数据存储类型,则实用程序将返回在实用程序运行的计算机上运行的所有数据存储的备份列表。
示例
在本例中,将列出关系数据存储的备份:
listbackups --store relational Backup_Name Status Backup_Time Mode ==================================================================================== phase1proj_bu BackupComplete 2014-03-08 14:12 manual phase2proj_bu BackupComplete 2014-06-21 11:43 manual ds_gdt1oomh-20141103160748082 BackupComplete 2014-11-01 03:00 scheduled Backups located at: '\\myserver.net.com\dsbackups'
在本例中,将列出时空大数据存储的备份:
listbackups --store spatiotemporal Backup_Name Status Backup_Time Mode ==================================================================================== backup1 BackupComplete 2016-07-11 09:47 manual Backups located at: '\\myserver.net.com\spatiotemporal'
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
registerdatastore
适用于关系、切片缓存和时空大数据存储。
数据存储保留有关 GIS Server 站点计算机名称的信息。如果您将 GIS Server 站点移动到新的计算机上(例如,如果您获得新的硬件或者现有的 GIS Server 计算机出现故障),您必须从 GIS Server 站点中取消注册数据存储以移除该信息。在一台或多台新计算机上配置 GIS Server 后,您可以使用 registerdatastore 命令实用程序将数据存储注册到 GIS Server 站点。
请注意,此次数据存储与之前一样注册到同一 GIS Server 站点。数据存储包含现有 GIS Server 站点上的托管图层的数据。将其注册到其他 GIS Server 站点不会重新创建托管要素图层、场景图层缓存或流服务数据存档。
可在主关系或切片缓存数据存储计算机上运行 registerdatastore 实用程序。该实用程序可在任何时空大数据存储计算机上运行。
语法
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator user name> <ArcGIS Server site administrator password> --stores <relational|tileCache|spatiotemporal>
如果您在同一台计算机上安装了多个不同类型的数据存储,则您可通过指定用逗号分隔(不含空格)的数据存储类型同时注册这些数据存储;例如,输入 --stores relational,tileCache。
示例
在本示例中,关系数据存储使用 URL https://gisserver.domain.com:6443/arcgis 重新注册到 GIS Server 站点。ArcGIS Server 主站点管理员用户名为 agsadmin,密码为 Tan$p0n。
registerdatastore https://gisserver.domain.com:6443/arcgis agsadmin Tan$p0n --stores relational
removemachine
适用于关系、切片缓存和时空大数据存储。
使用 removemachine 实用程序移除 ArcGIS Data Store 安装中的以下内容之一:
- 从关系数据存储中移除备用计算机。可在备用计算机上进行;如果备用计算机不可用,也可在主计算机上运行。
- 从切片缓存数据存储中移除备用计算机。可在备用计算机上进行;如果备用计算机不可用,也可在主计算机上运行。
- 从时空大数据存储中移除计算机。请注意您无法在仅由一台计算机组成的时空大数据存储上运行 removemachine。
语法
removemachine <machine name> --store <relational|tileCache|spatiotemporal> [--prompt <yes | no>]
示例
在此示例中,时空大数据存储计算机 gefour 已从数据存储中移除。
removemachine gefour --store spatiotemporal
removestandbymachine
旧版本:
Esri 已弃用 removestandbymachine 实用程序。它仍然存在以允许现有脚本继续运行,但您应开始改用 removemachine 实用程序。
您可以通过 ArcGIS Server 站点管理员使用移除 ArcGIS Server REST 命令从关系或切片缓存数据存储中移除备用计算机。但是,如果 GIS Server 站点不可用,您将无法以站点管理员身份登录来执行此操作。在这些情况下,运行 removestandbymachine 实用程序以从数据存储中移除备用计算机。
removestandbymachine 实用程序只能在关系和切片缓存数据存储的备用计算机上运行。
语法
removestandbymachine <machine name> --store <relational|tileCache> [--prompt <yes | no>]
restoredatastore
适用于关系、切片缓存和时空大数据存储。
如果您无法访问门户的托管要素图层和托管场景图层使用的数据或存档实时数据,请使用备用文件和 restoredatastore 命令实用程序来恢复数据存储。
如果无法恢复数据存储,请在新计算机上安装 ArcGIS Data Store 并将最新的备份恢复到新计算机上。
如果您使用关系数据存储且要将托管要素图层数据回滚到过去的某个特定时间,请在现有关系数据存储的上方进行恢复。请注意,您只能恢复到备份文件可用时的先前关系数据存储状态。例如,如果您只保留了五天的备份,则只能将数据存储恢复到这五天以内的某个时间点。
可在主关系或切片缓存数据存储计算机上运行 restoredatastore 实用程序。该实用程序可在任何时空大数据存储计算机上运行。
语法
restoredatastore [operations]
支持的操作如下:
- [--store {relational|tileCache|spatiotemporal}]
- [--target {most-recent | <yyy-mm-dd-hh:mm:ss> | <name of backup file>}]:此操作仅支持关系数据存储。
- [--source-loc <location of source backup files>]
- [--bound {true | false}]
- [--data-dir <new data store directory>]
- [--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。但是请注意,除非您已将服务移动至该新服务器,否则将无法访问数据存储中的数据。
- [--server-admin <user name of ArcGIS Server admin>]:此操作仅在指定 --bound false 时可选;否则,您必须提供 ArcGIS Server 管理员的用户名。
- [--server-password <password of ArcGIS Server admin>]:此操作仅在指定 --bound false 时可选;否则,您必须提供 ArcGIS Server 管理员的密码。
- [--loaddata {true | false}]:仅支持时空大数据存储。当您需要将时空大数据存储恢复到一组新的计算机时,请将此操作设置为 false,但数据将不适合第一台计算机。这样可以恢复数据存储的方案,将更多的计算机添加至时空大数据存储以容纳所有数据,然后再次运行 restoredatastore 实用程序并将 --loaddata 设置为 true 以恢复数据。默认情况下,此操作设置为 true。
- [--prompt {yes | no}]
在发生故障后恢复关系数据存储或移动关系数据存储,请指定 --target most-recent。如果将关系数据存储恢复到某个时间点,请指定您要将数据存储恢复到的日期和时间(UTC 格式)。如果您想要恢复某个特定的备份文件,请指定备份文件名称。如果您没有指定目标,系统会恢复最近的备份。
默认情况下,恢复的数据存储与其 GIS Server 站点相关联(绑定)。如果您要恢复数据存储而不保持数据存储与 GIS Server 站点关联,请只指定 --bound false。除非之前的 GIS Server 站点丢失且不可恢复,否则尽量不要这样做;您可以恢复未绑定的数据存储,并使用新的联合 GIS Server 站点对其进行配置。但是,使用数据存储中的数据的图层将不会存在。您必须连接到数据存储数据库才能将数据提取为其他格式,并将其重新发布到门户。
示例
在本示例中,最近备份由 \\buserver\data\backups 到 C:\arcgisdatastore。由于默认存储类型为关系存储,且在默认情况下该数据存储仍会受到所注册的 GIS Server 站点的限制,因此您无需指定 --store relational 或 --bound true。restoredatastore --target most-recent --source-loc \\buserver\data\backups --data-dir C:\arcgisdatastore
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
在本示例中,已启用时间点恢复的关系数据存储将从 \\buserver\data\backups 状态恢复至下午 2:30 时的状态。2014 年 7 月 17 日下午 2:30 (UTC) 时的状态。restoredatastore --target 2014-07-17-14:30:00 --source-loc \\buserver\data\backups
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> <user name> [<database>]
示例
在本示例中,当以用户 hqo.n_1E7 的身份登录时,数据存储数据库不会再接受 workcom 计算机的连接。
revokeconnection workcom hqo.n_1E7
unregisterdatastore
适用于关系、切片缓存和时空大数据存储。
您可以使用 unregisterdatastore 命令实用程序执行下列操作:
- 取消注册 GIS Server 站点中的主关系或切片缓存数据存储计算机。如果已删除使用数据存储数据的托管要素、切片和场景图层,则只能执行此操作。如果不执行此操作,门户中将留有不可用的图层,且托管服务器中将运行不可用的服务。
请注意,如果您有备用计算机,在您取消注册主机之前,必须首先将其从数据存储中移除。
- 取消注册单机时空大数据存储。
如果您决定不再使用数据存储或基于数据存储的服务,则应从 GIS Server 站点取消注册数据存储。取消注册数据存储的计算机时,GIS Server 站点不能再连接到该计算机,并且所有包含取消注册数据存储数据的服务都将不再运行。但是,此命令并不会删除数据;如果您仍然决定需要数据存储,则可使用 registerdatastore 或 configuredatastore 实用程序重新添加数据。
运行 removemachine 移除备用计算机后,unregisterdatastore 实用程序仅可在主关系或切片缓存数据存储计算机上运行。运行 removemachine 移除时空大数据存储的所有其他计算机后如果剩余一台计算机,则仅可运行时空大数据存储的 Unregisterdatastore。
语法
unregisterdatastore --stores <relational|tileCache|spatiotemporal> [--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 将保留关系数据存储备份文件七天。通过运行 updatebackupretaindays 实用程序,您可以更改从备份目录中清除备份文件的频率。
只能在主关系数据存储计算机上运行 updatebackupretaindays 实用程序。
语法
updatebackupretaindays <number of days>
示例
在接下来的示例中会将备份文件保留时间更改为 10 天:
updatebackupretaindays 10
updatebackupschedule
适用于关系、切片缓存和时空大数据存储。
默认情况下,ArcGIS Data Store 每四天创建一次关系数据存储的完整备份。您可以通过运行 updatebackupschedule 实用程序更改创建完整备份的频率。
切片缓存或时空大数据存储没有默认的自动备份。要为时空大数据存储设置自动备份计划,首先必须设置有效的备份位置。
使用 24 小时时钟表示法指定开始时间,例如,00:00:00 表示午夜以及 13:00:00 表示下午 1 点。使用频率选项指定备份间隔的天数。要禁用自动备份,将频率设置为 0。如果禁用自动备份,请确保运行 backupdatastore 实用程序以手动创建备份。
您可在主关系或切片缓存数据存储计算机上运行 updatebackupschedule 实用程序。此工具可在任何时空大数据存储计算机上运行。
语法
updatebackupschedule [--store relational|tileCache|spatiotemporal] [--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
updatelicense
适用于关系数据存储。
ArcGIS Server 许可到期后,必须更新 ArcGIS Server 站点的许可。许可信息也存储在 ArcGIS Data Store 关系数据存储中;因此,更新用于配置数据存储的 ArcGIS Server 站点的许可后,必须更新数据存储中的许可。为此,需在安装有主 ArcGIS Data Store 的计算机上运行 updatelicense 实用程序。如果您有备用 ArcGIS Data Store,则更新后的许可将复制到此处。
语法
updatelicense
示例
更新 ArcGIS Server 许可后,运行 updatelicense 实用程序将新许可移动至数据存储。
updatelicense
updatesslcertificate
可用于所有数据存储类型。
在创建任何数据存储之前,您可以替换用于验证与数据存储配置向导、在托管服务器和数据存储之间的通信的自签名证书,以及由认证机构 (CA) 验证和签名的数据存储计算机之间通信的证书或域名证书。当使用 CA 签名证书时,运行数据存储配置向导不会收到安全警告。
语法
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