UNLISTEN

Name

UNLISTEN -- 停止監聽通知訊息

Synopsis

UNLISTEN { name | * }

描述

UNLISTEN 用於刪除一個現有的已註冊的 NOTIFY 事件。 UNLISTEN 取消目前 PostgreSQL 會話中的所有對通知條件 notifyname 監聽。 特殊的條件通配符 * 則取消對目前會話的所有通知條件的監聽。

NOTIFY 包含一些對 LISTENNOTIFY 的使用的更廣泛的討論。

參數

name

通知條件名稱(任意標識符)。

*

所有此後端目前正在監聽的註冊都將被清除。

注意

如果您 UNLISTEN 一個您沒有監聽的事件,後端不會報錯。

每個後端在退出時都會自動執行 UNLISTEN *

例子

註冊一個:

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

一旦執行了 UNLISTEN,以後的 NOTIFY 命令將被忽略:

UNLISTEN virtual;
NOTIFY virtual;
-- 收不到 NOTIFY 事件

相容性

SQL 標準裡沒有 UNLISTEN

又見

LISTEN, NOTIFY