UNLISTEN
説明
UNLISTENを使用して、既存の NOTIFY イベントの登録を削除します。
UNLISTEN は現在の PostgreSQL セッションにある、通知条件 name 用のリスナ登録を全て取り消します。
ワイルドカード*は特別な条件を示すもので、現在のセッションにある全てのリスナ登録を取り消します。
NOTIFYには、LISTEN と NOTIFY についての、より広範な説明があります。
パラメータ
- 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 コマンドはありません。