ALTER TABLE DROP RETENTION

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

Поддерживается в версиях: 7.6 / 7.5 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.12 / 6.11 / 6.10 / 6.9 / 6.8 / 6.7 / 6.6 / 6.5 / 6.4 / 6.3.

Запрос удаляет retention-правило таблицы:

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

  • CREATE TABLE с ключевым словом RETENTION — создает таблицу с retention-правилом;
  • ALTER TABLE ADD RETENTION — добавляет retention-правило для таблицы;
  • GET_ENTITY_DDL — возвращает информацию о таблице, включая ее текущие retention-правила.

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

Регистрация запроса

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

Обработка запроса

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

Успешный результат

При успешном выполнении запроса система удаляет:

  • retention-правило;
  • (если правило направлено на остужение данных) физическую таблицу со всеми холодными данными таблицы, накопленными по этому правилу, из датасорса-приемника.

Неуспешный результат

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

Синтаксис 

ALTER TABLE [db_name.]table_name
DROP RETENTION 'source_datasource'

Параметры:

db_name

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

table_name

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

source_datasource

Имя датасорса-источника, для которого удаляется retention-правило. Должно соответствовать конфигурации.

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

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

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

Ограничения

Примеры 

ALTER TABLE marketing.stores_snapshot
DROP RETENTION 'adp2'