↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15
开发中的版本: 19 / 20devel

F.5. basebackup_to_shell — 示例“shell” pg_basebackup 模块 #

basebackup_to_shell 新增了一个名为 shell 的自定义基础备份目标。这样便可以运行 pg_basebackup --target=shell,或者根据该模块的配置运行 pg_basebackup --target=shell:DETAIL_STRING,并使服务器管理员选定的服务器命令针对备份过程生成的每个 tar 归档执行一次。该命令将通过标准输入接收归档内容。

该模块主要是用作一个示例,用于说明如何通过扩展模块创建新的备份目标,但在某些场景下,它本身也可能有用。要使该模块正常工作,必须通过 shared_preload_libraries 或 local_preload_libraries 加载它。

F.5.1. 配置参数 #

basebackup_to_shell.command (string)

服务器应为备份过程生成的每个归档执行的命令。如果命令字符串中出现 %f,它将被替换为归档名称(例如 base.tar)。如果命令字符串中出现 %d,它将被替换为用户提供的目标详情。如果命令字符串中使用了 %d,则必须提供目标详情;否则禁止提供目标详情。出于安全原因,目标详情只能包含字母数字字符。如果命令字符串中出现%%,它将被替换为单个%。如果命令字符串中出现%,其后跟着任何其他字符,或者它出现在字符串末尾,则会发生错误。

basebackup_to_shell.required_role (string)

使用 shell 备份目标所需的角色。如果未设置该参数,则任何复制用户都可以使用 shell 备份目标。

F.5.2. 作者 #

Robert Haas

报告文档问题

阅读 上游文档. 通过 PostgreSQL 文档反馈表单.