# WAL目录
/pgsql/data/pg_wal/
├── 000000010000000000000001 # WAL段文件
├── 000000010000000000000002 # WAL段文件
└── archive_status/ # 归档状态目录
├── 000000010000000000000001.done
└── 000000010000000000000002.done

# WAL文件名格式
– 00000001：时间线ID
– 0000000000000001：日志序列号（LSN）

# WAL文件大小
– 默认：16MB
– 可通过编译时参数调整

# WAL文件状态
– 活跃：当前正在写入的文件
– 归档：已归档的文件
– 可重用：已被检查点覆盖的文件

# WAL文件循环使用
– PostgreSQL会循环使用WAL段文件
– 当达到max_wal_size时，会触发检查点
– 检查点后，旧的WAL文件可以被重用

# WAL文件归档
– 启用归档后，WAL文件会被复制到归档目录
– 归档的WAL文件用于时间点恢复（PITR）
– 归档文件需要定期清理

# 查看WAL文件信息
SELECT
wal_segment_file,
size
FROM pg_ls_dir(‘pg_wal’)
WHERE wal_segment_file ~ ‘^[0-9A-F]{24}$’;

1. 事务修改数据时，先将修改写入WAL缓冲区
2. WAL缓冲区满或事务提交时，将WAL缓冲区写入WAL文件
3. WAL写入磁盘后，事务才被认为已提交
4. 后台进程（wal writer）定期将WAL缓冲区写入磁盘
5. 检查点进程将脏页写入数据文件

# WAL写入保证
– WAL写入是顺序的，提高性能
– WAL写入是同步的，确保持久性
– WAL写入是批量的，减少I/O操作

# 查看WAL写入统计
SELECT * FROM pg_stat_wal;

# WAL缓冲区大小
– 默认：-1（自动设置为shared_buffers的1/32，最大64MB）
– 建议：16-64MB

# WAL缓冲区刷新
– 事务提交时
– WAL缓冲区达到1/2时
– wal_writer_delay触发时
– 检查点时

# 查看WAL缓冲区使用情况
SELECT
name,
setting,
unit
FROM pg_settings
WHERE name LIKE ‘wal_buffers’;

# 启用归档
archive_mode = on
archive_command = ‘cp %p /archive/%f’
archive_timeout = 600

# 归档目录设置
– 目录必须存在且可写
– 建议使用独立的磁盘
– 定期清理归档文件

# 示例：使用rsync归档
archive_command = ‘rsync -a %p pgsql@backup:/archive/%f’

# 示例：使用压缩归档
archive_command = ‘gzip < %p > /archive/%f.gz’

# 查看归档状态
SELECT
archived_count,
failed_count,
last_archived_wal,
last_archived_time
FROM pg_stat_archiver;

# 手动归档
SELECT pg_switch_wal();

# 检查归档文件
ls -l /archive/

# 清理归档文件
# 保留最近7天的归档文件
find /archive -name “*.gz” -mtime +7 -delete