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

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

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10

ALTER SUBSCRIPTION

ALTER SUBSCRIPTION — 修改订阅的定义

大纲

ALTER SUBSCRIPTION name CONNECTION 'conninfo'
ALTER SUBSCRIPTION name SET PUBLICATION publication_name [, ...] [ WITH ( publication_option [= value] [, ... ] ) ]
ALTER SUBSCRIPTION name ADD PUBLICATION publication_name [, ...] [ WITH ( publication_option [= value] [, ... ] ) ]
ALTER SUBSCRIPTION name DROP PUBLICATION publication_name [, ...] [ WITH ( publication_option [= value] [, ... ] ) ]
ALTER SUBSCRIPTION name REFRESH PUBLICATION [ WITH ( refresh_option [= value] [, ... ] ) ]
ALTER SUBSCRIPTION name ENABLE
ALTER SUBSCRIPTION name DISABLE
ALTER SUBSCRIPTION name SET ( subscription_parameter [= value] [, ... ] )
ALTER SUBSCRIPTION name SKIP ( skip_option = value )
ALTER SUBSCRIPTION name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SUBSCRIPTION name RENAME TO new_name

描述

ALTER SUBSCRIPTION 可以更改大多数可在 CREATE SUBSCRIPTION 中指定的订阅属性。

要使用 ALTER SUBSCRIPTION,你必须拥有该订阅。要重命名订阅或更改其所有者,你必须在数据库上具有 CREATE 权限。此外,要更改所有者,你必须能够对新的拥有角色执行 SET ROLE。如果该订阅具有 password_required=false,则只有超级用户可以修改它。

刷新发布时,会移除不再属于该发布的关系;如果存在表同步槽,也会一并删除。必须删除这些槽,才能释放远端主机上为该订阅分配的资源。如果由于网络故障或其他错误,PostgreSQL 无法删除这些槽,则会报告错误。在这种情况下,如需继续,用户要么重试该操作,要么按 DROP SUBSCRIPTION 中的说明将该槽与订阅解除关联并删除该订阅。

命令 ALTER SUBSCRIPTION ... REFRESH PUBLICATION、带有 refresh = true 选项的 ALTER SUBSCRIPTION ... {SET|ADD|DROP} PUBLICATION ...、ALTER SUBSCRIPTION ... SET (failover = true|false) 以及 ALTER SUBSCRIPTION ... SET (two_phase = false) 不能在事务块内执行。

命令 ALTER SUBSCRIPTION ... REFRESH PUBLICATION 以及带有 refresh = true 选项的 ALTER SUBSCRIPTION ... {SET|ADD|DROP} PUBLICATION ...,在订阅启用了 two_phase 参数时也不能执行,除非 copy_data 为 false。要了解实际的两阶段状态,可参见 pg_subscription 的 subtwophasestate 列。

参数

name #

要更改其属性的订阅名称。

CONNECTION 'conninfo' #

该子句替换最初由 CREATE SUBSCRIPTION 设置的连接字符串。详情请参见该命令。

SET PUBLICATION publication_name
ADD PUBLICATION publication_name
DROP PUBLICATION publication_name #

这些形式会更改已订阅发布的列表。SET 用新列表替换整个发布列表,ADD 向发布列表中添加额外的发布,而 DROP 从发布列表中移除发布。在 ADD 和 SET 变体中,允许指定不存在的发布,以便用户稍后再创建这些发布。详情请参见 CREATE SUBSCRIPTION。默认情况下,此命令还会执行与 REFRESH PUBLICATION 类似的操作。

publication_option 指定此操作的附加选项。支持的选项有:

refresh (boolean)

为 false 时,该命令不会尝试刷新表信息。此时应单独执行 REFRESH PUBLICATION。默认值为 true。

此外,还可以指定 REFRESH PUBLICATION 下描述的选项,以控制隐式执行的刷新操作。

REFRESH PUBLICATION #

