↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

不受支持的版本: 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本PostgreSQL 7.4 已于 2010 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本手册首页。

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

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

返回值

无

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。