# LISTEN ## Name LISTEN?--?監聽一個通知 ## Synopsis ``` LISTEN _channel_ ``` ## 描述 `LISTEN`將當前會話注冊為通知通道`_channel_`的監聽器。 如果當前會話已經被注冊為該通知通道的監聽器，那么什么也不做。 當執行了命令`NOTIFY` `_channel_` 后，不管是此會話還是其它連接到同一數據庫的會話，所有正在監聽此通知通道的會話都將收到通知， 并且接下來每個會話將通知與其相連的前端應用。 使用`UNLISTEN`命令可以將一個會話內已注冊的通知通道刪除。同樣， 會話退出時自動刪除該會話正在監聽的已注冊通知通道。 前端應用檢測通知事件的方法取決于PostgreSQL應用使用的編程接口。 如果使用基本的libpq庫，那么應用將`LISTEN`當作普通 SQL 命令使用， 而且必須周期地調用`PQnotifies`過程來檢測是否有通知到達。 其它像libpgtcl接口提供了更高級的控制通知事件的方法；實際上， 使用libpgtcl的應用程序員不應該直接使用`LISTEN`或`UNLISTEN`。 請參考你使用的接口的文檔獲取更多細節。 [NOTIFY](#calibre_link-982)的手冊頁包含更廣泛的關于`LISTEN` 和`NOTIFY`的使用的討論。 ## 參數 `_channel_` 通知通道的名字，可以是任意標識符。 ## 注意 `LISTEN`在事務提交時生效。如果`LISTEN`或 `UNLISTEN`在一個稍后回滾的事務中執行，那么被監聽的通知通道的設置不會改變。 一個已經執行了`LISTEN`的事務不能準備兩階段提交。 ## 例子 在psql里配制和執行一個監聽/通知序列： ``` LISTEN virtual; NOTIFY virtual; Asynchronous notification "virtual" received from server process with PID 8448. ``` ## 兼容性 SQL 標準里沒有`LISTEN`語句。 ## 又見 [NOTIFY](#calibre_link-982), [UNLISTEN](#calibre_link-975)