postgresqlreplication如何配置_postgresql主从复制流程

主从复制通过流式复制实现,主库配置wal_level=replica、max_wal_senders及pg_hba.conf后创建复制用户;从库用pg_basebackup初始化并创建recovery.signal,设置primary_conninfo和hot_standby=on后启动,通过pg_stat_replication和pg_is_in_recovery()验证同步状态。

PostgreSQL 主从复制(Replication)是通过流式复制(Streaming Replication)实现的,主要用于数据高可用、读写分离和备份。配置过程主要包括主库(Primary)和备库(Standby)的设置。以下是详细的配置流程。

1. 配置主库(Primary Server)

主库负责处理写操作,并将 WAL(Write-Ahead Logging)日志发送给从库。

步骤:

  • 启用 WAL 日志记录:确保 WAL 级别为 replica 或更高(如 logical)。编辑 postgresql.conf

wal_level = replica

  • 设置最大连接数:预留连接给复制进程:

max_wal_senders = 10

  • 设置 WAL 发送超时(可选):

wal_sender_timeout = 60s

  • 允许复制连接:在 pg_hba.conf 中添加一行,允许从库连接进行复制:

host replication repuser 192.168.1.20/32 md5

其中 repuser 是用于复制的用户,192.168.1.20 是从库 IP。

  • 创建复制用户

登录 PostgreSQL 执行:

CREATE USER repuser REPLICATION LOGIN ENCRYPTED PASSWORD 'yourpassword';

  • 修改配置后重启主库或重载配置:

SELECT pg_reload_conf();

2. 初始化从库(Standby Server)

从库需要先通过基础备份同步主库数据,然后开始流式复制。

步骤:

  • 停止从库 PostgreSQL 服务

sudo systemctl stop postgresql

  • 清空从库数据目录(如果是新实例可跳过):

rm -rf /var/lib/postgresql/14/main/*

  • 使用 pg_basebackup 从主库拉取数据

pg_basebackup -h 192.168.1.10 -U repuser -p 5432 -D /var/lib/postgresql/14/main -F p -X stream -P

说明:
-h:主库 IP
-U:复制用户名
-D:本地数据目录
-F p:纯文件格式
-X stream:流式传输 WAL
-P:显示进度

3. 配置从库为 Standby 模式

让 PostgreSQL 启动时以只读模式运行,并连接主库接收 WAL 流。

  • 创建 recovery.signal 文件

在从库数据目录下创建一个空文件:

touch /var/lib/postgresql/14/main/recovery.signal

  • 配置 primary_conninfo:在 postgresql.confrecovery.conf(旧版本)中设置连接信息。PostgreSQL 12+ 直接写入 postgresql.auto.conf 或主配置文件。

postgresql.conf 添加:

primary_conninfo = 'host=192.168.1.10 port=5432 user=repuser password=yourpassword'

hot_standby = on

  • 启动从库

sudo systemctl start postgresql

4. 验证复制状态

确认主从是否正常同步。

  • 在主库查看复制进程

SELECT * FROM pg_stat_replication;

如果有返回记录,表示从库已连接并正在接收 WAL。

  • 在从库查看是否处于恢复模式

SELECT pg_is_in_recovery();

返回 true 表示正在作为从库运行。

  • 测试数据同步:在主库创建表或插入数据,检查从库是否自动更新。

基本上就这些。配置成功后,PostgreSQL 会持续将 WAL 记录发送到从库,实现近实时的数据同步。注意网络稳定性、用户权限和防火墙设置。如果需要更高级功能(如自动故障切换),可结合 Patroni、repmgr 等工具实现高可用架构。