受支持版本: 当前版本 (18) / 17 / 16 / 15
开发版本: devel

Chapter 49. 归档模块

PostgreSQL 提供了用于为连续归档创建自定义模块的基础设施(见Section 25.3)。虽然通过 shell 命令进行归档(也就是archive_command)要简单得多,但自定义归档模块通常会显著更加健壮,性能也更好。

配置了自定义archive_library之后,PostgreSQL 会把已完成的 WAL 文件提交给该模块,而在模块表明这些文件已经成功归档之前,服务器会避免回收或移除这些 WAL 文件。至于如何处理每个 WAL 文件,最终由模块自行决定,不过Section 25.3.1中列出了许多建议。

归档模块至少必须包含一个初始化函数(见Section 49.1)以及所需的回调函数(见Section 49.2)。不过,归档模块也可以做更多事情,例如声明 GUC 或注册后台工作进程。

contrib/basic_archive模块包含一个可运行的示例,展示了一些有用的技巧。

49.1. 初始化函数 #

归档库是通过动态加载共享库的方式载入的,该共享库以archive_library的名称作为库基名。定位该库时使用常规的库搜索路径。为了提供所需的归档模块回调,并表明该库确实是一个归档模块,它需要提供一个名为_PG_archive_module_init的函数。该函数接收一个需要用各个操作的回调函数指针来填充的结构体。

typedef struct ArchiveModuleCallbacks
{
    ArchiveCheckConfiguredCB check_configured_cb;
    ArchiveFileCB archive_file_cb;
    ArchiveShutdownCB shutdown_cb;
} ArchiveModuleCallbacks;
typedef void (*ArchiveModuleInit) (struct ArchiveModuleCallbacks *cb);

只有archive_file_cb回调是必需的,其余回调都是可选的。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。