SYNC_MATERIALIZED_VIEWS

Содержание раздела

Связанные запросы
Синтаксис
Варианты ответа
1. Параметры синхронного ответа
2. Примеры причин неуспешного ответа
Примеры
1. Запуск синхронизации в синхронном режиме
2. Запуск синхронизации в асинхронном режиме

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

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

Если настроена публикация системных событий, по каждому успешно синхронизированному представлению публикуется событие SYNC_OK.

Прогресс синхронизации можно проверить с помощью CHECK_MATERIALIZED_VIEW.

Запустить однократную синхронизацию также можно с помощью HTTP-метода /entities/sync.

Связанные запросы

CREATE MATERIALIZED VIEW — создает представление;
CHECK_MATERIALIZED_VIEW — возвращает информацию по представлению;
DROP MATERIALIZED VIEW — удаляет представление.

Синтаксис

Синхронизация в указанной логической БД:

SYNC_MATERIALIZED_VIEWS(db_name[, async_boolean])

Синхронизация в логической БД, используемой по умолчанию:

SYNC_MATERIALIZED_VIEWS([async_boolean])

Параметры:

db_name

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

async_boolean

Флаг, переключающий режим обработки запроса. Возможные значения:

false (по умолчанию) — выполнить запрос синхронно и вернуть ответ после завершения синхронизации;
true — выполнить запрос асинхронно и вернуть ответ сразу после обработки запроса, не дожидаясь завершения синхронизации.

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

Успешный ответ содержит:

объект ResultSet с параметрами автоматической* дельты — для синхронного запроса;
пустой объект ResultSet — для асинхронного запроса.

Неуспешный ответ содержит исключение.

* Автоматическая дельта объединяет изменения данных, загруженные в материализованные представления логической БД за один цикл синхронизации. Подробнее см. в разделе Материализованное представление.

Параметры синхронного ответа

Успешный синхронный ответ содержит параметры автоматической дельты:

delta_num — номер дельты;
delta_date — дата и время закрытия дельты в формате YYYY-MM-DD hh:mm:ss.SSSSSS;
cn_from — номер операции записи, с которой началась дельта.

Примеры причин неуспешного ответа

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

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

Примеры

Запуск синхронизации в синхронном режиме

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

SYNC_MATERIALIZED_VIEWS(matview_db);

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

USE matview_db;
SYNC_MATERIALIZED_VIEWS();

Запуск синхронизации в асинхронном режиме

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

SYNC_MATERIALIZED_VIEWS(matview_db, true);

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

USE matview_db;
SYNC_MATERIALIZED_VIEWS(true);