NOTIFICATION_HISTORY-Tabellenfunktion: Änderungen der Ausgabe

Achtung

Diese Verhaltensänderung ist in Bundle 2024_04 enthalten.

Den aktuellen Status des Bundles finden Sie unter Bundle-Verlauf.

Die Funktion NOTIFICATION_HISTORY ändert sich, um folgende Informationen bereitzustellen:

  • Benachrichtigungen, die noch nicht bearbeitet wurden.

  • Versuche, Benachrichtigungen zu senden, die zunächst fehlgeschlagen sind und nun erneut versucht werden.

In den nächsten Abschnitten wird erläutert, wie sich diese Änderungen auf die Ausgabe der Funktion auswirken:

Änderungen an der zurückgegebenen Zeilenanzahl

Die Anzahl der Zeilen, die von der Funktion zurückgegeben werden, ändert sich:

Vor der Änderung:

Diese Funktion gibt eine Zeile für jede bearbeitete Benachrichtigung zurück (Benachrichtigungen, die entweder versendet wurden oder fehlgeschlagen sind).

Wenn mehrere Versuche unternommen wurden, eine Benachrichtigung zu senden, gibt die Funktion eine Zeile für den zuletzt unternommenen Versuch zurück.

Nach der Änderung:

Diese Funktion liefert eine Zeile für jeden Versuch, eine Benachrichtigung zu senden. Der Wert in der Spalte STATUS zeigt den Status des Versuchs an:

  • Wenn der Versuch fehlgeschlagen ist, aber erneut versucht werden kann, lautet der Wert RETRIABLE_FAILURE.

  • Wenn der Versuch fehlgeschlagen ist und nicht erneut versucht werden kann, lautet der Wert FAILURE.

  • Wenn der Versuch erfolgreich war, lautet der Wert SUCCESS.

Außerdem gibt die Funktion eine Zeile für jede Meldung zurück, die noch nicht bearbeitet wurde (Meldungen, die in der Warteschlange stehen).

Neue Spalten in der Ausgabe

Wenn dieses Verhaltensänderungs-Bundle aktiviert ist, enthält die Ausgabe der NOTIFICATION_HISTORY-Funktion die folgenden neuen Spalten:

Spaltenname

Datentyp

Beschreibung

ID

VARCHAR

Eindeutige ID einer Anfrage zum Senden einer Benachrichtigung.

Wenn Snowflake eine Benachrichtigung nicht senden kann und erneut versucht, die Benachrichtigung zu senden, gibt die Funktion für jeden Versuch eine Zeile zurück. Jede Zeile für einen Versuch hat den gleichen Wert in der Spalte ID, aber einen anderen Wert in der Spalte ATTEMPT.

ATTEMPT

INTEGER

Anzahl der Versuche, die Benachrichtigung zu senden.

MESSAGE_SOURCE_INFO

OBJECT

Objekt mit Informationen über die Quelle der Benachrichtigung. Die Felder in diesem Objekt hängen vom Typ der Quelle ab:

  • Bei Fehlerbenachrichtigungen zu Aufgaben enthält das Objekt die folgenden Felder:

    • name: Name der Aufgabe.

    • graph_run_group_id: Bezeichner der Task-Graph-Ausführung.

    • attempt_number: Ganzzahl, die die Anzahl der Versuche angibt, diese Aufgabe auszuführen.

  • Bei Fehlerbenachrichtigungen zu Snowpipe enthält das Objekt das Feld pipe_name, das den Namen der Pipe angibt.

  • Bei Benachrichtigungen, die durch den Aufruf der gespeicherten Prozedur SYSTEM$SEND_EMAIL gesendet werden, enthält das Objekt das Feld query_id, das die ID der Anweisung angibt, die die gespeicherte Prozedur aufgerufen hat.

Abkündigung der Spalte MESSAGE

Die Spalte MESSAGE ist veraltet und wird in Zukunft entfernt werden.

Ref.: 1593

Sprache: Deutsch