Man page - listen(7)

Manual

LISTEN

NAME
SYNOPSIS
DESCRIPTION 描 述
PARAMETERS 参 数
EXAMPLES 例 子
COMPATIBILITY 兼 容 性
SEE ALSO 参 见
译 者
跋

---

NAME

LISTEN - 监 听 一 个 通 知

SYNOPSIS

LISTEN name

DESCRIPTION 描 述

LISTEN 将 当 前 会 话 注 册 为 通 知 条 件 name

当 执 行 了 命 令 NOTIFY name 后 ， 不 管 是 此 会 话 还 是 其 他 联 接 到 同 一 数 据 库 的 会 话 执 行 的 ， 所 有 正 在 监 听 此 通 知 条 件 的 会 话 都 将 收 到 通 知 ， 并 且 接 下 来 每 个 会 话 将 通 知 与 其 相 连 的 前 端 应 用 ． 请 参 考 NOTIFY 获 取 更 多 信 息 ．

使 用 UNLISTEN 命 令 ， 可 以 将 一 个 会 话 内 已 注 册 的 通 知 条 件 删 除 ． 同 样 ， 会 话 退 出 时 自 动 删 除 该 会 话 正 在 监 听 的 已 注 册 通 知 条 件 ．

前 端 应 用 检 测 通 知 事 件 的 方 法 取 决 于 PostgreSQL 应 用 使 用 的 编 程 接 口 ． 如 果 使 用 基 本 的 libpq库 ， 应 用 将 LISTEN 当 作 普 通 SQL 命 令 使 用 ， 而 且 必 须 周 期 地 调 用 PQnotifies 过 程 来 检 测 是 否 有 通 知 到 达 ． 其 他 像 libpgtcl接 口 提 供 了 更 高 级 的 控 制 通 知 事 件 的 方 法 ； 实 际 上 ， 使 用 libpgtcl， 应 用 程 序 员 不 应 该 直 接 使 用 LISTEN 或 UNLISTEN． 请 参 考 你 使 用 的 接 口 的 文 档 获 取 更 多 细 节 ．

NOTIFY [ notify (7)] 的 手 册 页 包 含 更 广 泛 的 关 于 LISTEN 和 NOTIFY 的 使 用 的 讨 论 ．

PARAMETERS 参 数

name

通 知 条 件 名 (任 何 标 识 符 )。

EXAMPLES 例 子

在 psql 里 配 制 和 执 行 一 个 监 听 /通 知 序 列 ：

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

COMPATIBILITY 兼 容 性

在 SQL 标 准 里 没 有 LISTEN

SEE ALSO 参 见

NOTIFY [ notify (7)], UNLISTEN [ unlisten (l)]

译 者

Postgresql 中 文 网 站 何 伟 平 <laser@pgsqldb.org>

跋

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。
中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh

---