历史版本。 PostgreSQL 7.4 已结束支持。 请参阅 当前版本手册.
大纲
pg_listenconnnotifyName?callbackCommand?
描述
pg_listen 创建、更改或取消一个监听来自 PostgreSQL 服务器的异步通知消息的请求。带有
callbackCommand 参数时,会建立该请求,或者替换一个已存在请求的命令字符串。不带
callbackCommand 参数时,则取消先前的请求。
在 pg_listen 请求建立之后,每当从服务器收到带有给定名称的通知消息时,就会执行指定的命令字符串。这发生在任何
PostgreSQL 客户端应用发出一条引用该名称的 NOTIFY 命令时。命令字符串从
Tcl 空闲循环中执行。那是用 Tk 编写的应用程序的正常空闲状态。在非 Tk 的 Tcl
shell 中,你可以执行 update 或
vwait 来进入空闲循环。
在使用 pg_listen 时,你不应直接调用
SQL 语句 LISTEN
或 UNLISTEN。
pgtcl
会替你负责发出这些语句。但如果你想自己发送一条通知消息,可以用
pg_exec 调用 SQL
NOTIFY 语句。
参数
conn要在其上监听通知的连接的句柄。
notifyName要开始或停止监听的通知条件的名称。
callbackCommand如果提供,给出在收到匹配的通知时执行的命令字符串。
返回值
无