UNLISTEN <refpurpose>stop listening for a notification</refpurpose> — 通知の監視を停止する
UNLISTEN { channel | * }
<command>UNLISTEN</command> is used to remove an existing
registration for <command>NOTIFY</command> events.
<command>UNLISTEN</command> cancels any existing registration of
the current <productname>PostgreSQL</productname> session as a
listener on the notification channel named <replaceable
class="parameter">channel</replaceable>. The special wildcard
<literal>*</literal> cancels all listener registrations for the
current session.
UNLISTENを使うと、既存のNOTIFYイベントの登録を削除することができます。
UNLISTENは、現在のPostgreSQLセッションにある、nameという名前の通知チャネルのリスナ登録を取り消します。
ワイルドカード*を指定すると、現在のセッションにある全てのリスナ登録が取り消されます。
<xref linkend="sql-notify"/>
contains a more extensive
discussion of the use of <command>LISTEN</command> and
<command>NOTIFY</command>.
NOTIFYには、LISTENとNOTIFYについてのより広範な説明があります。
channelName of a notification channel (any identifier). 通知チャネルの名称です（任意の識別子）。
*All current listen registrations for this session are cleared. このセッションにおける、全ての監視登録をクリアします。
You can unlisten something you were not listening for; no warning or error will appear. 監視を行っていない通知チャネルに対してもこのコマンドは実行できます。 警告やエラーは表示されません。
At the end of each session, <command>UNLISTEN *</command> is
automatically executed.
セッション終了時に、自動的にUNLISTEN *が実行されます。
A transaction that has executed <command>UNLISTEN</command> cannot be
prepared for two-phase commit.
UNLISTENを実行したトランザクションは二相コミット用を準備することはできません。
To make a registration: 登録を行います。
LISTEN virtual; NOTIFY virtual; Asynchronous notification "virtual" received from server process with PID 8448.
Once <command>UNLISTEN</command> has been executed, further <command>NOTIFY</command>
messages will be ignored:
UNLISTENが実行されると、その後のNOTIFYメッセージは無視されます。
UNLISTEN virtual;
NOTIFY virtual;
-- no NOTIFY event is received
-- NOTIFYイベントを受け取りません。
There is no <command>UNLISTEN</command> command in the SQL standard.
標準SQLにはUNLISTENコマンドはありません。