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