UNLISTEN

名前

UNLISTEN -- 通知の監視を停止する

概要

UNLISTEN { name | * }

説明

UNLISTENを使うと、既存のNOTIFYイベントの登録を削除することができます。 UNLISTENは、現在のPostgreSQLセッションにある、name通知条件用のリスナ登録を全て取り消します。 ワイルドカード*は特別な条件を表します。これを指定すると、現在のセッションにある全てのリスナ登録が取り消されます。

NOTIFYには、LISTENNOTIFYについてのより広範な説明があります。

パラメータ

name

通知名です(任意の識別子)。

*

このセッションにおける、全ての監視登録をクリアします。

注釈

監視をまったく行っていない状態でもこのコマンドは実行できます。警告やエラーは表示されません。

セッション終了時に、自動的に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