ALTER SUBSCRIPTION

支持中的版本：当前版本 (18) / 17 / 16 / 15 / 14

开发中的版本： 19 / 20devel

已结束支持的版本： 13 / 12 / 11 / 10

ALTER SUBSCRIPTION
上一页	上一级	SQL 命令	起始页	下一页

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 OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SUBSCRIPTION name RENAME TO new_name

描述

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

要使用 ALTER SUBSCRIPTION，必须拥有该订阅。要更改所有者，还必须是新所有者角色的直接或间接成员。新所有者必须是超级用户。（目前，所有订阅所有者都必须是超级用户，因此实际上会绕过所有者检查。但将来可能会改变。）

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

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

参数

name #

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

CONNECTION 'conninfo' #

该子句更改最初由 CREATE SUBSCRIPTION 设置的连接属性。详情请参见该命令。

SET PUBLICATION publication_name ADD PUBLICATION publication_name DROP PUBLICATION publication_name #

这些形式会更改已订阅发布的列表。SET 用新列表替换整个发布列表，ADD 向发布列表中添加额外的发布，而 DROP 从发布列表中移除发布。详情请参见 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。（以前已订阅的表不会再次复制。）

ENABLE #

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

DISABLE #

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

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

该子句修改最初由 CREATE SUBSCRIPTION 设置的参数。详情请参见该命令。可更改的参数有 slot_name、synchronous_commit、binary 和 streaming。

new_owner #

订阅新所有者的用户名。

new_name #

订阅的新名称。

示例

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

ALTER SUBSCRIPTION mysub SET PUBLICATION insert_only;

禁用（停止）该订阅：

ALTER SUBSCRIPTION mysub DISABLE;

兼容性

ALTER SUBSCRIPTION 是 PostgreSQL 的一个扩展。

另见

CREATE SUBSCRIPTION, DROP SUBSCRIPTION, CREATE PUBLICATION, ALTER PUBLICATION

上一页	上一级	下一页
ALTER STATISTICS	起始页	ALTER SYSTEM

报告文档问题

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