UNLISTEN

取消收听-停止收听通知

Synopsis

UNLISTEN { channel | * }

Description

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

NOTIFY包含有关LISTENNOTIFY用法的更广泛讨论。

Parameters

  • channel

    • 通知 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

LISTEN, NOTIFY