pg_receivewal

用于写入输出的目录。

这个参数是必需的。

当接收位置到达指定 LSN 时，自动停止复制并以正常退出状态 0 退出。

如果存在 LSN 恰好等于lsn的记录，该记录也会被处理。

当指定--create-slot且同名槽已存在时，不报错。

遇到连接错误时不要循环重试，而是立即报错退出。

此选项会使pg_receivewal不强制将 WAL 数据刷写到磁盘。这样会更快，但也意味着如果随后发生操作系统崩溃，可能会留下损坏的 WAL 段。一般来说，此选项适合测试，但不应在生产环境中执行 WAL 归档时使用。

这个选项与--synchronous不兼容。

指定向服务器回送状态包的时间间隔（秒）。这样更便于从服务器端监视进度。值为零将完全禁用周期性状态更新，不过在服务器请求时仍会发送更新，以避免因超时而断开连接。默认值是 10 秒。

要求pg_receivewal使用一个现有复制槽（见第 26.2.6 节）。使用此选项时，pg_receivewal会向服务器报告刷写位置，指示每个段何时已同步到磁盘，以便服务器在该段不再被需要时将其移除。

当服务器将pg_receivewal的复制客户端配置为同步备库时，使用复制槽会向服务器报告刷写位置，但只会在一个 WAL 文件关闭时才报告。因此，这种配置会导致主库上的事务长时间等待，实际上无法令人满意地工作。要让这种配置正确工作，还必须另外指定--synchronous选项（见下文）。

在收到 WAL 数据后立即将其刷写到磁盘。无论--status-interval如何，刷写后还会立即向服务器回送状态包。

如果服务器将pg_receivewal的复制客户端配置为同步备库，则应指定此选项，以确保及时向服务器发送反馈。

启用详细输出模式。

启用预写式日志的压缩。

压缩方法可以设置为gzip、lz4（如果PostgreSQL编译时启用了--with-lz4）或none（不压缩）。还可以选择指定压缩细节字符串。如果该字符串是整数，则表示压缩级别；否则应为用逗号分隔的列表，其中每一项都采用keyword或keyword=value的形式。目前，唯一支持的关键字是level。

如果未指定压缩级别，将使用默认级别。如果只指定级别而未指定算法，则级别大于 0 时使用 gzip 压缩，级别为 0 时不压缩。

使用 gzip 时，所有文件名都会自动添加 .gz 后缀；使用 lz4 时，添加 .lz4 后缀。

以连接字符串的形式指定用于连接到服务器的参数；这些参数会覆盖任何冲突的命令行选项。

为了与其他客户端应用保持一致，该选项被称为--dbname。但由于pg_receivewal并不连接到集簇中的任何特定数据库，连接字符串中包含的数据库名会被服务器忽略。不过，以这种方式提供的数据库名会覆盖默认数据库名（replication），用于在~/.pgpass中查找复制连接的密码。类似地，连接到PostgreSQL时使用的中间件或代理也可能将该名称用于连接路由等目的。

指定运行服务器的主机名。如果该值以斜杠开头，则被用作 Unix 域套接字的目录。默认值取自PGHOST环境变量（如果已设置），否则尝试 Unix 域套接字连接。

指定服务器正在监听连接的 TCP 端口，或本地 Unix 域套接字文件扩展名。默认值取自PGPORT环境变量（如果已设置），否则使用编译时的默认值。

用于连接的用户名。

绝不提示输入密码。如果服务器要求密码认证，而又无法通过.pgpass文件等其他方式获得密码，则连接尝试将会失败。此选项可用于批处理作业和脚本，因为这些场景中没有用户在场输入密码。

强制pg_receivewal在建立连接前提示输入密码。

这个选项从来都不是必需的，因为如果服务器要求密码认证，pg_receivewal会自动提示输入密码。不过，pg_receivewal需要先浪费一次连接尝试，才能发现服务器需要密码。在某些情况下，输入-W以避免这次额外的连接尝试是值得的。

使用--slot中指定的名称创建一个新的物理复制槽，然后退出。

删除--slot中指定名称的复制槽，然后退出。

打印pg_receivewal的版本并退出。

显示pg_receivewal命令行参数的帮助并退出。