LISTEN

名称

LISTEN — 监听一个通知条件的通知信息

LISTEN name
  

输入

name

通知条件名．

输出

LISTEN

成功完成注册后的返回信息．

NOTICE Async_Listen: We are already listening on name

如果后端已经注册了该通知条件．

描述

LISTEN 将当前 Postgres 后端注册为通知条件 name 的监听器．

当执行了命令 NOTIFY name 后，不管是此后端（进程）或者是其他一个联接到同一数据库的后端（进程）执行的，所有正在监听此通知条件的后端（进程）都将收到通知，并且接下来每个后端将通知与其相连的前端应用．请参考 NOTIFY 获取更多信息．

使用 UNLISTEN 命令，可以将一个后端内已注册的通知条件删除．同样，后端进程退出时自动删除该后端正在监听的已注册通知条件．

前端应用检测通知事件的方法取决于 Postgres 应用使用的编程接口．如果使用基本的 libpq 库，应用将 LISTEN 当作普通 SQL 命令使用，而且必须周期地调用 PQnotifies 过程来检测是否有通知到达．其他像 libpgtcl 接口提供了更高级的控制通知事件的方法；实际上，使用 libpgtcl ，应用程序员不应该直接使用 LISTEN 或 UNLISTEN ．请参考你使用的库的文档获取更多细节．

NOTIFY 的手册页包含更广泛的关于 LISTEN 和NOTIFY 的使用的讨论．

注意

name 可以是任何可以作为名称有效的字符串；它不需要与任何实际表相对应．如果 name 被双引号包围，它甚至可以不是一个有效的语句串，而可以是任何小于31字符的字符串．

一些以前的 Postgres 版本中，如果 name 不与任何现存的表名对应就必须用双引号括起来．不管语意上是否正确．现在不再有这个限制了．

用法

在 psql 里配制和执行一个监听/通知序列：

LISTEN virtual;
NOTIFY virtual;

ASYNC NOTIFY of 'virtual' from backend pid '11239' received
   

兼容性

SQL92

在 SQL92 中没有 LISTEN．