ALTER SUBSCRIPTION — 修改订阅的定义
ALTER SUBSCRIPTIONnameCONNECTION 'conninfo' ALTER SUBSCRIPTIONnameSET PUBLICATIONpublication_name[, ...] [ WITH (publication_option[=value] [, ... ] ) ] ALTER SUBSCRIPTIONnameADD PUBLICATIONpublication_name[, ...] [ WITH (publication_option[=value] [, ... ] ) ] ALTER SUBSCRIPTIONnameDROP PUBLICATIONpublication_name[, ...] [ WITH (publication_option[=value] [, ... ] ) ] ALTER SUBSCRIPTIONnameREFRESH PUBLICATION [ WITH (refresh_option[=value] [, ... ] ) ] ALTER SUBSCRIPTIONnameENABLE ALTER SUBSCRIPTIONnameDISABLE ALTER SUBSCRIPTIONnameSET (subscription_parameter[=value] [, ... ] ) ALTER SUBSCRIPTIONnameSKIP (skip_option=value) ALTER SUBSCRIPTIONnameOWNER TO {new_owner| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER SUBSCRIPTIONnameRENAME TOnew_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 ... 不能在事务块内执行。
name #要更改其属性的订阅名称。
CONNECTION 'conninfo' #该子句替换最初由CREATE SUBSCRIPTION设置的连接字符串。 详情请参见该命令。
SET PUBLICATION publication_nameADD PUBLICATION publication_nameDROP 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。(以前已订阅的表不会再次复制。)
ENABLE #启用先前已禁用的订阅,并在事务结束时启动逻辑复制工作进程。
DISABLE #禁用正在运行的订阅,并在事务结束时停止逻辑复制工作进程。
SET ( subscription_parameter [= value] [, ... ] ) #该子句修改最初由CREATE SUBSCRIPTION设置的参数。 详情请参见该命令。可更改的参数有 slot_name、 synchronous_commit、 binary和 streaming。
SKIP ( skip_option = value ) #跳过应用远端事务的所有更改。如果传入数据违反任何约束,逻辑复制会停止,直到问题解决。 通过使用ALTER SUBSCRIPTION ... SKIP命令,逻辑复制工作进程会跳过 该事务中的所有数据修改操作。若订阅者上启用了 two_phase,则此选项对因在订阅者上启用该参数而已经预备的事务没有作用。逻辑复制工作进程成功跳过该事务或完成一个事务后, LSN(存储在pg_subscription.subskiplsn中) 会被清除。有关逻辑复制冲突的详细信息,请参见 Section 29.3。
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 的一个扩展。
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。