ALTER MATERIALIZED VIEW DROP RETENTION

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

1. Связанные запросы
2. Как работает запрос
   1. Регистрация запроса
   2. Обработка запроса
   3. Успешный результат
   4. Неуспешный результат
3. Синтаксис
4. Варианты ответа
5. Ограничения
6. Примеры

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

Запрос удаляет retention-правило материализованного представления.

Если удаляемое правило направлено на остужение данных, вместе с ним удаляются накопленные по нему холодные данные.

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

• CREATE MATERIALIZED VIEW с ключевым словом RETENTION — создает представление;
• ALTER MATERIALIZED VIEW ADD RETENTION — добавляет retention-правило;
• GET_ENTITY_DDL — возвращает DDL-скрипт представления с его retention-правилами.

Как работает запрос

Регистрация запроса

Каждое удаление retention-правила записывается в журнал, доступный с помощью запроса GET_CHANGES.

Обработка запроса

Запрос попадает в очередь операций и обрабатывается в порядке его поступления в очередь.

Успешный результат

При успешном выполнении запроса система удаляет:

• retention-правило;
• [для правила остужения данных] физическую таблицу со всеми холодными данными представления, накопленными по этому правилу, из датасорса-приемника.

Неуспешный результат

При ошибке исполнения корректного запроса система блокирует все последующие DDL-запросы в логической БД. О снятии такой блокировки см. в разделе Снятие блокировки DDL-запросов.

Синтаксис

ALTER MATERIALIZED VIEW [db_name.]materialized_view_name
DROP RETENTION 'source_datasource'

Параметры:

db_name

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

materialized_view_name

Имя материализованного представления, для которого удаляется retention-правило.

source_datasource

Имя датасорса-источника, для которого удаляется retention-правило. Должно соответствовать конфигурации.

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

В ответе возвращается:

• пустой объект ResultSet при успешном выполнении запроса;
• исключение при неуспешном выполнении запроса.

Ограничения

• Запрос доступен для СУБД ADB и ADP.
• Выполнение запроса недоступно, если представление сейчас синхронизируется или установлен запрет на изменение сущностей.

Примеры

ALTER MATERIALIZED VIEW matview_db.sales_august_2020
DROP RETENTION 'adb'