DROP TABLE
Содержание раздела
Поддерживается в версиях: 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.
Запрос позволяет удалить указанную таблицу — логическую таблицу или прокси-таблицу — вместе с ее данными.
Целевые датасорсы
Если в запросе указано ключевое слово DATASOURCE_TYPE, данные таблицы удаляются из указанных датасорсов; иначе — из всех датасорсов. При удалении данных таблицы из последнего датасорса система также удаляет саму таблицу из логической схемы данных.
При наличии retention-правил для логической таблицы данные также удаляются из связанных датасорсов, которые служат хранилищем холодных данных.
Как работает запрос
Запрос попадает в очередь операций и обрабатывается в порядке его поступления в очередь. Каждое удаление таблицы записывается в журнал, который можно посмотреть с помощью запроса GET_CHANGES.
При удалении таблицы также удаляется ее tslog. Это происходит независимо от наличия или отсутствия ключевого слова LOGIСAL_ONLY в запросе.
При ошибке исполнения корректного запроса система блокирует все последующие DDL-запросы в логической БД. О снятии такой блокировки см. в разделе Снятие блокировки DDL-запросов.
Синтаксис
DROP TABLE [IF EXISTS] [db_name.]table_name
[DATASOURCE_TYPE = 'datasource_name']
[LOGICAL_ONLY]
Параметры:
db_name-
Имя логической базы данных, из которой удаляется таблица. Опционально, если выбрана логическая БД, используемая по умолчанию.
table_name-
Имя удаляемой таблицы.
Ключевое слово IF EXISTS
Включает проверку наличия таблицы до попытки удаления. Если ключевое слово указано в запросе, успешный ответ возвращается при отсутствии или успешном удалении таблицы, иначе — только при успешном удалении таблицы.
Ключевое слово DATASOURCE_TYPE = 'datasource_name'
Задает имя датасорса, из которого удаляются данные таблицы. Имя должно быть указано в соответствии с конфигурацией.
При удалении данных таблицы из последнего датасорса система также удаляет саму таблицу из логической схемы данных.
Если ключевое слово не указано, данные таблицы удаляются изо всех датасорсов, в которых эти данные размещены.
Ключевое слово LOGICAL_ONLY
Позволяет удалить таблицу только на логическом уровне (из логической схемы данных), не обновляя физическую схему и не удаляя данные из хранилища данных.
Данные логической таблицы становятся недоступны при ее удалении и пересоздании с ключевым словом LOGICAL_ONLY. Вернуть доступ можно только к данным актуальной версии, выполнив операцию записи в пересозданной таблице.
Если ключевое слово не указано, таблица удаляется на логическом и физическом уровнях.
Варианты ответа
В ответе возвращается:
- пустой объект ResultSet при успешном выполнении запроса;
- исключение при неуспешном выполнении запроса.
Ограничения
- Выполнение запроса к логической таблице недоступно, если она участвует в незавершенной операции записи.
- Выполнение запроса недоступно, если установлен запрет на изменение сущностей.
- Удаление партиционированной таблицы недоступно, если у таблицы есть партиции.
Примеры
Удаление таблицы с удалением данных из всех датасорсов
Удаление логической таблицы:
DROP TABLE marketing.sales
Удаление прокси-таблицы:
DROP TABLE marketing.payments_proxy
Удаление таблицы и ее данных с проверкой наличия таблицы
DROP TABLE IF EXISTS marketing.sales_unknown_existence
Удаление таблицы и ее данных из двух датасорсов
-- удаление таблицы из датасорса adb
DROP TABLE marketing.stores DATASOURCE_TYPE = 'adb';
-- удаление таблицы из датасорса adg
DROP TABLE marketing.stores DATASOURCE_TYPE = 'adg';
Удаление таблицы только на логическом уровне
DROP TABLE marketing.sales1 LOGICAL_ONLY