RECLUSTER TABLE

引入版本：v1.2.25

重新聚类表。关于为何以及何时需要重新聚类表，请参阅重新聚类表。

语法

ALTER TABLE [ IF EXISTS ] <table_name> RECLUSTER [ FINAL ] [ WHERE condition ] [ LIMIT <segment_count> ]

该命令对可以处理的段数量有限制，默认值为“max_thread * 4”。您可以通过使用 LIMIT 选项来修改此限制。或者，您有两种选择来进一步聚类表中的数据：

• 多次对表运行该命令。
• 使用 FINAL 选项持续优化表，直到其完全聚类。

备注

重新聚类表会消耗时间（如果包含 FINAL 选项，时间会更长）和积分（当您在 Databend Cloud 中时）。在优化过程中，请勿对表执行 DML 操作。

该命令不会从头开始聚类表。相反，它会使用聚类算法从最新的 LIMIT 段中选择并重新组织最混乱的现有存储块。

示例

-- 创建表
create table t(a int, b int) cluster by(a+1);

-- 向 t 中插入一些数据
insert into t values(1,1),(3,3);
insert into t values(2,2),(5,5);
insert into t values(4,4);

select * from clustering_information('default','t')\G
*************************** 1. row ***************************
            cluster_key: ((a + 1))
      total_block_count: 3
   constant_block_count: 1
unclustered_block_count: 0
       average_overlaps: 1.3333
          average_depth: 2.0
  block_depth_histogram: {"00002":3}

-- 重新聚类表
ALTER TABLE t RECLUSTER FINAL WHERE a != 4;

select * from clustering_information('default','t')\G
*************************** 1. row ***************************
            cluster_key: ((a + 1))
      total_block_count: 2
   constant_block_count: 1
unclustered_block_count: 0
       average_overlaps: 1.0
          average_depth: 2.0
  block_depth_histogram: {"00002":2}