Skip to main content

Манипуляции с проекциями

Доступны следующие операции с проекциями:

  • ALTER TABLE [db].name ADD PROJECTION name ( SELECT <COLUMN LIST EXPR> [GROUP BY] [ORDER BY] ) — добавляет описание проекции в метаданные.

  • ALTER TABLE [db].name DROP PROJECTION name — удаляет описание проекции из метаданных и удаляет файлы проекции с диска.

  • ALTER TABLE [db.]table MATERIALIZE PROJECTION name IN PARTITION partition_name — перестраивает проекцию в указанной партиции. Реализовано как мутация.

  • ALTER TABLE [db.]table CLEAR PROJECTION name IN PARTITION partition_name — удаляет файлы проекции с диска без удаления описания.

Команды ADD, DROP и CLEAR — легковесны, поскольку они только меняют метаданные или удаляют файлы.

Также команды реплицируются, синхронизируя описания проекций в метаданных с помощью ZooKeeper.

:::note
Манипуляции с проекциями поддерживаются только для таблиц с движком [`*MergeTree`](/docs/ru/engines/table-engines/mergetree-family/mergetree) (включая [replicated](/docs/ru/engines/table-engines/mergetree-family/replication) варианты).
:::