GET_CHANGES

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

Поддерживается в версиях: 7.0 / 6.12 / 6.11 / 6.10 / 6.9 / 6.8 / 6.7 / 6.6 / 6.5 / 6.4 / 6.3 / 6.2 / 6.1 / 6.0 / 5.8 / 5.7 / 5.6 / 5.5 / 5.4 / 5.3.

Запрос возвращает содержимое журнала — список операций по изменению логической схемы данных.

Журнал ведется в системе, начиная с версии 5.3. Изменения более ранних версий системы в журнале отсутствуют.

  • ERASE_CHANGE_OPERATION — отменяет незавершенную операцию по изменению логической схемы данных.

Синтаксис 

GET_CHANGES([db_name])

Параметры:

db_name

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

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

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

Для логических баз данных, которые создавались и изменялись только до версии 5.3, в ответе возвращается пустой объект ResultSet.

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

По каждой операции доступна информация:

  • change_num — номер операции в рамках логической БД;
  • entity_name — имя логической сущности, задействованной в операции;
  • change_query — содержимое DDL-запроса, создавшего операцию;
  • start_time — дата и время начала выполнения запроса change_query;
  • end_time — дата и время окончания выполнения запроса change_query. Поле имеет значение NULL, если операция еще не завершена;
  • delta_num — последняя закрытая дельта в логической базе данных на момент запроса информации. Поле имеет значение NULL, если в логической БД нет ни одной закрытой дельты.

Начиная с версии 6.1, запрос в столбце change_query может содержать переносы строк.
В предыдущих версиях запрос возвращался без переносов.

Ограничения

Для логических баз данных, которые не изменялись после версии 5.2, возвращается пустой объект ResultSet.

Примеры

Запрос журнала в указанной логической БД 

GET_CHANGES(marketing)

На рисунке ниже показан пример ответа GET_CHANGES, содержащего информацию о пяти созданных таблицах.

Ответ GET_CHANGES

Запрос журнала в логической БД по умолчанию 

-- выбор логической базы данных marketing в качестве базы данных по умолчанию
USE marketing;

-- запрос журнала для выбранной логической БД
GET_CHANGES();