↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10

DROP SUBSCRIPTION

DROP SUBSCRIPTION — 移除一个订阅

大纲

DROP SUBSCRIPTION [ IF EXISTS ] name [ CASCADE | RESTRICT ]

描述

DROP SUBSCRIPTION 从数据库集簇中移除一个订阅。

只有超级用户才能删除订阅。

如果该订阅与复制槽相关联,则不能在事务块内执行 DROP SUBSCRIPTION。(可以使用 ALTER SUBSCRIPTION 来取消设置该槽。)

参数

IF EXISTS

如果订阅不存在,不要抛出错误。在这种情况下会发出一个提示。

name

要移除的订阅名称。

CASCADE
RESTRICT

这些关键字没有任何效果,因为订阅上不存在依赖关系。

注解

删除一个与远端主机上的复制槽相关联的订阅时(这通常是正常状态),DROP SUBSCRIPTION 会连接到远端主机,并在执行过程中尝试删除该复制槽(以及任何剩余的表同步槽)。这样做是必要的,以便释放远端主机上为该订阅分配的资源。如果此操作失败,无论是因为远端主机不可达,还是因为远端复制槽无法删除、不存在或者从未存在,DROP SUBSCRIPTION 命令都会失败。要在这种情况下继续,首先执行 ALTER SUBSCRIPTION ... DISABLE 禁用订阅,然后执行 ALTER SUBSCRIPTION ... SET (slot_name = NONE) 将其与复制槽解除关联。此后,DROP SUBSCRIPTION 将不会尝试删除订阅自身的复制槽。如果还有某些表同步尚未完成,它仍可能连接到发布者,以删除由系统内部创建的表同步槽;如果发布者不可达,则必须手工删除这些槽(以及仍然存在的主复制槽)。否则,这些槽会继续保留 WAL,并最终可能导致磁盘被占满。另见第 31.2.1 节。

如果订阅与复制槽相关联,则不能在事务块内执行 DROP SUBSCRIPTION。

示例

删除一个订阅:

DROP SUBSCRIPTION mysub;

兼容性

DROP SUBSCRIPTION 是 PostgreSQL 扩展。

报告文档问题

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