DROP MATERIALIZED VIEW

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

Поддерживается в версиях:  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.2 / 5.1 / 5.0.

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

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

Запрос попадает в очередь операций и обрабатывается в порядке его поступления в очередь. Каждое удаление представления записывается в журнал, который можно посмотреть с помощью запроса GET_CHANGES.

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

Синтаксис

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 позволяет удалить материализованное представление только на логическом уровне (из логической схемы данных), без удаления связанных физических таблиц и размещенных в них данных из хранилища данных.

Если ключевое слово не указано, удаляется как материализованное представление, так и связанные с ним физические таблицы.

Ключевое слово LOGICAL_ONLY

Ключевое слово LOGICAL_ONLY позволяет удалить материализованное представление только в логической схеме данных, без обновления физической схемы данных.

Если ключевое слово не указано, материализованное представление удаляется на логическом и физическом уровнях.

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

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

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

Ограничения

Примеры

Удаление представления с удалением данных из всех датасорсов

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