ArcGIS Data Store команды REST

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

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

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

• Реляционное хранилище данных: щелкните данные > элементы > enterpriseDatabases > <имя хранилища данных> > компьютеры > <имя компьютера>.
• Хранилище больших пространственно-временных данных - щелкните данные > элементы > nosqlDatabases > большие данные AGSDataStore_<имя хранилища данных> > компьютеры > <имя компьютера>.
• Хранилище данных полистного кэша - щелкните данные > элементы > nosqlDatabases > AGSDataStore_nosql_<имя хранилища данных> > компьютеры > <имя компьютера>.
• Хранилище данных графов - щелкните данные > элементы > nosqlDatabases > AGSDataStore_graph_<имя хранилища данных> > компьютеры > <имя компьютера>.
• Хранилище объектов — щелкните данные > элементы > objectStores > <имя хранилища данных> > компьютеры > <имя компьютера>.

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

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

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

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

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

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

• stop
• start
• makePrimary (только резервные компьютеры реляционного хранилища данных, хранилища данных полистного кэша или хранилища графов в режиме первичного ожидания)

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

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

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

• overallhealth - Значения следующие:
  • Healthy - Все компоненты на всех машинах-участниках доступны и работают.
  • HealthyWithWarning - это состояние применяется только к реляционным хранилищам данных, хранилищам объектов и хранилищам графов. Один или несколько компонентов недоступны, но хранилище данных по-прежнему можно использовать. Это значение возвращается для хранилищ графов и реляционных хранилищ данных, когда основная машина исправна, а резервная недоступна. Хранилище графов или реляционное хранилище данных на данный момент не является отказоустойчивым. Для хранилищ объектов, содержащих более одной машины, хранилище данных может не быть отказоустойчивым, в зависимости от количества компьютеров в кластере.
  • Unhealthy - Хранилище данных считается нездоровым, если более половины компьютеров в нем недоступны ("datastore.overallhealth": "Unhealthy"). Компьютер считается нездоровым, если он недоступен ("machine.overallhealth": "Unhealthy").
• Статус – для реляционного хранилища или хранилища данных кэша возможные значения Запущено или Остановлено. Если stopped (остановлено), вы не можете публиковать размещённые векторные слои или размещённые слои сцен у себя на портале.
• clusterStatus - для хранилищ больших пространственно-временных данных возможны следующие статусы:
  • Зелёный – все данные доступны
  • Жёлтый – все данные доступны, но некоторые или все копии реплик данных недоступны и ваше хранилище больших пространственно-временных данных сейчас высоко доступно. Вы всегда будете видеть этот статус, если настроили хранилище больших пространственно-временных данных на одной машине. Вы также можете увидеть этот статус, если машины перебалансируют данные, или одна или несколько машин в вашем хранилище пространственно-временных больших данных недоступны. Если у вас многомашинное хранилище пространственно-временных больших данных и вы видите жёлтый статус, убедитесь, что все машины по-прежнему доступны, проверяя каждую машину. Если они доступны, подождите несколько часов и проверьте ещё раз. Если статус всё ещё жёлтый, изучите журналы ArcGIS Server на предмет ошибок.
  • Красный – некоторые или все данные недоступны. Изучите журналы и исправьте ошибки.
• роль – это относится только к машинам в реляционном хранилище данных, хранилище графов или хранилище данных кэша листов в режиме первичного ожидания, и означает, что машина является основной или резервной. Для хранилища объектов роль будет primary для одного экземпляра и cluster_member для хранилища объектов, развернутого в кластерном режиме.
• Сообщения – вы увидите здесь предупреждения и сообщения об ошибках, связанные с состоянием хранилища данных. Например, если вы проверяете хранилище данных полистного кэша с несколькими компьютерами, вы получите сообщение, если данные кэша сцены в настоящее время не являются высокодоступными (другими словами, существует только одна копия одного или нескольких кэшей сцены).

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

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

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

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

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

Управление кэшем ответов на запросы для размещённых векторных слоев

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

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

Включить кэширование ответов на запросы для векторных слоев

Чтобы включить кэширование слоя или слоев в размещенном векторном слое (сервис объектов), администратор сайта хост-сервера ArcGIS Server должен войти в Administrator Directory хост-сервера ArcGIS Server и отправить следующий запрос с помощью операции REST Update Definition:

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

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

Настройка или изменение политики истечения срока действия кэша

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

Для слоев, к которым не осуществляется постоянный доступ, или если дисковое пространство является проблемой, установите, как долго (в днях) будет храниться кэш ответов на запросы для слоя.

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

Имейте в виду, что срок действия кэша истекает в полночь по времени UTC. Если вы установите политику истечения срока действия равной 1, кэш может сохраняться почти до двух дней, в зависимости от того, когда он будет создан.

Например, если клиент обращается к векторному слою в 4:00 UTC, его кэш будет сохраняться до 24:00 UTC следующего дня.

Удаление кэша слоя

Если в хранилище объектов закончилось дисковое пространство, вы увидите предупреждение в журналах ArcGIS Data Store, а также команда validate REST покажет, сколько пространства на диске используется. Вы не можете добавить дисковое пространство или компьютеры в существующее хранилище объектов, поэтому вам может потребоваться очистить кэши, чтобы освободить дисковое пространство. Для этого администратор хост-сервера ArcGIS Server должен отключить кэширование для этого слоя.

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