ALTER TABLE DROP RETENTION

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

Поддерживается в версиях:  6.12 / 6.11 / 6.10 / 6.9 / 6.8 / 6.7 / 6.6 / 6.5 / 6.4 / 6.3.

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

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

Текущие retention-правила для логической таблицы можно посмотреть с помощью GET_ENTITY_DDL.

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

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

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

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

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

Синтаксис 

ALTER TABLE [db_name.]table_name
DROP RETENTION origin_datasource_alias

Параметры:

db_name

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

table_name

Имя логической таблицы, для которой удаляется retention-правило.

origin_datasource_alias

Имя датасорса-источника, к которому относится retention-правило. Имя указывается в одинарных кавычках (например, 'adb').

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

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

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

Ограничения

Примеры 

ALTER TABLE marketing.clients_adp1
DROP RETENTION 'adp1'