pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
归档回调定义了模块的实际归档行为。服务器会根据需要调用它们来处理每一个 WAL 文件。
check_configured_cb 回调用于判断模块是否已完成配置并准备好接收 WAL 文件(例如,它的配置参数是否已经设置为有效值)。如果没有定义 check_configured_cb,服务器始终假定该模块已经配置完毕。
typedef bool (*ArchiveCheckConfiguredCB) (void);
如果返回 true,服务器就会通过调用 archive_file_cb 回调继续归档该文件。如果返回 false,则不会继续归档,归档器会向服务器日志输出如下消息:
WARNING: archive_mode enabled, yet archiving is not configured
在后一种情况下,服务器会周期性地调用此函数,只有当它返回 true 时,归档才会继续。
archive_file_cb 回调用于归档单个 WAL 文件。
typedef bool (*ArchiveFileCB) (const char *file, const char *path);
如果返回 true,服务器就会按该文件已成功归档来继续处理,这可能包括回收或移除原始 WAL 文件。如果返回 false,服务器将保留原始 WAL 文件,并在稍后重试归档。file 只包含待归档 WAL 文件的文件名,而 path 包含该 WAL 文件的完整路径(包括文件名)。
当归档器进程退出(例如发生错误之后),或者 archive_library 的值发生变化时,会调用 shutdown_cb 回调。如果没有定义 shutdown_cb,在这些情况下就不会采取特殊操作。
typedef void (*ArchiveShutdownCB) (void);
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题请通过上游文档表单反馈给 PostgreSQL 文档维护者。