PostgreSQL 8.0.0 文書
前のページ | 巻戻し |  | 早送り | 次のページ

# UNLISTEN

## 名前

UNLISTEN -- 通知の監視の停止

## 概要

    UNLISTEN { name | * }

## 説明

`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` コマンドはありません。

## 関連項目

LISTEN, NOTIFY

前のページ | ホーム | 次のページ
TRUNCATE | 上に戻る | UPDATE