2025年9月25日: PostgreSQL 18 发布!
支持的版本:当前 (18) / 17 / 16 / 15
开发版本:devel

F.5. basic_archive — 一个 WAL 归档模块示例 #

basic_archive 是一个归档模块的示例。该模块将完成的 WAL 段文件复制到指定的目录。这可能不是特别有用,但它可以作为开发您自己的归档模块的起点。有关归档模块的更多信息,请参阅第 49 章

为了使其正常工作,必须通过 archive_library 加载此模块,并且必须启用 archive_mode

F.5.1. 配置参数 #

basic_archive.archive_directory (string)

服务器应将 WAL 段文件复制到的目录。此目录必须已存在。默认值是空字符串,这实际上会停止 WAL 归档,但如果启用了 archive_mode,服务器将累积 WAL 段文件,以期望很快会提供一个值。

这些参数必须在 postgresql.conf 中设置。典型的用法可能是

# postgresql.conf
archive_mode = 'on'
archive_library = 'basic_archive'
basic_archive.archive_directory = '/path/to/archive/directory'

F.5.2. 注意事项 #

服务器崩溃可能会在归档目录中留下带有 archtemp 前缀的临时文件。建议在崩溃后重启服务器之前删除这些文件。只要它们与任何正在进行的归档无关,就可以在服务器运行时安全地删除这些文件,但用户在这样做时应格外小心。

F.5.3. 作者 #

Nathan Bossart

提交更正

如果您在文档中发现任何不正确、与您实际使用该功能不符或需要进一步说明的内容,请使用此表格报告文档问题。