从发布者获取缺失的表信息。这将开始复制自 CREATE SUBSCRIPTION 或上次执行 REFRESH PUBLICATION 以来添加到已订阅发布中的表。

refresh_option 指定刷新操作的附加选项。支持的选项有:

copy_data (boolean)

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

以前已订阅的表不会再次复制,即使某个表的行过滤器 WHERE 子句此后已被修改。

关于 copy_data = true 如何与 origin 参数相互作用的细节,请参见注意。

关于以二进制格式复制预先存在的数据的细节,请参见 CREATE SUBSCRIPTION 的 binary 参数。

ENABLE #

启用先前已禁用的订阅,并在事务结束时启动逻辑复制工作进程。

DISABLE #

禁用正在运行的订阅,并在事务结束时停止逻辑复制工作进程。

SET ( subscription_parameter [= value] [, ... ] ) #

该子句修改最初由 CREATE SUBSCRIPTION 设置的参数。详情请参见该命令。可更改的参数有 slot_name、synchronous_commit、binary、streaming、disable_on_error、password_required、run_as_owner、origin、failover 以及 two_phase。只有超级用户才能设置 password_required = false。

更改 slot_name 时,所指定槽的 failover 和 two_phase 属性值,可能与订阅中相应的 failover 和 two_phase 参数不同。创建该槽时,应确保槽的 failover 和 two_phase 属性与订阅中对应的参数一致。否则,发布者上的该槽的行为可能与这些订阅选项所表明的不同:例如,即使订阅的 failover 选项已禁用,发布者上的该槽仍可能被同步到备库;或者即使订阅的 failover 选项已启用,该槽也可能不会被同步到备库。

只有在订阅被禁用时,才能更改 failover 和 two_phase 参数。

当将 two_phase 从 true 改为 false 时,如果发现逻辑复制工作进程在 two_phase 参数仍为 true 时执行的任何预备事务,后端进程会报告错误。你可以在发布者节点上处理这些预备事务,或者在订阅者上手工回滚它们,然后再次尝试。与特定订阅对应、由逻辑复制工作进程预备的事务具有如下模式:“pg_gid_%u_%u”(参数:订阅 oid,远端事务 ID xid)。要手工处理这类事务,需要回滚名称中包含相应订阅 ID 的所有预备事务。应用可以检查 pg_prepared_xacts 来找出所需的预备事务。在 two_phase 选项从 true 改为 false 之后,这些事务在提交时会由发布者再次复制。

SKIP ( skip_option = value ) #

跳过应用远端事务的所有更改。如果传入数据违反任何约束,逻辑复制会停止,直到问题解决。通过使用 ALTER SUBSCRIPTION ... SKIP 命令,逻辑复制工作进程会跳过该事务中的所有数据修改操作。此选项对因在订阅者上启用 two_phase 而已经预备的事务没有作用。逻辑复制工作进程成功跳过该事务或完成一个事务后,LSN(存储在 pg_subscription.subskiplsn 中)会被清除。有关逻辑复制冲突的详细信息,请参见第 29.7 节。

skip_option 指定此操作的选项。支持的选项有:

lsn (pg_lsn)

指定逻辑复制工作进程要跳过其更改的远端事务的完成 LSN。完成 LSN 是该事务提交或预备时所在的 LSN。不支持跳过单个子事务。设置 NONE 会重置该 LSN。

new_owner #

订阅新所有者的用户名。

new_name #

订阅的新名称。

当指定 boolean 类型的参数时,可以省略 = value 部分,这等价于指定 TRUE。

示例

将订阅所订阅的发布更改为 insert_only:

ALTER SUBSCRIPTION mysub SET PUBLICATION insert_only;

禁用(停止)该订阅:

ALTER SUBSCRIPTION mysub DISABLE;

兼容性

ALTER SUBSCRIPTION 是 PostgreSQL 的一个扩展。

报告文档问题

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