LISTEN — 通知を監視する
LISTEN channel
LISTEN
は現在のセッションを、通知チャネルchannel
のリスナとして登録します。
現在のセッションが既に指定した通知チャネルのリスナとして登録されている場合は、何も起こりません。
このセッションまたは同一データベースに接続している別のセッションによってNOTIFY
が実行されると、現在その通知チャネルを監視している全てのセッションに対して通知されます。
次に、各セッションは接続中のクライアントアプリケーションにこれを通知します。
channel
UNLISTEN
コマンドを使って、セッションに登録された指定通知チャネルを解除できます。
また、セッションの監視登録はそのセッションが終了した時点で自動的に削除されます。
クライアントアプリケーションが通知イベントを検出する方法は、使用しているPostgreSQLアプリケーションプログラミングインタフェースに依存します。
libpqライブラリを使用するアプリケーションでは、LISTEN
を通常のSQLコマンドとして発行し、その後、PQnotifies
ルーチンを定期的に呼び出して通知イベントが受信されたかどうかを調べる必要があります。
libpgtcl等の他のインタフェースには、通知イベントを扱うより高レベルな方法が用意されています。
実際、libpgtclを使ったアプリケーションの場合、プログラマがLISTEN
やUNLISTEN
を直接発行する必要すらありません。
詳細については、使用中のインタフェースのドキュメントを参照してください。
NOTIFYには、LISTEN
およびNOTIFY
についてのより広範な説明があります。
channel
通知チャネルの名前です(任意の識別子)。
LISTEN
はトランザクションのコミット時に有効になります。
LISTEN
またはUNLISTEN
がトランザクション内で実行され、それがロールバックされた場合、監視している通知チャネルの集合は変更されません。
LISTEN
を実行したトランザクションでは二相コミットの準備を行うことはできません。
psqlから、監視/通知処理の設定と実行を行います。
LISTEN virtual; NOTIFY virtual; Asynchronous notification "virtual" received from server process with PID 8448.
標準SQLにLISTEN
はありません。