PostgreSQL 14 文档 · ALTER PUBLICATION

文档 → PostgreSQL 14

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

测试与开发版本： 19 / devel

不受支持的版本： 13 / 12 / 11 / 10

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

ALTER PUBLICATION

ALTER PUBLICATION — 修改发布的定义

大纲

ALTER PUBLICATION name ADD TABLE [ ONLY ] table_name [ * ] [, ...]
ALTER PUBLICATION name SET TABLE [ ONLY ] table_name [ * ] [, ...]
ALTER PUBLICATION name DROP TABLE [ ONLY ] table_name [ * ] [, ...]
ALTER PUBLICATION name SET ( publication_parameter [= value] [, ... ] )
ALTER PUBLICATION name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER PUBLICATION name RENAME TO new_name

描述

ALTER PUBLICATION 命令可更改发布的属性。

前三种形式会更改哪些表属于该发布。SET TABLE 子句会用指定列表替换发布中的表列表。ADD TABLE 和 DROP TABLE 子句会向发布添加或从发布移除一个或多个表。请注意，向已被订阅的发布添加表，需要在订阅端执行 ALTER SUBSCRIPTION ... REFRESH PUBLICATION 操作后才会生效。

提要中列出的第四种形式可更改 CREATE PUBLICATION 中指定的所有发布属性。命令中未提及的属性会保留其先前的设置。

其余几种形式用于更改发布的所有者和名称。

要使用 ALTER PUBLICATION，必须拥有该发布。向发布添加表还要求拥有该表。要更改所有者，还必须是新所有者角色的直接或间接成员。新所有者必须在数据库上拥有 CREATE 权限。此外，FOR ALL TABLES 发布的新所有者必须是超级用户。不过，超级用户无论这些限制如何都可以更改发布的所有权。

参数

name #: 要更改其定义的现有发布名称。
table_name #: 现有表的名称。如果在表名前指定了 ONLY，则只有该表受影响。如果未指定 ONLY，则该表及其所有后代表（如果有）都会受影响。还可以在表名后指定*，以显式指明包含后代表。
SET ( publication_parameter [= value] [, ... ] ) #: 该子句用于更改最初由 CREATE PUBLICATION 设置的发布参数。详见该命令的说明。
new_owner #: 发布的新所有者的用户名。
new_name #: 发布的新名称。

示例

将发布修改为只发布删除和更新操作：

ALTER PUBLICATION noinsert SET (publish = 'update, delete');

向发布中添加一些表：

ALTER PUBLICATION mypublication ADD TABLE users, departments;

兼容性

ALTER PUBLICATION 是 PostgreSQL 的一个扩展。

另见

CREATE PUBLICATION, DROP PUBLICATION, CREATE SUBSCRIPTION, ALTER SUBSCRIPTION

上一页	上一级	下一页
ALTER PROCEDURE	起始页	ALTER ROLE

提交更正

译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题请通过上游文档表单反馈给 PostgreSQL 文档维护者。