DROP READABLE EXTERNAL 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.
Запрос удаляет внешнюю readable-таблицу из логической базы данных.
По умолчанию система не удаляет standalone-таблицу, связанную с удаляемой readable-таблицей. Чтобы автоматически удалить standalone-таблицу при удалении внешней таблицы, укажите в запросе ключевое слово OPTIONS со значением auto.drop.table.enable=true.
Синтаксис
DROP READABLE EXTERNAL TABLE [IF EXISTS] [db_name.]ext_table_name
[OPTIONS ('option=value[; ... ]')]
Параметры:
db_name-
Имя логической базы данных, из которой удаляется внешняя таблица. Опционально, если выбрана логическая БД, используемая по умолчанию.
ext_table_name-
Имя удаляемой внешней таблицы.
Ключевое слово IF EXISTS
Включает проверку наличия внешней таблицы до попытки удаления. Если ключевое слово указано в запросе, успешный ответ возвращается при отсутствии или успешном удалении внешней таблицы, иначе — только при успешном удалении внешней таблицы.
Ключевое слово OPTIONS ('option=value[; ... ]')
Задает список дополнительных параметров (option) и их значений (value) из следующих:
auto.drop.table.enable— признак автоматического удаления standalone-таблицы при удалении внешней readable-таблицы. Возможные значения:false(по умолчанию) — не удалять standalone-таблицу,true— удалить standalone-таблицу.
Варианты ответа
В ответе возвращается:
- пустой объект ResultSet при успешном выполнении запроса;
- исключение при неуспешном выполнении запроса.
Примеры
Удаление внешней таблицы с удалением standalone-таблицы
DROP READABLE EXTERNAL TABLE IF EXISTS marketing.agreements_ext_read_adp
OPTIONS ('auto.drop.table.enable=true')
Удаление внешней таблицы без удаления standalone-таблицы
DROP READABLE EXTERNAL TABLE marketing.payments_ext_read_adqm