编程 MariaDB 12.3 LTS 升级笔记:binlog 进 InnoDB,以及两个升级后会静默失效的配置

2026-11-19 21:03:35

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 里还留着的要清掉。

升级顺序

  1. 全量备份,先在从库或影子实例上跑通 12.3。
  2. 清掉配置文件里已移除的 big_tables、large_page_size、storage_engine。
  3. 执行上面的标识符冲突查询,处理保留字与同名 ST_Collect 存储函数。
  4. 评估读 binlog 文件的备份/CDC/审计工具是否支持 .ibb,把 binlog_storage_engine 单独排成一次变更——它是只读选项,改了要重启。
  5. 先升级 replica,逐台重新设置 master_use_gtid,确认复制追上。
  6. 再升级 primary。
  7. 生产稳定后,再单独开启 binlog_storage_engine,观察写吞吐与备份链路。

链接

复制全文 生成海报 mariadb 数据库 升级 运维

推荐文章

程序员茄子在线接单