Команды REST ArcGIS Data Store

Когда вы настраиваете ArcGIS Data Store, вы связываете его с хост-сервером. Действия, связанные с изменением или проверкой состояния хранилища данных, выполняются из каталога администраторов ArcGIS Server для хост-сервера от имени администратора ArcGIS Server. (Формат URL — https://gisserver.example.com:6443/arcgis/admin.) Вы можете удалить резервный компьютер из реляционного хранилища, работающего в режиме первичного ожидания, и удалить резервный компьютер с сайта ГИС-сервера в ArcGIS Server Administrator Directory. В следующих разделах приводится описание этих операций и ссылка на документацию ArcGIS API.

Если вы не являетесь администратором ArcGIS Server для хост-сервера, вам нужно обратиться к администратору, чтобы выполнить описанные ниже задачи.

Здесь приводятся пути в ArcGIS Server Administrator Directory, которым надо следовать, чтобы получить доступ к операциям для каждого типа ArcGIS Data Store:

• Реляционное хранилище данных: щелкните данные > элементы > enterpriseDatabases > <имя хранилища данных> > компьютеры > <имя компьютера>.

• Хранилище пространственно-временных больших данных — щелкните данные > элементы > nosqlDatabases > AGSDataStore_bigdata_<имя хранилища данных> > компьютеры > <имя компьютера>.

• Хранилище графов — щелкните данные > элементы > nosqlDatabasesAGSDataStore_graph_<имя хранилища данных> > компьютеры > <имя компьютера>.

• Хранилище объектов — щелкните данные > элементы > objectStores > <имя хранилища данных> > компьютеры > <имя компьютера>.

Изменение статуса компьютера с хранилищем данных

Вы можете остановить и перезапустить отдельные компьютеры в хранилище данных. Также можно преобразовать резервный компьютер реляционного хранилища данных в основной.

Остановка основного компьютера хранилища данных не приводит к отказу хранилища данных в локальном развертывании, так как при выполнении, например, такой задачи обслуживания, как временный перевод хранилища данных в режим офлайн, вы можете не захотеть переключаться на резервное хранилище.

Например, статус компьютера с хранилищем данных меняется в следующих случаях:

• Остановка резервного компьютера.

• Обновление резервного компьютера.

• Запуск резервного компьютера.

• Перевод резервного компьютера в режим основного с помощью команды makePrimary.

• Остановка компьютера, ранее бывшего основным.

• Обновление компьютера, ранее бывшего основным.

• Запуск компьютера, ранее бывшего основным.

• Добавление бывшего основного компьютера назад к хранилищу данных в качестве резервного.

Войдите в ArcGIS Server Administrator Directory для хост-сервера как администратор сайта ArcGIS Server, выберите определенный компьютер и с помощью любой из следующих команд измените статус компьютера хранилища данных:

• stop

• start

• makePrimary (резервные компьютеры реляционного хранилища)

Проверка хранилища данных

Можно проверить статус компьютеров хранилища данных можно с помощью команды validate REST ArcGIS Server.

Войдите в ArcGIS Server Administrator Directory как обслуживающего сервера от имени администратора сайта ArcGIS Server, перейдите на один из компьютеров в конкретном типе хранилища данных, которое вы хотите проверить, и щелкните проверить, чтобы просмотреть информацию, связанную с этим хранилищем данных. Важная информация, связанная с состоянием хранилища данных, включает следующее:

• overallhealth — значения следующие:

  • Healthy — все компоненты на всех машинах-участниках доступны и работают.

  • HealthyWithWarning — это состояние применяется только к реляционным хранилищам данных, хранилищам объектов и хранилищам графов. Один или несколько компонентов недоступны, но хранилище данных по-прежнему можно использовать. Это значение возвращается для реляционных хранилищ, когда основной компьютер исправен, а резервный недоступен. Реляционное хранилище данных на данный момент не является отказоустойчивым. Для хранилищ объектов и хранилищ графов, работающих в режиме кластера, хранилище данных может не быть отказоустойчивым.

  • Unhealthy - Хранилище данных считается неисправным, если более половины компьютеров в нем недоступны ("datastore.overallhealth": "Unhealthy"). Компьютер считается неисправным, если он недоступен ("machine.overallhealth": "Unhealthy").

• status – для реляционного хранилища возможны значения Started и Stopped. Если статус — stopped (остановлено), вы не можете публиковать размещённые векторные слои или размещённые 3D-слои у себя на портале.

• clusterStatus — для хранилищ больших пространственно-временных данных возможны следующие статусы:

  • Зелёный – все данные доступны.

  • Жёлтый – все данные доступны, но некоторые или все копии реплик данных недоступны и ваше хранилище больших пространственно-временных данных сейчас высоко доступно. Вы всегда будете видеть этот статус, если настроили хранилище больших пространственно-временных данных на одной машине. Вы также можете увидеть этот статус, если машины перебалансируют данные, или одна или несколько машин в вашем хранилище пространственно-временных больших данных недоступны. Если у вас многомашинное хранилище пространственно-временных больших данных и вы видите жёлтый статус, убедитесь, что все машины по-прежнему доступны, проверяя каждую машину. Если они доступны, подождите несколько часов и проверьте ещё раз. Если статус всё ещё жёлтый, изучите журналы ArcGIS Server на предмет ошибок.

  • Красный – некоторые или все данные недоступны. Изучите журналы и исправьте ошибки.

• role – для компьютеров в реляционном хранилище это показывает, что компьютер является основным или резервным. Для хранилища объектов и хранилища графов роль будет основной для одного экземпляра и cluster_member — для хранилища объектов, развернутого в режиме кластера.

• messages – вы увидите здесь предупреждения и сообщения об ошибках, связанные с состоянием хранилища данных.

Вы можете использовать проверку в следующих целях:

• Чтобы убедиться в том, что компьютер хранилища данных остановлен или запущен.

• Чтобы убедиться в том, что команда makePrimary повысила статус резервного компьютера до основного.

• В качестве первого шага по устранению неполадок, если размещенные слои объектов или сцен не могут быть опубликованы или являются недоступными, если вы не можете создать граф знаний или получить к нему доступ.

Удаление резервного компьютера

Вы можете удалить резервный компьютер из реляционного хранилища с помощью команды remove REST ArcGIS Server. Например, если вы хотите использовать в качестве резервного другой компьютер, вы можете удалить текущий из хранилища данных, установить ArcGIS Data Store на новом компьютере и настроить его как резервный.

Войдите в ArcGIS Server Administrator Directory для хост-сервера в качестве администратора сайта ArcGIS Server, чтобы использовать команду remove.

Управление кэшем ответов на запросы

Администраторы организаций и владельцы векторных слоёв и слоёв изображений карты могут включить кэширование ответов запросов на отдельных слоях для повышения эффективности запросов. Эти ответы на запросы кэшируются в хранилище объектов. В зависимости от того, как долго хранятся кэши (политика истечения срока действия кэша) и сколько дискового пространства доступно на машине или машинах, на которых запущено хранилище объектов, хранилище объектов может заполниться и перестать функционировать.

В качестве администратора ArcGIS Data Store вы должны выполнить следующее, если развертывание ArcGIS Enterprise использует хранилище объектов ArcGIS Data Store:

• Настройте хранилище объектов на компьютерах, на которых достаточно места на диске для хранения этого кэша вместе с другими данными, хранящимися в хранилище объектов.

• Отслеживайте журналы ArcGIS Data Store, чтобы определить, когда хранилище объекта приближается к пределу вместимости. Вы можете проверить хранилище объектов, чтобы определить, какой процент дискового пространства используется на машинах хранилища объектов. При необходимости обратитесь к администратору ArcGIS Server, чтобы изменить политику истечения срока действия кэша или удалить кэш слоев больших объемов, отключив кэширование ответов для этих векторных слоев.

• Периодически запускайте утилиту maintaindatastore для очистки просроченного кэша из хранилища объектов.

Для получения информации о кэше ответов на запросы, о том, когда можно их использовать и как их включить, см. раздел Включение кэширования ответов.

Инструкции по изменению политики истечения срока действия см. Update Definition в справочнике ArcGIS REST API.