Postgresql 中文操作指南

UNLISTEN

UNLISTEN — 停止侦听通知

Synopsis

UNLISTEN { channel | * }

Description

UNLISTEN 用于移除对 NOTIFY 事件的现有注册。 UNLISTEN 取消任何将当前 PostgreSQL 会话注册为名为 channel 的通知信道上的侦听器的现有注册。特殊通配符 * 会取消当前会话的所有侦听器注册。

NOTIFY 对使用 LISTENNOTIFY 做了更广泛的讨论。

Parameters

  • channel

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

  • *

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

Notes

你可以取消未收听的收听;不会显示警告或错误。

在每个会话的末尾,自动执行 UNLISTEN *

已经执行 UNLISTEN 的事务不能准备用于两阶段提交。

Examples

进行注册:

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

Compatibility

SQL 标准中没有 UNLISTEN 命令。

See Also