DECIMAL256 索引升级

旧版索引写入器生成的 DECIMAL256 索引可能缺少键组件或索引行。新版解码器无法修复旧键;恢复查询前必须从基础表重建受影响索引。

范围

精度超过 38 的 DECIMAL 使用 DECIMAL256。检查普通索引、UNIQUE 索引、复合键及隐藏主键尾部。已知可达入口包括开启 foreign_key_checks 后,带外键表的 LOAD DATA 通过旧 planner 导入 Parquet DECIMAL256 数据。普通导入失败不能证明历史索引没有受到影响。

语法

ALTER TABLE database_name.table_name DROP INDEX index_name;
CREATE [UNIQUE] INDEX index_name ON database_name.table_name(column_list);

参数

  • index_name 与 column_list 须取自保存的原索引定义,包括列顺序及其他选项。

  • 从基础表重建;从旧隐藏索引表复制数据会保留损坏的键。

升级步骤

  1. 保存可恢复的升级前备份,停止所有租户的用户读写、导入、CDC、任务和其他后台写入,并等待在途事务完成。

  2. 在每个租户清点含 DECIMAL256 的表及普通、UNIQUE、RTREE 索引。MatrixOne 源码提供只读清单 etc/decimal256_index_inventory.sql,结果可能包含未受影响索引。保存每张表的 SHOW CREATE TABLE 和 SHOW INDEX 输出。

  3. 关闭全部旧 CN,使用修复版作为维护 CN 启动,继续阻止用户及后台写入。按保存的原定义逐个删除并重建受影响索引。DROP 与 CREATE 是独立 DDL;若重建失败,继续保持维护窗口。

  4. 核对重建后定义。对等值、支持的范围、大正负值和 NULL 比较 FORCE INDEX 与 IGNORE INDEX 的完整有序结果,并用 EXPLAIN 确认索引路径。在可回滚事务或独立验证表中检查 UPDATE、DELETE、UNIQUE 重复拒绝。

  5. 所有租户均完成清点、重建和校验后才恢复流量。若失败,恢复完整的升级前备份及对应旧二进制,不要让旧 writer 打开部分重建的数据目录。

示例

以下 SQL 仅展示临时表上的 DDL 顺序;实际索引必须使用保存的原定义。

DROP DATABASE IF EXISTS decimal256_upgrade_demo;
CREATE DATABASE decimal256_upgrade_demo;
USE decimal256_upgrade_demo;
CREATE TABLE amounts (id INT PRIMARY KEY, amount DECIMAL(50,0));
INSERT INTO amounts VALUES (1, 1234567890123456789012345678901234567890);
CREATE INDEX amount_idx ON amounts(amount);
ALTER TABLE amounts DROP INDEX amount_idx;
CREATE INDEX amount_idx ON amounts(amount);
SELECT id FROM amounts WHERE amount = 1234567890123456789012345678901234567890;
DROP DATABASE decimal256_upgrade_demo;