描述

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

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

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

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

参数

注解

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

执行过LISTEN的事务不能为两阶段提交做准备。

第一次建立监听会话时存在一个竞争条件：如果并发提交的事务正在发送通知 事件，那么新开始监听的会话究竟会收到其中哪些事件？答案是，该会话会收到 那些在其事务提交步骤中的某个时刻之后提交的所有事件。但这个时刻会略晚于 该事务通过查询所能观察到的任何数据库状态。因此，使用LISTEN 时应遵循如下规则：先执行该命令并提交，然后在一个新事务中按照应用逻辑的 需要检查数据库状态，之后再依靠通知来获知数据库状态的后续变化。最初收到 的几个通知，可能对应于初次检查数据库时已经观察到的更新，但这通常无害。

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

示例

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

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

兼容性

SQL 标准中没有LISTEN语句。

另见