ALTER SUBSCRIPTION
ALTER SUBSCRIPTION — 修改订阅的定义
大纲
ALTER SUBSCRIPTIONnameCONNECTION 'conninfo' ALTER SUBSCRIPTIONnameSET PUBLICATIONpublication_name[, ...] [ WITH (set_publication_option[=value] [, ... ] ) ] ALTER SUBSCRIPTIONnameREFRESH PUBLICATION [ WITH (refresh_option[=value] [, ... ] ) ] ALTER SUBSCRIPTIONnameENABLE ALTER SUBSCRIPTIONnameDISABLE ALTER SUBSCRIPTIONnameSET (subscription_parameter[=value] [, ... ] ) ALTER SUBSCRIPTIONnameOWNER TO {new_owner| CURRENT_USER | SESSION_USER } ALTER SUBSCRIPTIONnameRENAME TOnew_name
描述
ALTER SUBSCRIPTION 可以更改大多数可在 CREATE SUBSCRIPTION 中指定的订阅属性。
要使用 ALTER SUBSCRIPTION,必须拥有该订阅。要更改所有者,还必须是新所有者角色的直接或间接成员。新所有者必须是超级用户。(目前,所有订阅所有者都必须是超级用户,因此实际上会绕过所有者检查。但将来可能会改变。)
参数
name要更改其属性的订阅名称。
CONNECTION 'conninfo'该子句更改最初由 CREATE SUBSCRIPTION 设置的连接属性。详情请参见该命令。
SET PUBLICATIONpublication_name更改已订阅发布的列表。更多信息请参见 CREATE SUBSCRIPTION。默认情况下,此命令还会执行类似
REFRESH PUBLICATION的操作。set_publication_option指定此操作的其他选项。支持的选项包括:refresh(boolean)为 false 时,命令不会尝试刷新表信息。此时应单独执行
REFRESH PUBLICATION。默认值为true。
此外,还可以指定
REFRESH PUBLICATION中所述的刷新选项。REFRESH PUBLICATION从发布者获取缺失的表信息。这将开始复制自上次调用
REFRESH PUBLICATION或自CREATE SUBSCRIPTION以来添加到已订阅发布中的表。refresh_option指定刷新操作的其他选项。支持的选项包括:copy_data(boolean)指定在复制开始时,是否复制所订阅发布中预先存在的数据。默认值为
true。(以前已订阅的表不会再次复制。)
ENABLE启用先前禁用的订阅,并在事务结束时启动逻辑复制工作进程。
DISABLE禁用正在运行的订阅,并在事务结束时停止逻辑复制工作进程。
SET (subscription_parameter[=value] [, ... ] )此子句更改最初由 CREATE SUBSCRIPTION 设置的参数。更多信息请参见该命令。允许的选项包括
slot_name和synchronous_commitnew_owner订阅的新所有者的用户名。
new_name订阅的新名称。
示例
将订阅所订阅的发布更改为 insert_only:
ALTER SUBSCRIPTION mysub SET PUBLICATION insert_only;
禁用(停止)该订阅:
ALTER SUBSCRIPTION mysub DISABLE;
兼容性
ALTER SUBSCRIPTION 是 PostgreSQL
的一个扩展。