MySQL replication_applier_global_filters 怎样查看复制通道共用的过滤规则
来源:17golang原创
时间:2026-11-18 12:36:56 311浏览 收藏
在排查 MySQL 复制过滤时,我会先把“副本上共用的过滤规则”和“某条复制通道自己的规则”分开看。要查看前一类信息,直接查询 performance_schema.replication_applier_global_filters;它返回的是副本级全局过滤器的描述,不是某个 channel 的延迟、线程状态或独立配置。
官方文档地址:https://dev.mysql.com/doc/refman/8.4/en/performance-schema-replication-applier-global-filters-table.html
这张表最值得关注的字段有四个:FILTER_NAME 表示过滤器类型,FILTER_RULE 表示规则内容,CONFIGURED_BY 表示规则来自启动参数还是运行时语句,ACTIVE_SINCE 表示配置生效的时间。把这四列一起读出来,通常就能回答“现在副本共用了哪些过滤规则,以及它们从哪里来”。
先确认这张表描述的范围
replication_applier_global_filters 中的 global 是理解结果的关键。它记录当前副本配置的全局复制过滤器,影响范围不是某一个复制通道专属的局部条目。多源复制或多通道环境中,不要把查询结果直接当成某个 channel 的完整过滤配置。
如果问题是“副本是否设置过共用规则”,查询这张表就够了;如果问题是“某个通道当前运行到哪里、是否有错误”,还要另外查看复制状态表。本文只聚焦共用规则本身,不把通道状态、延迟和 worker 诊断混进来。

用四个字段读懂一条规则
先把字段名显式列出来,再读数据,排查时更不容易把规则内容和来源混在一起:
-- 先确认全局过滤器表提供哪些字段,再决定展示列。 SHOW COLUMNS FROM performance_schema.replication_applier_global_filters;
在 MySQL 8.4 官方参考手册中,这张表的字段语义可以这样理解:
| 字段 | 它回答的问题 | 阅读重点 |
|---|---|---|
FILTER_NAME | 过滤器属于哪一类? | 看过滤器类型,不要把它当成具体数据库名。 |
FILTER_RULE | 规则具体匹配什么? | 这是需要结合过滤器类型阅读的规则文本。 |
CONFIGURED_BY | 规则从哪里配置? | 区分启动参数和运行时 CHANGE REPLICATION FILTER。 |
ACTIVE_SINCE | 什么时候开始生效? | 用于和变更时间、重启时间做时间线对照。 |
这里没有“输入参数”和“函数返回值”那种 API 语义。输入是你的 SQL 查询条件,返回结果则是表中的行;每一行描述一个已经配置的全局过滤规则。理解这个边界后,遇到空结果时不会误以为查询语句缺少某个必填参数。
按配置来源查询共用规则
实际排查时,我更倾向于显式指定列,并按来源、类型排序。这样复制配置从启动参数和运行时语句两条路径进入时,结果仍然容易比较:
-- 显式读取副本级规则,并把配置来源放在规则类型之前。
SELECT
FILTER_NAME,
FILTER_RULE,
CONFIGURED_BY,
ACTIVE_SINCE
FROM performance_schema.replication_applier_global_filters
ORDER BY CONFIGURED_BY, FILTER_NAME, ACTIVE_SINCE;
这个查询不修改复制配置,也不要求你先知道过滤器名称。ORDER BY 只是让同一来源的规则集中显示,便于把启动期配置和运行期变更分成两组。若需要保留原始返回顺序,可以去掉排序,但排查记录里最好保留明确的排序条件。

CONFIGURED_BY 的两种值怎么解释
官方文档给出的 CONFIGURED_BY 值主要有两类。看到 STARTUP_OPTIONS,说明全局过滤器是通过启动时的 --replicate-* 选项配置的;看到 CHANGE_REPLICATION_FILTER,说明它来自运行时的 CHANGE REPLICATION FILTER 语句。
这一区分对复盘很有用:启动参数通常要回到实例启动配置中查来源,运行时语句则应回到变更记录或运维操作记录中查谁在什么时候执行过变更。不要只看 FILTER_RULE 就判断修改方式,因为规则内容本身不一定能说明它来自哪条配置路径。
-- 只保留来源和规则内容,适合做变更记录摘要。
SELECT
CONFIGURED_BY,
FILTER_NAME,
FILTER_RULE,
ACTIVE_SINCE
FROM performance_schema.replication_applier_global_filters
ORDER BY ACTIVE_SINCE DESC;
如果你的目标是核对“最近生效的共用规则”,按 ACTIVE_SINCE 倒序更直观;如果目标是整理启动配置与运行期配置的差异,按 CONFIGURED_BY 分组更合适。两种查询访问的是同一张表,区别只在阅读顺序。
空结果和多通道场景不要误判
查询没有返回行,首先只能说明这张全局过滤器表当前没有可显示的全局规则,不能据此推出“复制完全没有过滤”。可能存在通道级过滤,也可能过滤规则配置在你正在查看的对象之外。此时应回到问题边界:你要查的是副本共用规则,还是某个通道独有规则。
反过来,查询返回多行也不代表有多条复制通道。多行可能来自不同过滤器类型、不同规则内容,或者启动参数与运行时语句各自留下的配置记录。通道数量要用复制状态相关信息判断,不要用这张表的行数代替。
| 看到的现象 | 更稳妥的解释 | 下一步关注点 |
|---|---|---|
| 结果为空 | 当前没有可见的副本级全局过滤器记录 | 确认是否其实要查通道级规则 |
| 一行 | 存在一条全局过滤器描述 | 结合四列确认来源和生效时间 |
| 多行 | 存在多个规则描述,不等于多个通道 | 按 CONFIGURED_BY 与 FILTER_NAME 分组阅读 |
把查询结果整理成可复用记录
我通常把下面四项作为复制配置记录的最小字段集:过滤器类型、过滤规则、配置来源、生效时间。记录时保留原始文本,不要把 FILTER_RULE 改写成自己的简称;后续对照启动配置或运行时变更时,原始值更容易定位。
最后可以用三个问题复盘这次查询:第一,规则是否确实属于副本级全局过滤器;第二,CONFIGURED_BY 是否说明了配置入口;第三,ACTIVE_SINCE 能否和配置变更时间对应。三个问题都能回答时,这张表就完成了它的任务。
这张表能直接告诉我某个复制通道的过滤规则吗?
不能直接这样理解。它描述的是副本级全局过滤器;要回答某个通道的独有规则,需要查看对应的通道级复制过滤信息。
FILTER_RULE 是不是可以当成数据库名列表?
不能脱离 FILTER_NAME 解读。先确认过滤器类型,再按该类型理解规则文本。
CONFIGURED_BY 为什么值得单独记录?
它把启动参数配置和运行时 CHANGE REPLICATION FILTER 配置区分开,便于追溯规则从哪里进入实例。
-
499 收藏
-
206 收藏
-
500 收藏
-
193 收藏
-
270 收藏
-
337 收藏
-
396 收藏
-
309 收藏
-
130 收藏
-
144 收藏
-
496 收藏
-
148 收藏
-
234 收藏
-
490 收藏
-
273 收藏
-
171 收藏
-
428 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习