MariaDB 12.3 LTS 升级笔记:binlog 进 InnoDB,以及两个升级后会静默失效的配置
版本背景
MariaDB 12.3.4 于 2026-11-16 发布 Stable GA。12.3 是长期支持版本,维护到 2029 年 6 月,是 11.7/11.8 这条线的演进。
12.3.4 的修复项里有几条值得留意:innodb_stats_persistent=ON 时 innodb_stats_method 不生效(MDEV-19574);InnoDB buffer pool 的 LRU 淘汰算法换成 sweeping 实现,避开 buf_pool.mutex 上的争用(MDEV-33966);表扫描性能下降 29%(MDEV-38051);JSON 归一化阶段的校验改为内联;DuckDB 存储引擎允许把 'duckdb' 字面量当作库名/schema 名。安全方面,CVE-2026-44168(CVSS 8.0)与 CVE-2026-44171(6.3)在 12.3.2 已修。
binlog 写进 InnoDB:.ibb 文件
12.3 最实质的改动是把 binlog 事件写进 InnoDB 管理的页式文件(.ibb),与 InnoDB redo log 和崩溃恢复打通(MDEV-34705)。binlog 与 InnoDB 之间那笔两阶段提交因此被去掉,恢复统一走 InnoDB 的 WAL;事务写入可以是非连续分片。写密集负载下有 4 倍写吞吐的报告。
开关是 binlog_storage_engine,只读选项,只能通过配置文件或启动参数设置。
代价在读取侧。binlog 从"一组顺序追加的普通文件"变成了 InnoDB 页结构文件,凡是按文件读 binlog 的下游都要重新验证一遍:物理备份对 binlog 的收集、CDC 工具直接解析 binlog 文件、审计与合规采集,以及自己写脚本扫 binlog 的运维流程。走复制协议读取的 CDC 不受影响,读文件的会。升级前先把这份清单列出来,确认工具端支持 .ibb,再考虑开启。
11.8 → 12.3 的两个静默坑
一、replica 的 master_use_gtid 会被重置。 从 12.3 之前的版本升级 replica 时,CHANGE MASTER TO ... master_use_gtid 不会被带过来,会被重置为 DEFAULT(MDEV-39788)。升级过程不报错,通常要等到下次切主或重建复制链路才暴露。依赖 GTID 的拓扑,升级后必须重新执行一次:
CHANGE MASTER TO master_use_gtid = slave_pos; -- 按原设置填 slave_pos / current_pos
降级方向不受影响。
二、新增保留字。 CONVERSION、TO_DATE 是新增保留字,不加引号不能再作为标识符。ST_COLLECT 情况不同:它自身不算保留字,但作为聚合函数会在左括号前被识别为内置函数,因此名为 ST_Collect 的存储函数无法再用非限定名创建或调用。
升级前扫一遍库里的标识符冲突:
SELECT TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME
FROM information_schema.COLUMNS
WHERE COLUMN_NAME IN ('CONVERSION','TO_DATE','ST_COLLECT');
SELECT ROUTINE_SCHEMA, ROUTINE_NAME
FROM information_schema.ROUTINES
WHERE ROUTINE_NAME IN ('CONVERSION','TO_DATE','ST_COLLECT');
其他改动
- Optimizer hints:支持 MySQL 8 风格注释,包含
QB_NAME、NO_RANGE_OPTIMIZATION、NO_ICP/NO_MRR、BKA/BNL、SEMIJOIN、SUBQUERY、JOIN_FIXED_ORDER、JOIN_ORDER、JOIN_PREFIX、JOIN_SUFFIX、MAX_EXECUTION_TIME、[NO_]JOIN_INDEX/GROUP_INDEX/ORDER_INDEX/INDEX、SPLIT_MATERIALIZED、DERIVED_CONDITION_PUSHDOWN、MERGE、ROWID_FILTER、INDEX_MERGE。 caching_sha2_password:兼容 MySQL 的认证插件,从 MySQL 迁过来的账号可以少改一处。SET SESSION AUTHORIZATION:切换会话身份,需要SET USER权限。- Aria 分段 key cache:
aria_pagecache_segments取值 1..128,默认 1;16 张表、32 个连接的场景下有 6 倍延迟与 tps 改善的报告。 - GIS:新增
ST_Validate、MBRCoveredBy、ST_Simplify、ST_GeoHash、ST_LatFromGeoHash、ST_LongFromGeoHash、ST_PointFromGeoHash、ST_IsValid、ST_Collect,对齐 MySQL 8。 - 其余:TDE 的
file_key_management支持 SHA2(仅 Linux)、ssl_passphrase保护私钥、预编译语句上的游标、CTE 上执行 UPDATE/DELETE(含 WITH RECURSIVE)、外键约束名改为表内唯一(不再是库内唯一)、JSON 深度上限 32 移除。 - 移除的系统变量:
big_tables、large_page_size、storage_engine。my.cnf里还留着的要清掉。
升级顺序
- 全量备份,先在从库或影子实例上跑通 12.3。
- 清掉配置文件里已移除的
big_tables、large_page_size、storage_engine。 - 执行上面的标识符冲突查询,处理保留字与同名
ST_Collect存储函数。 - 评估读 binlog 文件的备份/CDC/审计工具是否支持
.ibb,把binlog_storage_engine单独排成一次变更——它是只读选项,改了要重启。 - 先升级 replica,逐台重新设置
master_use_gtid,确认复制追上。 - 再升级 primary。
- 生产稳定后,再单独开启
binlog_storage_engine,观察写吞吐与备份链路。
链接
- MariaDB 12.3.4 Release Notes
- MariaDB 12.3 Changes and Improvements
- mariadb.org
- 升级步骤参考文档:Upgrading from MariaDB 11.8 to MariaDB 12.3