DROP WRITABLE 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.
Запрос позволяет удалить внешнюю writable-таблицу.
По умолчанию система удаляет внешнюю таблицу из логической базы данных и не удаляет связанную с ней standalone-таблицу из датасорса, где эта таблица размещена. Чтобы standalone-таблица автоматически удалилась при удалении внешней таблицы, укажите в запросе ключевое слово OPTIONS
со значением auto.drop.table.enable=true
.
Синтаксис
DROP WRITABLE 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 WRITABLE EXTERNAL TABLE IF EXISTS marketing.agreements_ext_write_adp
OPTIONS ('auto.drop.table.enable=true')
Удаление внешней таблицы без удаления standalone-таблицы
DROP WRITABLE EXTERNAL TABLE marketing.payments_ext_write_adqm