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