Table of Contents
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模块包含一个可运行的示例,展示了一些有用的技巧。
归档库是通过动态加载共享库的方式载入的,该共享库以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回调是必需的,其余回调都是可选的。
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。