MyDumper项目中关于SOURCE_AUTO_POSITION参数的正确使用方式

在MySQL数据库备份与恢复工具MyDumper的最新版本中，我们发现了一个关于复制配置参数SOURCE_AUTO_POSITION的重要问题。这个问题涉及到使用GTID进行主从复制时的正确配置方式。

问题背景

当使用MyDumper进行数据库备份时，如果设置了SOURCE_AUTO_POSITION=1（表示启用基于GTID的自动定位复制），但同时又在CHANGE MASTER命令中指定了二进制日志文件名和位置，会导致MySQL服务器报错。这是因为MySQL不允许同时使用GTID自动定位和传统的位置定位两种复制方式。

问题表现

在MyDumper生成的metadata文件中，当SOURCE_AUTO_POSITION=1时，工具仍然会包含SOURCE_LOG_FILE和SOURCE_LOG_POS参数。当使用这样的metadata文件进行恢复和复制设置时，MySQL会返回错误："Parameters SOURCE_LOG_FILE, SOURCE_LOG_POS, RELAY_LOG_FILE and RELAY_LOG_POS cannot be set when SOURCE_AUTO_POSITION is active."

解决方案

MyDumper开发团队在v0.16.6-2版本中修复了这个问题。现在，当SOURCE_AUTO_POSITION=1时，工具会自动注释掉SOURCE_LOG_FILE和SOURCE_LOG_POS参数，确保CHANGE MASTER命令只包含GTID相关的复制配置。

最佳实践

1. 使用MyDumper进行备份时，如果需要设置基于GTID的复制，建议使用--source-data=31参数。这个参数组合会：

   • 注释掉SOURCE_LOG_FILE和SOURCE_LOG_POS
   • 设置SOURCE_AUTO_POSITION=1
   • 启用所有复制相关的自动配置选项

2. 如果需要自定义复制参数，可以在metadata文件中手动编辑或通过配置文件指定：

   [source]
   SOURCE_HOST = "主库IP"
   SOURCE_PORT = 主库端口
   SOURCE_USER = "复制用户"
   SOURCE_PASSWORD = "密码"
   SOURCE_SSL = 1
   SOURCE_AUTO_POSITION = 1
   

3. 对于端口信息，最新版本已经修复了metadata文件中端口信息缺失的问题。

参数组合详解

MyDumper的--source-data参数实际上是一个位掩码，可以组合多种复制配置选项。理解这些选项的组合对于正确配置复制非常重要：

• 低4位控制是否包含二进制日志位置信息
• 中间4位控制是否启用GTID自动定位
• 高4位控制自动执行的复制命令

例如，--source-data=31对应的二进制是00011111，表示：

• 注释掉位置信息(16)
• 启用GTID自动定位(8)
• 自动执行RESET REPLICA(4)、CHANGE SOURCE(2)和START REPLICA(1)

总结

正确配置MySQL复制参数对于数据库高可用至关重要。MyDumper的最新版本已经修复了GTID自动定位与传统位置定位冲突的问题。数据库管理员在使用时应当注意：

1. 确保使用最新版本的MyDumper
2. 根据复制需求选择合适的--source-data参数值
3. 对于GTID复制环境，优先使用自动定位方式
4. 必要时可以通过编辑metadata文件或使用配置文件进行精细控制

通过这些最佳实践，可以确保数据库备份恢复后复制配置的正确性，为业务连续性提供可靠保障。