如何使用FastAPI的Databases库实现PostgreSQL主从连接

核心问题说明 #

你遇到的解析错误大多是因为未正确配置主从识别参数，或是所用驱动的连接串格式不兼容逗号分隔的多主机写法。

具体操作方案 #

• 如果你使用基于libpq的驱动（包括Python psycopg2、Go pgx、Java pgjdbc、Node.js pg等主流驱动）
  直接在原有连接串后添加target_session_attrs参数即可实现主从自动识别：
  • 主库（读写）连接串：postgresql://user:password@postgresserver1,postgresserver2,postgresserver3/db?target_session_attrs=read-write
    驱动会自动遍历所有主机，找到第一个支持读写的节点即为主库
  • 从库（只读）连接串：postgresql://user:password@postgresserver1,postgresserver2,postgresserver3/db?target_session_attrs=read-only
    驱动会自动匹配只读的从节点
• 如果你使用的驱动不支持多主机URI写法
  改用参数拆分的写法，兼容性更高，可避免解析错误：
  postgresql://user:password@/db?host=postgresserver1,postgresserver2,postgresserver3&target_session_attrs=read-write
• 如果所用驱动完全不支持原生主从路由
  部署Pgbouncer、HAProxy等代理中间件，将主库流量、从库流量分别映射到不同代理端口，应用侧直接配置两个单主机的普通连接串即可，不需要特殊格式。

常见排查项 #

• 确认你的驱动版本支持target_session_attrs参数，2018年之后发布的PostgreSQL官方驱动版本均已支持
• 如果所用框架自行封装了数据库连接解析逻辑，不要直接传入多主机URI，将host、端口、参数拆成单独的配置项传入即可

内容的提问来源于stack exchange，提问作者AlexBoss