`pg_wal` 目录

原创已于 2025-05-30 14:16:12 修改 · 820 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#DB

于 2024-12-12 17:12:48 首次发布

PG 专栏收录该内容

355 篇文章

订阅专栏

目录标题

在 PostgreSQL 中，自动清理 pg_wal 目录主要通过配置参数 min_wal_size、max_wal_size 和 wal_keep_size 来实现。以下是如何配置 PostgreSQL 以自动清理 WAL 文件的详细步骤和建议：

1. 配置 `min_wal_size` 和 `max_wal_size`：

min_wal_size：定义了 WAL 文件总大小的下限。PostgreSQL 会尽量保持 WAL 文件的大小不低于这个值。
max_wal_size：定义了 WAL 文件总大小的上限。当 WAL 文件总大小超过这个值时，PostgreSQL 会清理旧的 WAL 文件。

2. 设置 `wal_keep_size`：

wal_keep_size：这是一个动态参数，用于设置 PostgreSQL 保留 WAL 文件的大小。它控制 PostgreSQL 保留的 WAL 文件的大小，以支持从检查点恢复或复制流。

[postgres@postgres-b99f1786-0-0 /]$ psql
psql (15.7)
Type "help" for help.

postgres=# show max_wal_size;
 max_wal_size 
--------------
 2GB
(1 row)

postgres=# show wal_segment_size;
 wal_segment_size 
------------------
 16MB
(1 row)

postgres=# show wal_keep_size;
 wal_keep_size 
---------------
 512MB
(1 row)

在这里插入图片描述

3. 使用 `checkpoint_timeout` 和 `checkpoint_completion_target`：

checkpoint_timeout：设置检查点之间的时间间隔。
checkpoint_completion_target：是一个浮动的时间范围，用于平衡检查点过程的平滑性。设定为 0.7 表示 PostgreSQL 计划在检查点时间的 70% 时间内完成数据的写入。

postgres=# show checkpoint_timeout;
 checkpoint_timeout 
--------------------
 15min
(1 row)

postgres=# 
postgres=# show checkpoint_completion_target;
 checkpoint_completion_target 
------------------------------
 0.8
(1 row)

postgres=#

在这里插入图片描述

4. 归档和清理：

如果开启了归档，那么归档成功了，才会被清除，所以这里注意一下，如果你开启了归档，但是归档命令是失效的，那么wal目录会一直增长，不会自动删除WAL。
可以使用 pg_archivecleanup 工具清理掉不再需要的旧文件。例如：
```
pg_archivecleanup <归档目录路径> <开始清理的 WAL 文件名>
```
其中 <归档目录路径> 是归档目录的路径，<开始清理的 WAL 文件名> 是要保留的最新 WAL 文件的名称。

5. 监控和调整：

监控 pg_wal 目录的大小，确保它不会超过磁盘空间。
根据数据库的写入负载和可用磁盘空间，适当调整 max_wal_size 和 min_wal_size 参数。

6. 手动清理：

在某些情况下，可能需要手动清理 pg_wal 目录。这可以通过缩小 min_wal_size 和 max_wal_size 参数来减少 wal segment 的数量，或者手动删除不再需要的 WAL 文件。

请注意，自动清理 WAL 文件是通过 PostgreSQL 的检查点机制实现的。检查点会触发旧 WAL 文件的清理，但这个过程受到 checkpoint_timeout 和 checkpoint_completion_target 参数的影响。此外，如果数据库中存在长事务，它们可能会阻止 WAL 文件的清理，因为长事务需要保留所有相关的 WAL 日志以确保事务的可恢复性。因此，管理长事务也是维护 WAL 日志空间的重要方面。