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

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

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本。 PostgreSQL 7.4 已结束支持。 请参阅 当前版本手册.

UNLISTEN

UNLISTEN — 停止监听某个通知

大纲

UNLISTEN { name | * }

描述

UNLISTEN用于移除一个现有的 NOTIFY事件注册。UNLISTEN取消当前 PostgreSQL会话作为通知name监听者的任何现有注册。特殊的通配符*取消当前会话的所有监听者注册。

NOTIFY中包含关于LISTEN和 NOTIFY用法的更广泛的讨论。

参数

name

通知的名称(任何标识符)。

*

清除该会话当前的所有监听注册。

注解

你可以取消监听一个你并没有在监听的东西;不会出现任何警告或错误。

每个会话结束时,UNLISTEN *会被自动执行。

示例

建立一个注册:

LISTEN virtual;
NOTIFY virtual;
Asynchronous notification "virtual" received from server process with PID 8448.

一旦执行了UNLISTEN,后续的NOTIFY 命令将被忽略:

UNLISTEN virtual;
NOTIFY virtual;
-- no NOTIFY event is received

兼容性

SQL 标准中没有UNLISTEN命令。

另见

LISTEN, NOTIFY

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.