# UNLISTEN ## Name UNLISTEN?--?停止監聽通知信息 ## Synopsis ``` UNLISTEN { _channel_ | * } ``` ## 描述 `UNLISTEN`用于刪除一個現有的已注冊`NOTIFY`事件。 `UNLISTEN`取消當前PostgreSQL 會話中所有對通知通道名為`_channel_`的監聽。 特殊的條件通配符`*`取消對當前會話的所有監聽。 [NOTIFY](#calibre_link-982)包含一些對`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`命令。 ## 又見 [LISTEN](#calibre_link-983), [NOTIFY](#calibre_link-982)