描述

LISTEN 将当前会话注册为名为 channel 的通知通道的监听者。如果当前会话已经在该通知通道上注册为监听者，则不会执行任何操作。

每当命令 NOTIFY channel 被执行时，无论是由当前会话还是由另一个连接到同一数据库的会话执行，所有当前正在监听该通知通道的会话都会收到通知，而每个会话随后都会通知其所连接的客户端应用。

会话可以使用 UNLISTEN 命令取消在给定通知通道上的监听注册。会话结束时，其监听注册会被自动清除。

客户端应用必须采用何种方法来检测通知事件，取决于它所使用的 PostgreSQL 应用程序编程接口。使用 libpq 库时，应用程序将 LISTEN 作为普通 SQL 命令发出，然后必须定期调用 PQnotifies 函数，以判断是否已经收到任何通知事件。其他接口，例如 libpgtcl，则提供了处理通知事件的更高层方法；事实上，在 libpgtcl 中，应用程序员甚至不应直接发出 LISTEN 或 UNLISTEN。详见所使用接口的相关文档。

NOTIFY 中对 LISTEN 和 NOTIFY 的使用有更详细的讨论。

参数

注解

LISTEN 会在事务提交时生效。如果在随后被回滚的事务中执行了 LISTEN 或 UNLISTEN，则被监听的通知通道集合不会发生变化。

执行过 LISTEN 的事务不能进入两阶段提交的预备状态。

示例

在 psql 中配置并执行一组 listen/notify 操作：

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

兼容性

SQL 标准中没有 LISTEN 语句。

另见