DROP MATERIALIZED VIEW

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

Поддерживается в версиях: 7.0 / 6.12 / 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 = 'destination_datasource']
[LOGICAL_ONLY]

Параметры:

db_name

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

materialized_view_name

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

Ключевое слово IF EXISTS

Включает проверку наличия материализованного представления до попытки удаления. Если ключевое слово указано в запросе, успешный ответ возвращается при отсутствии или успешном удалении материализованного представления, иначе — только при успешном удалении материализованного представления.

Ключевое слово DATASOURCE_TYPE = 'destination_datasource'

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

При удалении данных представления из последнего датасорса система также удаляет само материализованное представление из логической схемы данных.

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

Ключевое слово 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