从CockroachDB移除interleaved表的潜在问题及操作注意事项

容易忽略的核心注意事项 #

• 必须从最底层的子表开始向上操作，不能优先修改父表：所有依赖父表的 interleaved 子表未完成解交错前，父表的主键变更会触发依赖校验失败、元数据锁冲突，是最高发的报错原因。
• 操作前必须终止表上所有运行中事务、暂停读写流量：ALTER PRIMARY KEY 本质是全量重建主键索引，interleaved 表的主键索引与父表物理存储绑定，操作期间有未提交行锁、持续写入都会导致schema变更任务超时失败，残留的临时索引碎片还会触发后续操作异常。
• 提前排查隐式约束：interleave 属性自带父子表隐式外键约束，即使你没有主动创建外键，操作前也要执行 SHOW CONSTRAINTS FROM 表名; 确认所有约束，提前处理冲突项。
• 提前调整集群schema变更参数：v21版本如果开启了schema_change_synchronously配置、或schema_change_timeout参数设置过短，大表的主键重建任务会直接超时中断，操作前建议临时调大超时阈值，使用异步schema变更模式。

你可能遗漏的标准操作步骤 #

你执行的ALTER PRIMARY KEY语句本身写法没有问题，大概率是缺少前置校验和操作顺序的规范，完整流程如下：

1. 提前完成全量数据备份，确认备份有效性
2. 执行SHOW INTERLEAVED TABLES FROM 根父表名;梳理清楚所有表的层级依赖关系，标记最底层无子表的节点
3. 从最底层子表开始向上逐层操作，每张表操作前先执行ALTER TABLE 表名 CANCEL ALL JOBS;终止该表上所有运行中的schema变更、备份、统计信息采集任务
4. （可选但建议）执行ALTER TABLE 表名 SET (read_only = true);将表设为只读，避免写入干扰
5. 执行解交错语句，必须严格保留原主键的字段顺序，不能调整字段排列，示例写法：

-- 原interleaved表主键定义
ALTER TABLE child_table PRIMARY KEY (parent_id, child_id) INTERLEAVE IN PARENT parent_table (parent_id);
-- 正确解交错写法，仅删除INTERLEAVE配置
ALTER TABLE child_table ALTER PRIMARY KEY USING COLUMNS (parent_id, child_id);

6. 等待schema变更任务完成后，执行SHOW CREATE TABLE 表名;确认interleave属性已经移除，再执行ALTER TABLE 表名 SET (read_only = false);恢复读写权限
7. 单张表操作完成后，再向上处理它的父表，直到整个层级的所有表都完成解交错

报错后应急处理 #

如果操作失败提示需要手动清理，不需要第一时间恢复备份：

• 先执行SHOW JOBS WHEN STATUS = 'failed'找到失败的schema变更任务
• 执行SHOW INDEXES FROM 表名;找到名称带_new_前缀的临时主键索引
• 执行DROP INDEX 临时索引名 CASCADE;清理残留资源后，即可重试操作

内容的提问来源于stack exchange，提问作者Kai