PostgreSQL: Das Offizielle Handbuch
Zurück	Schnell zurück		Schnell nach vorne	Nach vorne

UNLISTEN

Name

UNLISTEN -- beendet das Hören auf eine Benachrichtigung

Synopsis

UNLISTEN { name | * }

Beschreibung

UNLISTEN wird verwendet um eine bestehende Registrierung für NOTIFY-Ereignisse zu löschen. UNLISTEN storniert alle bestehenden Registrierungen der aktuellen PostgreSQL-Sitzung für die Benachrichtigung name. Wenn als Name * angegeben wurde, dann werden alle Registrierungen der aktuellen Sitzung gelöscht.

NOTIFY enthält einer ausführlichere Beschreibung der Verwendung der Befehle LISTEN und NOTIFY.

Parameter

name: Der Name einer Benachrichtigung (ein beliebiger SQL-Bezeichner).
*: Löscht alle Registrierungen dieser Sitzung.

Meldungen

UNLISTEN: Meldung, wenn der Befehl ausgeführt wurde.

Hinweise

Sie können eine Registrierung für einen Namen auch löschen, wenn er gar nicht registriert war. Dabei wird keine Warnung und kein Fehler ausgegeben.

Am Ende jeder Sitzung wird automatisch UNLISTEN * ausgeführt.

Beispiele

So wird eine Registrierung erzeugt und verwendet:

LISTEN virtual;
NOTIFY virtual;
Asynchronous NOTIFY 'virtual' from backend with pid '8448' received

Nachdem UNLISTEN ausgeführt wurde, werden darauf folgende NOTIFY-Befehle ignoriert:

UNLISTEN virtual;
NOTIFY virtual;
-- kein NOTIFY-Ereignis wird empfangen

Kompatibilität

Der Befehl UNLISTEN ist eine PostgreSQL-Erweiterung.

Zurück	Zum Anfang	Nach vorne
TRUNCATE	Nach oben	UPDATE