PostgreSQL7.0手册-用户手册-19. SQL命令-LISTEN

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;

Asynchronous　NOTIFY　'virtual'　from　backend　with　pid　'8448'　received.
兼容性
SQL92
在　SQL92　中没有　LISTEN．