pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
LISTEN — 监听一个通知
LISTEN name
LISTEN把当前会话注册为通知条件name的监听者。 如果当前会话已经被注册为该通知条件的监听者,则不做任何事。
每当命令NOTIFY 被调用时——无论是 被本会话还是被连接到同一数据库的其他会话调用——所有当前 正在监听该通知条件的会话都会被通知,而每个会话又将进而 通知它所连接的客户端应用。更多信息请参阅 nameNOTIFY的讨论。
可以用UNLISTEN命令取消一个会话对给定 通知条件的注册。会话的监听注册在该会话结束时被自动清除。
客户端应用检测通知事件所必须使用的方法取决于它使用的 PostgreSQL应用编程接口。使用 libpq库时,应用像发出普通 SQL 命令一样发出 LISTEN,然后必须周期性地调用函数 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语句。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。