ALTER TABLE DROP COLUMN

Содержание раздела
  1. Синтаксис
    1. Ключевое слово IF EXISTS
    2. Ключевое слово LOGICAL_ONLY
  2. Ограничения
    1. Ограничения выполнения
    2. Ограничения партиционирования
    3. Другие ограничения
  3. Примеры
    1. Удаление столбца без ключевых слов
    2. Удаление столбца с ключевым словом IF EXISTS
    3. Удаление столбца с ключевым словом LOGICAL_ONLY

Поддерживается в версиях:  6.5 / 6.4 / 6.3 / 6.2 / 6.1 / 6.0.

Запрос удаляет столбец из логической таблицы.

Запрос поддерживается для СУБД ADB, ADP и ADQM.

Запрос попадает в очередь операций и обрабатывается в порядке его поступления в очередь. В ответе возвращается:

  • пустой объект ResultSet при успешном выполнении запроса;
  • исключение при неуспешном выполнении запроса.

При успешном выполнении запроса система обновляет структуру логической таблицы в сервисной базе данных, а структуру связанных физических таблиц — в хранилище данных.

После изменения структуры логической таблицы некоторые SELECT-запросы к логическим и материализованным представлениям, связанным с измененной таблицей, могут стать недоступными. В этом случае нужно пересоздать сбойные представления.

Ошибка выполнения корректного запроса блокирует исполнение последующих запросов в этой логической базе данных. В случае блокировки устраните причины сбоя и повторите сбойную операцию. Если повторение операции невозможно, удалите сбойную операцию запросом ERASE_CHANGE_OPERATION и вручную устраните несоответствия на физическом уровне (если такие есть).

Каждое изменение таблицы записывается в журнал. Журнал можно посмотреть с помощью запроса GET_CHANGES.

Синтаксис 

ALTER TABLE [db_name.]table_name
DROP COLUMN [IF EXISTS] column_name
[LOGICAL_ONLY]

Параметры:

db_name

Имя логической базы данных, которой принадлежит изменяемая логическая таблица. Опционально, если выбрана логическая БД, используемая по умолчанию.

table_name

Имя изменяемой логической таблицы.

new_column_name

Имя удаляемого столбца таблицы.

Ключевое слово IF EXISTS

Ключевое слово IF EXISTS включает проверку наличия столбца до попытки его удаления. Если ключевое слово указано в запросе, система возвращает успешный ответ как по успешно удаленному, так и по отсутствующему столбцу; иначе — только по успешно удаленному столбцу.

Ключевое слово LOGICAL_ONLY

Ключевое слово LOGICAL_ONLY позволяет создать удалить столбец только на логическом уровне (в логической схеме данных), без обновления связанных физических таблиц в хранилище данных.

Если ключевое слово не указано, столбец удаляется из логической таблицы на логическом и физическом уровнях.

Ограничения

Ограничения выполнения

Ограничения партиционирования

  • При удалении столбца из партиционированной таблицы или партиции необходимо удалить соответствующий столбец из всех связанных логических таблиц (из всех партиций таблицы или из связанной партиционированной таблицы и других ее партиции соответственно), чтобы избежать расхождения в структуре партиций и партиционированных таблиц.

Другие ограничения

  • Недоступно удаление столбца, входящего в первичный ключ или ключ шардирования.
  • После изменения таблицы запросы к связанным логическим и материализованным представлениям могут стать недоступными. В этом случае нужно пересоздать сбойные представления.
  • Информационная схема обновляется асинхронно, поэтому добавленный столбец может не сразу появиться в информационной схеме.

Примеры

Удаление столбца без ключевых слов

Удаление столбца из таблицы указанной логической БД:

ALTER TABLE marketing.clients
DROP COLUMN additional

Удаление столбца из таблицы логической БД, выбранной по умолчанию:

USE marketing_new;

ALTER TABLE sales
DROP COLUMN manager;

Удаление столбца с ключевым словом IF EXISTS 

ALTER TABLE marketing.clients
DROP COLUMN IF EXISTS additional

Удаление столбца с ключевым словом LOGICAL_ONLY 

ALTER TABLE marketing_new.sales
DROP COLUMN client_info
LOGICAL_ONLY