LISTEN — 监听通知
LISTEN channel
LISTEN将当前会话注册为名为channel的通知通道的监听者。 如果当前会话已经在该通知通道上注册为监听者,则不会执行任何操作。
每当命令NOTIFY 被执行时,无论是由当前会话 还是由另一个连接到同一数据库的会话执行,所有当前正在监听该通知通道的 会话都会收到通知,而每个会话随后都会通知其所连接的客户端应用。channel
会话可以使用UNLISTEN命令取消在给定通知通道上的监听注册。 会话结束时,其监听注册会被自动清除。
客户端应用必须采用何种方法来检测通知事件,取决于它所使用的 PostgreSQL应用程序编程接口。使用 libpq库时,应用程序将LISTEN 作为普通 SQL 命令发出,然后必须定期调用 PQnotifies函数,以判断是否已经收到任何通知事件。 其他接口,例如libpgtcl,则提供了处理通知事件的 更高层方法;事实上,在libpgtcl中,应用程序员 甚至不应直接发出LISTEN或UNLISTEN。 详见所使用接口的相关文档。
NOTIFY中对LISTEN和NOTIFY的使用有更详细的讨论。
channel通知通道的名称(任意标识符)。
LISTEN会在事务提交时生效。 如果在随后被回滚的事务中执行了LISTEN或 UNLISTEN,则被监听的通知通道集合不会发生变化。
执行过LISTEN的事务不能为两阶段提交做准备。
在psql中配置并执行一组 listen/notify 操作:
LISTEN virtual; NOTIFY virtual; Asynchronous notification "virtual" received from server process with PID 8448.
SQL 标准中没有LISTEN语句。