描述

LISTEN把当前会话注册为通知条件name的监听者。如果当前会话已经被注册为该通知条件的监听者，则不做任何事。

每当命令NOTIFY name被调用时——无论是被本会话还是被连接到同一数据库的其他会话调用——所有当前正在监听该通知条件的会话都会被通知，而每个会话又将进而通知它所连接的客户端应用。更多信息请参阅 NOTIFY的讨论。

可以用UNLISTEN命令取消一个会话对给定通知条件的注册。会话的监听注册在该会话结束时被自动清除。

客户端应用检测通知事件所必须使用的方法取决于它使用的 PostgreSQL应用编程接口。使用 libpq库时，应用像发出普通 SQL 命令一样发出 LISTEN，然后必须周期性地调用函数 PQnotifies来查明是否收到了任何通知事件。其他接口（例如libpgtcl）提供了处理通知事件的更高层方法；实际上，使用libpgtcl时，应用程序员甚至不必直接发出LISTEN或 UNLISTEN。更多细节请参阅你所使用的接口的文档。

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

参数

示例

在psql中配置并执行一个 listen/notify 序列：

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

兼容性

SQL 标准中没有LISTEN语句。

另见