# 皮克_恢复逻辑的

皮克_recvlogical — 控制 PostgreSQL 逻辑解码流

# 概要

pg_recvlogical [选项...]

# 描述

pg_recvlogical控制逻辑解码复制槽并从这些复制槽流式传输数据。

它创建了一个复制模式连接,因此它受到相同的约束皮克_收货,加上那些用于逻辑复制的(见第 49 章)。

pg_recvlogical没有相当于逻辑解码SQL接口的peek and get模式。它在收到数据并在干净退出时懒惰地发送数据的重播确认。要检查插槽上的待处理数据而不使用它,请使用pg_logical_slot_peek_changes.

# 选项

必须至少指定以下选项之一才能选择操作:

--创建槽

使用指定的名称创建一个新的逻辑复制槽- 投币口,使用指定的输出插件- 插入, 对于指定的数据库--dbname.

--drop-slot

删除具有指定名称的复制槽- 投币口,然后退出。

- 开始

从指定的逻辑复制槽开始流式传输更改- 投币口,继续直到被信号终止。如果服务器端更改流以服务器关闭或断开连接结束,则循环重试,除非--无循环被指定。

流格式由创建插槽时指定的输出插件确定。

连接必须与用于创建插槽的数据库相同。

--创建槽- 开始可以一起指定。--drop-slot不能与其他动作结合。

以下命令行选项控制输出的位置和格式以及其他复制行为:

-E *lsn*
--endpos=*lsn*

- 开始模式,当接收到达指定的 LSN 时,自动停止复制并以正常退出状态 0 退出。如果指定时不在- 开始模式,引发错误。

如果有一条 LSN 正好等于的记录*lsn*,记录将被输出。

--endpos选项不知道事务边界,并且可能会在事务的中途截断输出。任何部分输出的事务都不会被消耗,并且会在下一次读取槽时再次重播。单个消息永远不会被截断。

-f *文件名*
--文件=*文件名*

将接收和解码的交易数据写入此文件。采用-对于标准输出。

-F *间隔秒数*
--fsync-interval=*间隔秒数*

指定 pg 的频率_recvlogical 应该发出同步()调用以确保输出文件安全地刷新到磁盘。

服务器偶尔会请求客户端执行刷新,并将刷新位置报告给服务器。除此之外,此设置还可以更频繁地执行刷新。

指定间隔0禁用发行同步()完全调用,同时仍向服务器报告进度。在这种情况下,一旦发生崩溃,数据可能会丢失。

-一世 *lsn*
--startpos=*lsn*

- 开始模式,从给定的 LSN 开始复制。有关此效果的详细信息,请参阅文档第 49 章第 53.4 节.在其他模式下被忽略。

--如果不存在

不出错时--创建槽已指定且具有指定名称的插槽已存在。

-n
--无循环

当与服务器的连接丢失时,不要循环重试,直接退出。

-o *姓名*[=*价值*]
--选项=*姓名*[=*价值*]

通过选项*姓名到输出插件,如果指定,选项值价值*.存在哪些选项及其效果取决于使用的输出插件。

-P *插入*
--插件=*插入*

创建插槽时,使用指定的逻辑解码输出插件。看第 49 章.如果插槽已存在,则此选项无效。

-s *间隔秒数*
--状态间隔=*间隔秒数*

该选项与中的同名选项具有相同的效果皮克_收货.见那里的描述。

-S *槽名*
--槽=*槽名*

- 开始模式,使用名为的现有逻辑复制槽*槽名*.在--创建槽模式,创建具有此名称的插槽。在--drop-slot模式,删除具有此名称的插槽。

-v
--详细

启用详细模式。

以下命令行选项控制数据库连接参数。

-d *数据库名称*
--dbname=*数据库名称*

要连接的数据库。有关这意味着什么,请参阅操作说明。这*数据库名称*可以是一个连接字符串.如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。默认为用户名。

-h *主机名或 IP*
--主机=*主机名或 IP*

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

-p *港口*
--端口=*港口*

指定服务器正在侦听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。默认为PGPORT环境变量(如果设置)或编译的默认值。

-U *用户*
--用户名=*用户*

要连接的用户名。默认为当前操作系统用户名。

-w
--无密码

永远不要发出密码提示。如果服务器需要密码验证,而密码无法通过其他方式获得,例如.pgpass文件,连接尝试将失败。此选项在没有用户输入密码的批处理作业和脚本中很有用。

-W
- 密码

强制 pg_recvlogical 在连接到数据库之前提示输入密码。

这个选项从来都不是必需的,因为 pg_如果服务器要求密码验证,recvlogical 将自动提示输入密码。然而,pg_recvlogical 将浪费一次连接尝试,发现服务器需要密码。在某些情况下,值得输入-W以避免额外的连接尝试。

提供以下附加选项:

-V
- 版本

打印 pg_recvlogical 版本并退出。

-?
- 帮助

显示关于 pg 的帮助_recvlogical 命令行参数,然后退出。

# 环境

与大多数其他 PostgreSQL 实用程序一样,此实用程序使用 libpq 支持的环境变量(请参阅第 34.15 节)。

环境变量PG_COLOR指定是否在诊断消息中使用颜色。可能的值为总是,汽车绝不.

# 笔记

皮克_如果在源集群上启用了组权限,recvlogical 将保留收到的 WAL 文件的组权限。

# 例子

第 49.1 节例如。

# 也可以看看

皮克_收货