通道名是多源复制的唯一标识符,MySQL禁止重名以避免元数据覆盖、中继日志写混及状态查询错乱;未指定FOR CHANNEL则默认使用空字符串通道,导致配置覆盖和状态不可见;启停与查询必须显式指定通道名,且通道名决定中继日志文件命名,保障磁盘安全。

通道名是多源复制的唯一标识符
MySQL 不允许两个复制通道共享同一个名字,否则会直接报错 ERROR 3077 (HY000): Channel name already exists。这不是限制,而是设计逻辑:每个通道对应一个独立的 IO 线程、一组 relay log 文件、一份元数据(存于 mysql.slave_master_info 和 mysql.slave_relay_log_info 表中),名称就是这些资源的键。重名会导致元数据覆盖、relay log 写混、状态查询错乱。
不指定 FOR CHANNEL 就等于用空字符串通道
漏写 FOR CHANNEL 'xxx' 或写成 FOR CHANNEL '',MySQL 会把配置写入默认空字符串通道(即传统单主模式下的隐式通道)。结果是:后一条 CHANGE REPLICATION SOURCE TO 会覆盖前一条,你以为配了两个主库,其实只有一个在生效。更隐蔽的问题是——SHOW REPLICA STATUS 默认只显示这个空字符串通道的状态,其他通道“看起来不存在”。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
启停和查状态必须绑定通道名
-
START REPLICA不带参数,只启动空字符串通道;要启第二个主库,必须写START REPLICA FOR CHANNEL 'master_b' -
STOP REPLICA FOR CHANNEL 'master_a'只停 A,不影响 B;但STOP REPLICA会停所有通道(含默认空通道),容易误伤 -
SHOW REPLICA STATUS不加FOR CHANNEL,永远看不到master_b的Seconds_Behind_Source或Retrieved_Gtid_Set,排查延迟时会彻底失明
通道名影响 relay log 文件命名与磁盘安全
MySQL 用通道名生成 relay log 文件前缀(如 relay-log-master_a.000001)。如果两个通道名相同或未显式指定,relay log 可能被多个 IO 线程并发写入同一组文件,轻则日志损坏,重则 relay_log_purge=ON 自动清理时删错文件,导致 SQL 线程卡死在 Waiting for dependent transaction to commit。这也是为什么 MySQL 5.7+ 强制要求 relay_log_info_repository = 'TABLE'——FILE 模式根本无法区分多通道元数据。

















