ALTER TABLE RENAME COLUMN

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

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

Запрос переименовывает столбец указанной таблицы: логической таблицы или прокси-таблицы.

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

Результат выполнения

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

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

Как работает запрос

Запрос попадает в очередь операций и обрабатывается в порядке его поступления в очередь. Каждое изменение таблицы записывается в журнал, который можно посмотреть с помощью запроса GET_CHANGES.

Если при исполнении корректного запроса возникла ошибка, система блокирует все последующие DDL-запросы в логической базе данных. О снятии такой блокировки см. в разделе Снятие блокировки DDL-запросов.

Синтаксис 

ALTER TABLE [db_name.]table_name
RENAME COLUMN [IF EXISTS] column_name TO new_column_name
[LOGICAL_ONLY]

Параметры:

db_name

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

table_name

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

column_name

Имя столбца таблицы, который нужно переименовать.

new_column_name

Новое имя столбца таблицы.

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

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

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

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

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

Варианты ответа

В ответе возвращается:

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

Ограничения

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

Ограничения имен

  • Имена столбцов должны быть уникальны в рамках таблицы и соответствовать требованиям,
    описанным в разделе Соглашения об именах.

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

  • При переименовании столбца в партиционированной таблице необходимо переименовать соответствующий столбец во всех ее партициях.
  • При переименовании столбца в партиции необходимо переименовать соответствующий столбец в связанной партиционированной таблице и других ее партициях.

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

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

Примеры

Переименование столбца без ключевых слов

Переименование столбца в логической таблице указанной логической БД:

ALTER TABLE marketing.clients
RENAME COLUMN description TO additional

Переименование столбца в прокси-таблице указанной логической БД:

ALTER TABLE marketing.payments_proxy
RENAME COLUMN manager_id TO manager

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

USE marketing_new;

ALTER TABLE sales
RENAME COLUMN manager_id TO manager;

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

ALTER TABLE marketing.clients
RENAME COLUMN IF EXISTS description TO additional

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

ALTER TABLE marketing_new.sales
RENAME COLUMN client_id TO client_info
LOGICAL_ONLY