DROP WRITABLE EXTERNAL TABLE

Содержание раздела
  1. Синтаксис
    1. Ключевое слово IF EXISTS
    2. Ключевое слово OPTIONS
  2. Варианты ответа
  3. Примеры
    1. Удаление внешней таблицы с удалением standalone-таблицы
    2. Удаление внешней таблицы без удаления standalone-таблицы

Поддерживается в версиях:  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