2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10

DROP SUBSCRIPTION

DROP SUBSCRIPTION — 删除订阅

概要

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

描述

DROP SUBSCRIPTION 从数据库集群中删除一个订阅。

要执行此命令,用户必须是订阅的所有者。

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

参数

name

要删除的订阅名称。

CASCADE
RESTRICT

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

注释

当删除与远程主机上的复制槽关联的订阅时(这是正常状态),DROP SUBSCRIPTION 将连接到远程主机,并尝试在操作过程中删除复制槽(以及任何剩余的表同步槽)。这对于释放远程主机上为订阅分配的资源是必需的。如果由于远程主机不可达,或者远程复制槽无法删除、不存在或从未存在而失败,DROP SUBSCRIPTION 命令将失败。要在此情况下继续操作,请先通过执行 ALTER SUBSCRIPTION ... DISABLE 来禁用订阅,然后通过执行 ALTER SUBSCRIPTION ... SET (slot_name = NONE) 将其与复制槽分离。之后,DROP SUBSCRIPTION 将不再尝试在远程主机上执行任何操作。请注意,如果远程复制槽仍然存在,则应手动删除它(以及任何相关的表同步槽);否则,它将继续占用 WAL 空间,并可能最终导致磁盘空间耗尽。另请参阅 第 29.2.1 节

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

示例

删除一个订阅

DROP SUBSCRIPTION mysub;

兼容性

DROP SUBSCRIPTIONPostgreSQL 的一个扩展。

提交更正

如果您在文档中发现任何不正确、与您对特定功能的实际体验不符或需要进一步澄清的内容,请使用 此表格 来报告文档问题。