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

DROP SUBSCRIPTION

DROP SUBSCRIPTION — 删除订阅

概要

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

描述

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

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

如果订阅与复制槽关联,则不能在事务块内执行DROP SUBSCRIPTION。(您可以使用 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 扩展。

提交更正

如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符或需要进一步说明,请使用 此表格 报告文档问题。