登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  MySQL

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 诊断混进来。

MySQL 全局复制过滤器表与 FILTER_NAME、FILTER_RULE、CONFIGURED_BY、ACTIVE_SINCE 字段的静态关系图
图1:静态结构说明图。外层表示副本级全局过滤器表,内部字段分别表达规则类型、规则内容、配置来源和生效时间,不是运行截图或执行流程。

用四个字段读懂一条规则

先把字段名显式列出来,再读数据,排查时更不容易把规则内容和来源混在一起:

-- 先确认全局过滤器表提供哪些字段,再决定展示列。
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 只是让同一来源的规则集中显示,便于把启动期配置和运行期变更分成两组。若需要保留原始返回顺序,可以去掉排序,但排查记录里最好保留明确的排序条件。

SHOW 查询入口、Performance Schema 全局过滤器表和三个结果解释字段的静态关系图
图2:静态查询关系说明图。查看入口指向 Performance Schema 的全局过滤器表,再由表关联到规则内容、配置来源和生效时间,不代表已执行的运行结果。

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 配置区分开,便于追溯规则从哪里进入实例。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>