UNLISTEN — 通知の監視を停止する
UNLISTEN { channel
| * }
UNLISTEN
を使うと、既存のNOTIFY
イベントの登録を削除することができます。
UNLISTEN
は、現在のPostgreSQLセッションにある、name
という名前の通知チャネルのリスナ登録を取り消します。
ワイルドカード*
を指定すると、現在のセッションにある全てのリスナ登録が取り消されます。
NOTIFYには、LISTEN
とNOTIFY
についてのより広範な説明があります。
channel
通知チャネルの名称です(任意の識別子)。
*
このセッションにおける、全ての監視登録をクリアします。
監視を行っていない通知チャネルに対してもこのコマンドは実行できます。 警告やエラーは表示されません。
セッション終了時に、自動的に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
コマンドはありません。