↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

已结束支持的版本: 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本。 PostgreSQL 7.4 已结束支持。 请参阅 当前版本手册.

pg_listen

pg_listen — 设置或更改异步通知消息的回调

大纲

pg_listen conn notifyName ?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

如果提供,给出在收到匹配的通知时执行的命令字符串。

返回值

无

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.