DROP TABLE

Запрос позволяет удалить логическую таблицу и ее данные из логической базы данных. В зависимости от параметров запроса данные таблицы удаляются из указанных или всех СУБД хранилища.

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

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

При успешном выполнении запроса данные логической таблицы удаляются из указанных СУБД хранилища. Логическая таблица удаляется из логической схемы данных при удалении данных из последней СУБД.

Внимание: удаленные данные не подлежат восстановлению средствами системы. Удаление данных из СУБД, заданной для выгрузки в конфигурации системы, приведет к невозможности выгрузки этих данных.

Синтаксис

DROP TABLE [IF EXISTS] [db_name.]table_name
[DATASOURCE_TYPE = datasource_alias]

Опциональная секция IF EXISTS активирует проверку существования логической таблицы до попытки ее удаления. При наличии этой секции запрос по отсутствующей таблице возвращает успешный ответ.

Параметры

• db_name — имя логической базы данных, из которой удаляется логическая таблица. Указывается опционально, если выбрана логическая БД, используемая по умолчанию;
• table_name — имя удаляемой логической таблицы;
• datasource_alias — псевдоним СУБД хранилища, из которой удаляются данные логической таблицы. Возможные значения: adb, adqm и adg. Значение можно указывать без кавычек, в одинарных кавычках (например, 'adb') или двойных кавычках (например, "adb"). Если секция DATASOURCE_TYPE с псевдонимом не указана, данные удаляются из всех СУБД хранилища.

Примеры

Удаление логической таблицы с удалением данных из всех СУБД хранилища:

DROP TABLE sales.sales

Удаление логической таблицы с проверкой на ее существование:

DROP TABLE IF EXISTS sales.sales_unknown_existence

Последовательное удаление логической таблицы из ADB и ADG:

DROP TABLE sales.stores DATASOURCE_TYPE = adb
DROP TABLE sales.stores DATASOURCE_TYPE = adg