wal_level的配置说明

wal_level的配置说明

目录

• wal_level的配置说明
  • 一、wal_level 的取值
  • 二、各选项说明
    • 1. minimal
    • 2. replica （Postgres 10+，等价于老版本 archive + hot_standby）
    • 3. logical
  • 三、影响总结（对比表）
  • 四、实践建议

在 PostgreSQL 中，wal_level 决定了 WAL 日志的详细程度，它直接影响到能否支持归档、流复制、逻辑解码等功能。

一、wal_level 的取值

不同版本 PostgreSQL 支持的选项略有差异：

• PostgreSQL 9.6 及之前
  • minimal
  • archive
  • hot_standby
• PostgreSQL 10+（目前主流版本，比如 12、13、14、15、16）
  • minimal
  • replica（替代 archive 和 hot_standby）
  • logical

二、各选项说明

1. minimal

• 作用：
  • 只写事务恢复所需的最少 WAL 信息。
  • 适合仅需本地崩溃恢复的场景。
• 特性限制：
  • 不支持 WAL 归档 (archive_mode)；
  • 不支持 流复制、热备；
  • 不支持 逻辑解码。
• 优点：写入量最小，性能最好。
• 缺点：功能最弱，只能保证单机恢复。

2. replica （Postgres 10+，等价于老版本 archive + hot_standby）

• 作用：

  • 在 minimal 基础上，增加足够的信息来支持 WAL 归档、流复制 和 热备。

• 特性支持：

  • ✅ 归档 (PITR)
  • ✅ 流复制 (Physical Replication)
  • ✅ 热备 (Hot Standby)

• 适用场景：

  • 大多数生产环境的标准配置。

• 性能开销：

  • 比 minimal 略高，但通常可接受。

3. logical

• 作用：
  • 在 replica 基础上，增加 逻辑解码 (Logical Decoding) 所需的额外信息。
  • 允许输出 SQL 级别的变更（用于 wal2json、pgoutput 等插件）。
• 特性支持：
  • ✅ 一切 replica 能做的；
  • ✅ 逻辑复制、变更数据捕获 (CDC)。
• 适用场景：
  • 双写同步、跨库同步、数据总线 (Kafka/ES/ClickHouse 等)。
• 性能开销：
  • WAL 体积更大，写入开销更高；
  • 如果没有逻辑解码需求，不推荐开启。

三、影响总结（对比表）

参数值	支持崩溃恢复	归档 / PITR	流复制	热备	逻辑解码	WAL 大小	性能影响
minimal	✅	❌	❌	❌	❌	最小	最好
replica	✅	✅	✅	✅	❌	中等	一般
logical	✅	✅	✅	✅	✅	最大	较高

四、实践建议

• 单机数据库，无备份/复制需求 → minimal
• 常规生产环境（需要归档 / 热备 / 流复制） → replica（推荐默认）
• 需要逻辑复制 / CDC / 双写同步 → logical