DROP MATERIALIZED VIEW

Содержание раздела
  1. Синтаксис
    1. Ключевое слово IF EXISTS
    2. Ключевое слово DATASOURCE_TYPE
    3. Ключевое слово LOGICAL_ONLY
  2. Ограничения
  3. Примеры
    1. Удаление представления с удалением данных из всех датасорсов
    2. Удаление представления с проверкой его наличия
    3. Удаление представления с удалением данных из одного датасорса
    4. Удаление представления только на логическом уровне

Поддерживается в версиях:  6.2 / 6.1.1 / 6.0 / 5.8 / 5.7 / 5.6.1 / 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