ArcGIS Data Store команды REST

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вы можете проверить хранилище данных, чтобы убедиться, что компьютер был остановлен или запущен, чтобы убедиться, что резервный был сделан основным после того, как вы использовали команду 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 должен войти в ArcGIS Server Administrator Directory обслуживающего сервера и отправить следующий запрос

{
    "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
    }
}