全部文档
当前文档
最近更新时间：2026-01-12 22:26:34
说明：在使用 RDS MySQL 数据库代理前，请务必了解以下注意事项，以确保数据库代理功能能够正常、稳定地运行。
事务路由规则：通过代理连接地址发起的事务请求，均会被路由至主实例执行，以保证事务的一致性。
只读实例下线影响：当从数据库代理后端移除某个只读实例时，该实例上正在执行的 SQL 语句将会失败。若代理后端同时存在多个只读实例（如实例 A 和实例 B），在下线实例 A 时，原本在实例 A 上执行的语句会尝试切换至实例 B 执行；若在指定重试次数内仍未成功，则最终返回错误。
主实例读流量承载策略：主实例是否参与承担读请求，由其配置的读流量权重决定。默认情况下，主实例可以承担读流量；当权重设置为非零值时，主实例将参与读流量分担；当权重设置为 0 时，主实例将不承担读请求。
用户自定义变量路由规则：使用用户自定义变量的 SQL 语句，将被统一路由至主实例执行。
MySQL 客户端 Hint 使用说明：使用 MySQL 命令行客户端连接数据库代理并执行包含 Hint 的 SQL 语句时，需要在连接命令中增加 -c 选项，否则 Hint 会被 MySQL 客户端过滤，导致路由规则不生效。
系统表查询规则：对系统表的查询请求，将根据内置正则匹配规则路由至指定实例执行。
函数路由说明：SELECT DATABASE() 语句默认路由至只读实例执行。
当在代理地址上新增只读实例，或代理地址上的只读实例发生重启时，该代理地址下的新建连接及已有连接上的请求，都会被路由至新增或已重启的只读实例。
当从代理地址上移除只读实例时，该实例上正在执行的 SQL 语句将失败并返回错误。
数据库代理地址暂不支持 SSL 与压缩协议。
对于 RDS MySQL 主实例与只读实例的参数 max_prepared_stmt_count 需保持一致，以避免因配额不一致导致 PREPARE 语句执行失败。
纯净模式
