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须取自保存的原索引定义,包括列顺序及其他选项。从基础表重建;从旧隐藏索引表复制数据会保留损坏的键。
升级步骤¶
保存可恢复的升级前备份,停止所有租户的用户读写、导入、CDC、任务和其他后台写入,并等待在途事务完成。
在每个租户清点含
DECIMAL256的表及普通、UNIQUE、RTREE 索引。MatrixOne 源码提供只读清单etc/decimal256_index_inventory.sql,结果可能包含未受影响索引。保存每张表的SHOW CREATE TABLE和SHOW INDEX输出。关闭全部旧 CN,使用修复版作为维护 CN 启动,继续阻止用户及后台写入。按保存的原定义逐个删除并重建受影响索引。
DROP与CREATE是独立 DDL;若重建失败,继续保持维护窗口。核对重建后定义。对等值、支持的范围、大正负值和
NULL比较FORCE INDEX与IGNORE INDEX的完整有序结果,并用EXPLAIN确认索引路径。在可回滚事务或独立验证表中检查UPDATE、DELETE、UNIQUE重复拒绝。所有租户均完成清点、重建和校验后才恢复流量。若失败,恢复完整的升级前备份及对应旧二进制,不要让旧 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;