DROP MATERIALIZED VIEW
Содержание раздела
Поддерживается в версиях: 6.4 / 6.3 / 6.2 / 6.1 / 6.0 / 5.8 / 5.7 / 5.6 / 5.5 / 5.4 / 5.3 / 5.2 / 5.1 / 5.0.
Запрос позволяет удалить материализованное представление и его данные.
Запрос попадает в очередь операций и обрабатывается в порядке его поступления в очередь. В ответе возвращается:
- пустой объект ResultSet при успешном выполнении запроса;
- исключение при неуспешном выполнении запроса.
При ошибке выполнения корректного запроса все последующие запросы в логической БД блокируются. В этом случае следует устранить причины сбоя и повторить сбойную операцию. Если повторение операции невозможно, удалите сбойную операцию запросом ERASE_CHANGE_OPERATION и вручную устраните несоответствия на физическом уровне (если такие есть).
Каждое удаление представления записывается в журнал. Журнал можно посмотреть с помощью запроса GET_CHANGES.
Синтаксис
DROP MATERIALIZED VIEW [IF EXISTS] [db_name.]materialized_view_name
[DATASOURCE_TYPE = datasource_alias]
[LOGICAL_ONLY]
Параметры:
db_name
-
Имя логической базы данных, из которой удаляется материализованное представление. Опционально, если выбрана логическая БД, используемая по умолчанию.
table_name
-
Имя удаляемого материализованного представления.
datasource_alias
-
Имя датасорса, из которого удаляются данные представления.
Указывается в одинарных кавычках (например,'adg'
). Варианты, которые остаются доступными, но могут быть удалены в будущем: значение без кавычек (например,adg
) или в двойных кавычках (например,"adg"
).
Ключевое слово IF EXISTS
Ключевое слово IF EXISTS
включает проверку наличия материализованного представления до попытки удаления. Если ключевое слово указано в запросе, успешный ответ возвращается при отсутствии или успешном удалении материализованного представления, иначе — только при успешном удалении материализованного представления.
Ключевое слово DATASOURCE_TYPE
Ключевое слово DATASOURCE_TYPE
задает датасорс, из которого удаляются данные представления. При удалении данных представления из последнего датасорса система также удаляет само материализованное представление из логической схемы данных. См. также параметр datasource_alias.
Если ключевое слово не указано, данные представления удаляются из всех датасорсов, в которых эти данные размещены.
Ключевое слово LOGICAL_ONLY
Ключевое слово LOGICAL_ONLY
позволяет удалить материализованное представление только на логическом уровне (из логической схемы данных), без удаления связанных физических таблиц и размещенных в них данных из хранилища данных.
Если ключевое слово не указано, удаляется как материализованное представление, так и связанные с ним физические таблицы.
Ограничения
- Выполнение запроса недоступно, если есть незавершенная операция записи или установлен запрет на изменение сущностей.
Примеры
Удаление представления с удалением данных из всех датасорсов
DROP MATERIALIZED VIEW marketing.sales_and_stores
Удаление представления с проверкой его наличия
DROP MATERIALIZED VIEW IF EXISTS marketing.mat_view_with_unknown_existence
Удаление представления с удалением данных из одного датасорса
DROP MATERIALIZED VIEW marketing.sales_july_2021 DATASOURCE_TYPE = 'adg'
Удаление представления только на логическом уровне
DROP MATERIALIZED VIEW marketing.stores_by_sold_products_matview LOGICAL_ONLY