如何为带历史数据的MariaDB系统版本化Aria表添加自增主键

直接添加自增列的可行性 #

目前MariaDB在存在历史数据的系统版本化表中无法直接添加自增主键列。当表因更新/删除操作产生历史记录后，修改主键结构（尤其是添加自增属性）会触发错误1112: Table uses an extension that doesn't exist in this MariaDB version——这是因为系统版本化表的历史分区与当前分区需保持结构一致性，而自增列的添加涉及历史数据的主键值自动生成，现有机制无法支持这类直接变更。

数据迁移重建方案 #

若无法直接修改，可通过导出全量数据（当前+历史）→ 重建表 → 导入数据的方式解决，具体步骤如下：

1. 备份全量数据（含历史版本） #

系统版本化表默认包含隐藏的row_start和row_end字段，用于记录每条数据的有效时间范围，必须备份这两个字段以保留历史时间线：

-- 创建临时表存储所有数据（当前数据+历史版本数据）
CREATE TEMPORARY TABLE Email_Temp AS
SELECT 
  email, modifiedBy, modifyReason, Person_idPerson, Account_idAccount,
  row_start, row_end
FROM Email_Test FOR SYSTEM_TIME ALL;

若数据量极大，可使用mysqldump工具导出，需添加--include-system-time参数确保包含系统时间字段。

2. 清理原表 #

先禁用系统版本化，再删除原表：

-- 关闭原表的系统版本化功能
ALTER TABLE Email_Test DISABLE SYSTEM VERSIONING;
-- 删除原表
DROP TABLE Email_Test;

3. 重建带自增主键的系统版本化表 #

创建新表，将自增列idEmail设为主键，同时保留原表的索引、引擎、字符集及系统版本化配置：

CREATE TABLE `Email_Test` (
  `idEmail` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
  `email` VARCHAR(100) NOT NULL,
  `modifiedBy` INT(10) UNSIGNED NOT NULL,
  `modifyReason` VARCHAR(200) NULL DEFAULT NULL,
  `Person_idPerson` INT(10) UNSIGNED NULL DEFAULT NULL,
  `Account_idAccount` INT(10) UNSIGNED NULL DEFAULT NULL,
  INDEX `fk_Email_Person1_idx` (`Person_idPerson` ASC),
  UNIQUE INDEX `UNIQUE` (`email` ASC, `Account_idAccount` ASC)
)
ENGINE = Aria
DEFAULT CHARACTER SET = utf8mb4
WITH SYSTEM VERSIONING
PARTITION BY SYSTEM_TIME (
  PARTITION part_history HISTORY,
  PARTITION part_current CURRENT
);

4. 导入备份数据 #

导入时让数据库自动生成自增主键值，同时还原系统时间字段以保留历史版本：

-- 关闭自动提交，保证导入操作原子性
SET autocommit = 0;
-- 导入数据，自增列传NULL由数据库自动分配
INSERT INTO Email_Test (
  email, modifiedBy, modifyReason, Person_idPerson, Account_idAccount,
  row_start, row_end
)
SELECT 
  email, modifiedBy, modifyReason, Person_idPerson, Account_idAccount,
  row_start, row_end
FROM Email_Temp;
-- 提交事务
COMMIT;

5. 验证数据完整性 #

查询全量数据确认当前和历史版本都正确还原：

SELECT idEmail, email, row_start, row_end FROM Email_Test FOR SYSTEM_TIME ALL;

内容的提问来源于stack exchange，提问作者İan Boddison