RECLUSTER TABLE

Introduced: v1.2.25

对表进行重新聚类。有关为什么以及何时重新聚类表，请参阅 重新聚类表。

统一重聚簇语法

Introduced or updated: Unreleased

新脚本可以使用规范的 OPTIMIZE TABLE 形式：

OPTIMIZE TABLE [catalog.][database.]table_name RECLUSTER [FINAL] [WHERE condition] [LIMIT <segment_count>];

下文的 ALTER TABLE 语法及示例仍作为兼容别名保留。两种形式执行相同的重聚簇操作。此操作接受旧语法中的 IF EXISTS 子句，但该子句不会跳过不存在的目标。执行维护前，请检查目标是否存在。

对物化视图，可使用不带 WHERE 的同一 OPTIMIZE TABLE 形式。请参阅物化视图。有关使用 catalog 限定名称的合并操作，请参阅 OPTIMIZE TABLE。

分布式执行

Introduced or updated: Unreleased

在集群中，Databend 会自动跨节点调度重聚簇。enable_distributed_recluster 已弃用且不再生效。将其设为 0 不会强制本地执行。升级时，请移除对该开关的依赖。

有关写入后 auto_compaction_segments_limit 的支持范围，请参阅分布式执行与升级兼容性。该设置不控制下文的 LIMIT 子句。

语法

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

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

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

备注

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

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

示例

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

-- insert some data to 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 recluster
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}