GET_RECOVER_STATUS

Содержание раздела
  1. Режимы запроса информации
  2. Поддерживаемые СУБД
  3. Связанные запросы
  4. Синтаксис
  5. Варианты ответа
    1. Параметры ответа
  6. Примеры
    1. Запрос информации по отключенным и восстанавливаемым логическим БД
    2. Запрос информации по всем логическим БД

Поддерживается в версиях: 7.6 / 7.5 / 7.4.

Запрос возвращает информацию о статусе восстановления логических БД окружения в датасорсах. Информация доступна для всех сконфигурированных датасорсов.

Прогресс восстановления можно отслеживать по значению столбцов last_cn_before_disable, last_cn_recovered и last_cn_to_recover в ответе, как схематично показано на рисунке ниже.

Схематичная шкала восстановления операций

Режимы запроса информации

Доступные режимы запроса:

  • (по умолчанию) по всем логическим БД, кроме включенных;
  • по всем логическим БД.

Включенная логическая БД — это логическая БД, либо успешно восстановленная в датасорсе, либо не требующая восстановления из-за отсутствия сбоев.

Поддерживаемые СУБД

Запрос доступен для всех типов СУБД хранилища.

Синтаксис 

GET_RECOVER_STATUS([show_enabled_boolean])

Параметры:

show_enabled_boolean

Флаг, управляющий информацией о включенных логических БД. Возможные значения:

  • false (по умолчанию) — возвращается информация по отключенным и восстанавливаемым логическим БД;
  • true — возвращается информация по всем логическим БД, в том числе включенным.

Варианты ответа

Успешный ответ содержит объект ResultSet, где каждая строка соответствует состоянию одной логической БД в одном датасорсе. Неуспешный ответ содержит исключение.

Параметры ответа

datasource

Имя датасорса.

datamart

Имя логической БД.

status

Статус восстановления логической БД в датасорсе. Возможные значения см. в таблице ниже.

Статус Описание Запись и чтение данных
enabled Логическая БД включена Доступны в полном объеме
disabled Логическая БД отключена автоматически при сбое или вручную для проведения работ. Статус присутствует в следующих случаях:
  • восстановление еще не запускалось;
  • восстановление уже запустилось, но первый блок записей еще не восстановлен;
  • попытка запуска восстановления завершилась ошибкой
 Ограничены
recovering Логическая БД восстанавливается и пока отключена.
Статус устанавливается после восстановления первого блока записей. При успешном восстановлении сменяется на enabled, при неуспешном — остается в recovering		 Ограничены

Причину неуспешного восстановления см. в столбце info ответа.

last_version_before_disable

Номер версии логической БД на момент ее отключения в датасорсе.

Указывается для логических БД в статусах disabled и recovering.

Наибольший номер имеет датасорс, отключенный для логической БД последним. Этот датасорс служит источником данных, если не осталось включенных датасорсов-источников.

last_cn_before_disable

Номер последней успешно завершенной операции записи (в непрерывной последовательности завершенных операций) на момент отключения логической БД в датасорсе.

Указывается для логических БД в статусах disabled и recovering.

Восстановление логической БД в датасорсе начинается с операции, следующей за этой.

cn_max_before_disable

Номер последней незавершенной операции записи на момент отключения логической БД в датасорсе. Если незавершенных операций нет, значение равно last_cn_before_disable.

Система не начинает восстановление логической БД, пока в ней есть незавершенные операции до cn_max_before_disable (включительно).

Указывается для логических БД в статусах disabled и recovering.

last_cn_recovered

Номер последней операции записи, успешно восстановленной для логической БД в датасорсе.

Сразу после отключения логической БД равен last_cn_before_disable. Во время восстановления равен минимальному среди сущностей, по которым еще идет восстановление, после восстановления — максимальному среди восстановленных сущностей.

Указывается для логических БД в статусах disabled и recovering.

last_cn_to_recover

Номер последней операции записи, подлежащей восстановлению в логической БД.

Равен максимальному среди успешно завершенных операций в логических таблицах и материализованных представлениях, максимальному среди всех операций на момент запуска восстановления — в снапшот-таблицах.

Указывается для логических БД в статусах disabled и recovering.

info

Причина, по которой восстановление логической БД не может завершиться в датасорсе.

Примеры

Запрос информации по отключенным и восстанавливаемым логическим БД

Запрос:

GET_RECOVER_STATUS();

-- равнозначен запросу
GET_RECOVER_STATUS(false);

Пример ответа:

datasource datamart status last_version_before_disable last_cn_before_disable last_cn_recovered last_cn_to_recover info
ADP2 db_2 recovering 1403 1749624581331201 1749624601331201 1749624881331201 Delta hot exists [db_2]
ADP2 db_3 disabled 2009 1749625209767317 1749625209767317 1749625229767317 No donor available [db_3]
ADP3 db_2 disabled 832 1749624581845682 1749624581845682 1749624881331201  
ADP3 db_3 recovering 2451 1749625209767317 1749625219767317 1749625229767317  

Запрос информации по всем логическим БД

Запрос:

GET_HEALTH_STATE(true)

Пример ответа:

datasource datamart status last_version_before_disable last_cn_before_disable last_cn_recovered last_cn_to_recover info
ADB db_1 enabled          
ADP db_1 enabled          
ADP db_2 enabled          
ADP db_3 enabled          
ADP2 db_1 enabled          
ADP2 db_2 recovering 1403 1749624581331201 1749624601331201 1749624881331201 Delta hot exists [db_2]
ADP2 db_3 disabled 2009 1749625209767317 1749625209767317 1749625229767317 No donor available [db_3]
ADP3 db_1 enabled          
ADP3 db_2 disabled 832 1749624581845682 1749624581845682 1749624881331201  
ADP3 db_3 recovering 2451 1749625209767317 1749625219767317 1749625229767317