选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

CREATE SUBSCRIPTION

CREATE SUBSCRIPTION — 定义一个新的订阅

Synopsis

CREATE SUBSCRIPTION subscription_name
    CONNECTION 'conninfo'
    PUBLICATION publication_name [, ...]
    [ WITH ( subscription_parameter [= value] [, ... ] ) ]

描述

CREATE SUBSCRIPTION添加一个新的逻辑复制订阅。 创建订阅的用户将成为该订阅的所有者。订阅名称必须与当前数据库中 任何现有订阅的名称不同。

订阅表示与发布者的复制连接。因此,除了在本地系统目录中添加定义之外, 该命令通常还会在发布者上创建一个复制槽。

除非订阅初始即被禁用,否则在执行该命令所在事务提交时,会启动一个 逻辑复制工作进程为新订阅复制数据。

关于订阅以及逻辑复制整体的更多信息,见Section 30.2Chapter 30

参数

subscription_name

新订阅的名称。

CONNECTION 'conninfo'

连接到发布者的连接字符串。详情请参见Section 33.1.1

PUBLICATION publication_name

要订阅的发布者上的发布名称。

WITH ( subscription_parameter [= value] [, ... ] )

此子句指定订阅的可选参数。支持以下参数:

copy_data (boolean)

指定复制开始后,是否复制所订阅发布中已经存在的数据。 默认值为true

create_slot (boolean)

指定该命令是否应在发布者上创建复制槽。默认值为 true

enabled (boolean)

指定订阅是应当主动进行复制,还是仅完成设置但暂不启动。 默认值为true

slot_name (string)

要使用的复制槽名称。默认行为是使用订阅名称作为槽名。

slot_name设为NONE时, 该订阅将不关联任何复制槽。当复制槽将在稍后手工创建时, 可以使用这种方式。这类订阅还必须同时将 enabledcreate_slot 设为false

synchronous_commit (enum)

此参数的值会覆盖synchronous_commit设置。默认值为off

对逻辑复制来说,使用off是安全的:如果订阅者因 缺少同步而丢失了事务,数据会再次从发布者发送过来。

在进行同步逻辑复制时,可能更适合使用不同的设置。逻辑复制工作进程会向 发布者报告写入和刷盘位置,而在使用同步复制时,发布者会等待真正的刷盘完成。 这意味着,当订阅被用于同步复制时,将订阅者的 synchronous_commit 设为 off 可能会增加发布者上 COMMIT 的延迟。在这种场景下, 将 synchronous_commit 设为 local 或更高可能更有利。

connect (boolean)

指定 CREATE SUBSCRIPTION 是否连接到发布者。 将其设为 false 会把 enabledcreate_slotcopy_data 的默认值改为 false

不允许将 connect 设为 false, 同时又把 enabledcreate_slotcopy_data 设为 true

由于该选项设为 false 时不会建立连接,因此表不会被订阅, 所以即使之后启用了订阅,也不会复制任何内容。必须执行 ALTER SUBSCRIPTION ... REFRESH PUBLICATION 才会订阅这些表。

注意

关于如何在订阅与发布实例之间配置访问控制,详见 Section 30.7

当创建复制槽时(这是默认行为),CREATE SUBSCRIPTION 不能在事务块内部执行。

创建一个连接到同一数据库集簇的订阅(例如在同一集簇中的不同数据库之间 复制,或者在同一数据库内复制)时,只有在复制槽不作为同一命令的一部分 创建的情况下才会成功。否则,CREATE SUBSCRIPTION 调用将挂起。要实现这种用法,应分别创建复制槽(使用函数 pg_create_logical_replication_slot 并指定插件名 pgoutput),然后使用参数 create_slot = false 创建订阅。 这是一个实现限制,未来版本中可能会解除。

示例

创建一个指向远端服务器的订阅,复制发布 mypublicationinsert_only中的表, 并在提交时立即开始复制:

CREATE SUBSCRIPTION mysub
         CONNECTION 'host=192.168.1.50 port=5432 user=foo dbname=foodb'
        PUBLICATION mypublication, insert_only;

创建一个指向远端服务器的订阅,复制insert_only发布中的表, 并且要等到稍后启用时才开始复制。

CREATE SUBSCRIPTION mysub
         CONNECTION 'host=192.168.1.50 port=5432 user=foo dbname=foodb'
        PUBLICATION insert_only
               WITH (enabled = false);

兼容性

CREATE SUBSCRIPTIONPostgreSQL扩展。