从 MySQL 迁移到 TiDB：使用 SQL-Replay 工具进行真实线上流量回放测试 SOP
内容提要
SQL-Replay是一款用于评估数据库兼容性和性能的工具，支持日志解析、查询回放、性能测量和报告生成等功能。它可以回放MySQL慢查询日志或抓包流量文件，验证TiDB集群的兼容性和性能，提高数据库迁移的成功率和效率。通过使用SQL-Replay，团队可以更好地理解数据库的性能差异，减少在生产环境中出现问题的风险。
延伸解读
回放顺序与流量放大的实际限制
SQL-Replay 回放时，SQL 执行顺序并不完全与上游真实顺序一致，这可能影响对事务或依赖顺序的 SQL 的评估。此外，工具没有自动流量放大功能，若需放大读流量，只能通过启动多个回放程序实现。这意味着在模拟高并发场景时，需要手动设计并行回放策略，并注意可能引入的额外复杂性。
慢查询日志开启的性能代价与连接影响
为了捕获所有 SQL，需要将 long_query_time 设置为 0，但这会导致大量慢日志写入，在高并发场景下可能对 MySQL 性能造成 20% 以上的影响。同时，短连接场景下回放可能遇到连接数过多的问题，而 connection_id 超过 4096 时还会触发 too many open files 错误，需提前调整 ulimit。这些因素要求在实际操作前做好资源评估和参数调优。
海量数据场景下的压测策略与偏差风险
对于 20TB 以上的海量数据，全量数据和流量测试是最佳选择，但若受限于时间、成本等因素，可按业务主维度（如玩家、订单）取 1/4 或 1/2 数据进行压测，并将流量放大到全流量级别。然而，这种方法可能忽略其他维度的跨主维度查询，导致测试数据与真实流量存在偏差，需要谨慎解读结果。
云上 RDS 与特殊场景的兼容性注意点
SQL-Replay 对云上 RDS MySQL 的支持取决于慢查询日志格式，并非所有云 RDS 都兼容，使用前需验证日志格式。此外，工具暂不支持 MariaDB，因为无法获取 connection_id。对于没有记录 database 信息的慢查询，回放时只能指定 -db all 或不指定，否则不会回放，若需过滤库，可通过指定用户名和数据库名实现。
Q&A
SQL-Replay工具的主要功能是什么？
SQL-Replay工具主要用于评估数据库的兼容性和性能，支持日志解析、查询回放、性能测量和报告生成等功能。
如何使用SQL-Replay进行MySQL慢查询日志的回放？
可以通过设置MySQL的慢查询日志并使用SQL-Replay的replay模式，将慢查询日志回放至TiDB数据库。
SQL-Replay支持哪些版本的MySQL？
SQL-Replay支持MySQL 5.6、5.7、8.0及华为云MySQL RDS等版本的慢查询回放。
使用SQL-Replay进行性能评估的好处是什么？
使用SQL-Replay进行性能评估可以帮助团队理解数据库的性能差异，减少在生产环境中出现问题的风险，提高数据库迁移的成功率和效率。
如何生成SQL-Replay的报告？
可以使用SQL-Replay的report模式，从回放数据生成详细报告，帮助理解不同查询对数据库兼容性和性能的影响。
在使用SQL-Replay时，如何处理没有数据库信息的慢查询？
在慢查询回放时，如果日志中没有记录数据库信息，可以指定-db all，或者不指定数据库，以确保回放能够进行。
