↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

受支持版本： 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本： 19 / devel
不受支持的版本： 13 / 12 / 11 / 10
历史版本PostgreSQL 12 已于 2024 年 11 月结束社区维护，本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。
ALTER SUBSCRIPTION
上一页  上一级 SQL 命令 起始页  下一页

ALTER SUBSCRIPTION

ALTER SUBSCRIPTION — 修改订阅的定义

大纲

ALTER SUBSCRIPTION name CONNECTION 'conninfo'
ALTER SUBSCRIPTION name SET PUBLICATION publication_name [, ...] [ WITH ( set_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_USER | SESSION_USER }
ALTER SUBSCRIPTION name RENAME TO new_name

描述

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

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

参数

name

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

CONNECTION 'conninfo'

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

SET PUBLICATION publication_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_commit

new_owner

订阅的新所有者的用户名。

new_name

订阅的新名称。

示例

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

ALTER SUBSCRIPTION mysub SET PUBLICATION insert_only;

禁用（停止）该订阅：

ALTER SUBSCRIPTION mysub DISABLE;

兼容性

ALTER SUBSCRIPTION 是 PostgreSQL 的一个扩展。

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

提交更正

译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。