ClickHouse/docs/en/sql-reference/statements/alter/skipping-index.md
Robert Schulze 4050b637f1
ALTER TABLE ADD INDEX: Add default GRANULARITY argument for secondary indexes
- Related to #45451, which provides a default GRANULARITY when the
  skipping index is created in CREATE TABLE.
2023-06-07 09:04:24 +00:00

1.4 KiB

slug toc_hidden_folder sidebar_position sidebar_label
/en/sql-reference/statements/alter/skipping-index true 42 INDEX

Manipulating Data Skipping Indices

The following operations are available:

  • ALTER TABLE [db].table_name [ON CLUSTER cluster] ADD INDEX name expression TYPE type [GRANULARITY value] [FIRST|AFTER name] - Adds index description to tables metadata.

  • ALTER TABLE [db].table_name [ON CLUSTER cluster] DROP INDEX name - Removes index description from tables metadata and deletes index files from disk. Implemented as a mutation.

  • ALTER TABLE [db.]table_name [ON CLUSTER cluster] MATERIALIZE INDEX name [IN PARTITION partition_name] - Rebuilds the secondary index name for the specified partition_name. Implemented as a mutation. If IN PARTITION part is omitted then it rebuilds the index for the whole table data.

The first two commands are lightweight in a sense that they only change metadata or remove files.

Also, they are replicated, syncing indices metadata via ZooKeeper.

:::note
Index manipulation is supported only for tables with *MergeTree engine (including replicated variants). :::