描述

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

每当命令NOTIFY name被执行时，无论是由当前会话还是由另一个连接到同一数据库的会话执行，所有当前正在监听该通知条件的会话都会收到通知，而每个会话随后都会通知其所连接的客户端应用。有关更多信息，请参见对NOTIFY的讨论。

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

客户端应用必须采用何种方法来检测通知事件，取决于它所使用的 PostgreSQL应用程序编程接口。使用 libpq库时，应用程序将LISTEN 作为普通 SQL 命令发出，然后必须定期调用 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语句。

另见