历史版本。 PostgreSQL 6.4 已结束支持。 请参阅 当前版本手册.
LISTEN
LISTEN — 监听某个通知条件上的通知
大纲
LISTEN notifyname输入
notifyname通知条件的名称。
输出
- →
LISTEN 注册成功完成时返回的消息。
- →
NOTICE Async_Listen: We are already listening on notifyname 如果该后端已经注册了该通知条件。
描述
LISTEN 把当前的Postgres后端注册为通知条件
notifyname的监听者。
每当命令
NOTIFY
被调用时——无论是被本后端还是被连接到同一数据库的其他后端调用——所有当前正在监听该通知条件的后端都会被通知，而每个后端又将进而通知它所连接的前端应用。更多信息请参阅
notifynameNOTIFY的讨论。
可以用UNLISTEN命令取消一个后端对给定通知条件的注册。此外，后端的监听注册在后端进程退出时会被自动清除。
前端应用检测通知事件所必须使用的方法取决于它使用的
Postgres应用编程接口。使用基本的 libpq 库时，应用像发出普通 SQL 命令一样发出
LISTEN，然后必须周期性地调用例程
PQnotifies来查明是否收到了任何通知事件。其他接口（例如 libpgtcl）提供了处理通知事件的更高层方法；实际上，使用 libpgtcl 时，应用程序员甚至不必直接发出LISTEN或
UNLISTEN。更多细节请参阅你所使用的库的文档。
NOTIFY的参考页包含关于LISTEN和
NOTIFY用法的更广泛的讨论。
注解
notifyname
可以是任何可作为名称使用的有效字符串；它不需要对应任何实际表的名称。如果
notifyname
被双引号括起来，它甚至不必是语法上有效的名称，而可以是长度不超过 31 个字符的任何字符串。
在Postgres的一些早期版本中，notifyname
不对应任何现有表名时，即使它在语法上是有效的名称，也必须用双引号把它括起来。现在已不再需要这样。
用法
-- Configure and execute a listen/notify sequence from psql postgres=> listen virtual; LISTEN postgres=> notify virtual; NOTIFY ASYNC NOTIFY of 'virtual' from backend pid '11239' received
兼容性
SQL92
LISTEN 在 SQL92 中没有。