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