PostgreSQL / 系统课时

准备主备节点与复制参数

准备主备节点与复制参数

这一课把主库准备到“可以提供物理流复制”的状态:先确认主备 PostgreSQL 大版本、网络与数据目录条件,再启用足够的 WAL 发送能力,最后从数据库内部验证参数已经按预期生效。

学习目标

  • 检查主备节点是否满足物理流复制的基础条件
  • 配置 wal_level、max_wal_senders 与复制槽容量
  • 通过 SQL 验证主库当前生效的复制参数

先确认主备基础条件

物理流复制传输的是 WAL,并在备库重放,因此主备节点必须使用兼容的 PostgreSQL 主版本。实际搭建时还应确认备库能够访问主库 PostgreSQL 端口,并为数据目录、WAL 和后续追赶预留足够磁盘空间。

在两个节点分别执行版本检查:

bash
postgres --version
psql --version

预期输出

text
postgres (PostgreSQL) <VERSION>
psql (PostgreSQL) <VERSION>

<VERSION> 会随安装版本不同而变化。用于常规物理流复制的主备节点应采用相同 PostgreSQL 主版本,不要把跨主版本复制当成普通流复制方案。

随后在主库确认服务监听端口和数据目录位置:

sql
SHOW port;
SHOW data_directory;

预期输出

text
 port
------
 5432

 data_directory
----------------
 <PATH>

如果实际端口不是 5432,后续防火墙、pg_hba.conf 和备库连接参数都必须使用真实端口。

配置物理复制参数

主库至少需要能够生成适用于物理复制的 WAL,并允许后台启动 WAL sender。下面使用 ALTER SYSTEM 写入实例级配置,适合实验环境或由数据库管理员直接管理配置的节点。

sql
ALTER SYSTEM SET wal_level = 'replica';
ALTER SYSTEM SET max_wal_senders = '10';
ALTER SYSTEM SET max_replication_slots = '10';

预期结果

text
ALTER SYSTEM
ALTER SYSTEM
ALTER SYSTEM

wal_level=replica 提供物理归档与流复制所需信息。max_wal_senders 限制可同时存在的 WAL sender 进程数量;如果还计划使用物理复制槽,max_replication_slots 必须至少覆盖计划创建的复制槽数量。

这些参数需要在服务器重新启动后确认最终生效。对于使用 systemd 且服务名为 postgresql 的环境,可以执行:

bash
sudo systemctl restart postgresql
sudo systemctl is-active postgresql

预期输出

text
active

不同发行版的服务单元名称可能是 postgresql-<VERSION> 等形式,应以本机实际服务名为准。

验证主库生效状态

服务恢复后,不要只检查配置文件内容,应直接查询 PostgreSQL 当前运行时参数。这能发现修改了错误实例、重启失败或配置被其他来源覆盖的问题。

sql
SELECT name, setting
FROM pg_settings
WHERE name IN ('wal_level', 'max_wal_senders', 'max_replication_slots')
ORDER BY name;

预期输出

text
         name          | setting
-----------------------+---------
 max_replication_slots | 10
 max_wal_senders       | 10
 wal_level             | replica

如果 wal_level 仍不是 replica,先检查当前连接是否指向目标主库,再查看 pg_settings.source 与 PostgreSQL 启动日志,确认究竟是哪一份配置决定了最终值。

检查复制能力是否可用

参数生效只代表主库具备发送 WAL 的能力,还不代表复制连接已经建立。此时可以先查看 WAL sender 视图,尚未连接备库时返回零行属于正常现象。

sql
SELECT pid, application_name, client_addr, state, sync_state
FROM pg_stat_replication;

预期输出

text
 pid | application_name | client_addr | state | sync_state
-----+------------------+-------------+-------+------------
(0 rows)

完成这一阶段后,主库已经具备提供物理流复制的运行参数。下一步真正决定备库能否接入的是复制账号、网络访问控制以及认证方式;在这些条件配置完成以前,pg_stat_replication 没有记录并不表示主库配置失败。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备主备节点与复制参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通