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

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

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本PostgreSQL 8.3 已于 2013 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

LISTEN

LISTEN — 监听通知

大纲

LISTEN name

描述

LISTEN将当前会话注册为通知条件name的监听者。 如果当前会话已经在该通知条件上注册为监听者,则不会执行任何操作。

每当命令NOTIFY name被执行时,无论是由当前会话 还是由另一个连接到同一数据库的会话执行,所有当前正在监听该通知条件的 会话都会收到通知,而每个会话随后都会通知其所连接的客户端应用。有关更多信息,请参见对NOTIFY的讨论。

会话可以使用UNLISTEN命令取消在给定通知条件上的监听注册。 会话结束时,其监听注册会被自动清除。

客户端应用必须采用何种方法来检测通知事件,取决于它所使用的 PostgreSQL应用程序编程接口。使用 libpq库时,应用程序将LISTEN 作为普通 SQL 命令发出,然后必须定期调用 PQnotifies函数,以判断是否已经收到任何通知事件。 其他接口,例如libpgtcl,则提供了处理通知事件的 更高层方法;事实上,在libpgtcl中,应用程序员 甚至不应直接发出LISTEN或UNLISTEN。 详见所使用接口的相关文档。

NOTIFY中对LISTEN和NOTIFY的使用有更详细的讨论。

参数

name

通知条件的名称(任意标识符)。

示例

在psql中配置并执行一组 listen/notify 操作:

LISTEN virtual;
NOTIFY virtual;
Asynchronous notification "virtual" received from server process with PID 8448.

兼容性

SQL 标准中没有LISTEN语句。

另见

NOTIFY, UNLISTEN

提交更正

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