GET_RECOVER_STATUS

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

Поддерживается в версиях: 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.

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

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