ALERT_HISTORY¶

Syntax¶

ALERT_HISTORY(
      [ SCHEDULED_TIME_RANGE_START => <constant_expr> ]
      [, SCHEDULED_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ]
      [, ALERT_NAME => '<string>' ] )

Argumente¶

Alle Argumente sind optional.

SCHEDULED_TIME_RANGE_START => constant_expr, . SCHEDULED_TIME_RANGE_END => constant_expr

Zeitbereich (im TIMESTAMP_LTZ-Format) innerhalb der letzten 7 Tage, in dem die Auswertung der Bedingung für den Alert geplant war.

• Wenn SCHEDULED_TIME_RANGE_END nicht angegeben ist, gibt die Funktion die Alerts zurück, die bereits abgeschlossen wurden, die gerade ausgeführt werden und die in Zukunft geplant sind.

• Wenn SCHEDULED_TIME_RANGE_END den Wert CURRENT_TIMESTAMP hat, gibt die Funktion die Alerts zurück, die bereits abgeschlossen wurden und die gerade ausgeführt werden. Beachten Sie, dass ein Alert, der unmittelbar vor dem aktuellen Zeitpunkt gestartet wurde, möglicherweise noch als geplant identifiziert wird.

Bemerkung

Wenn keine Start- oder Endzeit angegeben ist, werden die letzten Alerts bis zum angegebenen RESULT_LIMIT-Wert zurückgegeben.

Wenn der Zeitbereich nicht in den letzten 7 Tagen liegt, wird ein Fehler zurückgegeben.

RESULT_LIMIT => integer

Eine Zahl, die die maximale Anzahl von Zeilen angibt, die von der Funktion zurückgegeben werden.

Wenn die Anzahl der übereinstimmenden Zeilen größer ist als dieser Grenzwert, werden die Alert-Ausführungen sortiert nach Zeitstempel (neuester zuerst) bis zum angegebenen Grenzwert zurückgegeben.

Bereich: 1 bis 10000

Standard: 100.

ALERT_NAME => string

Eine Zeichenfolge, bei der die Groß-/Kleinschreibung nicht berücksichtigt wird und die einen Alert angibt. Es werden nur nicht qualifizierte Alert-Namen unterstützt. Es werden nur Ausführungen des angegebenen Alerts zurückgegeben. Wenn mehrere Alerts denselben Namen haben, gibt die Funktion den Verlauf für jeden dieser Alerts zurück.

Nutzungshinweise¶

• Gibt nur Ergebnisse für die Rolle ACCOUNTADMIN oder den Eigentümer des Alerts zurück (d. h. die Rolle mit der Berechtigung OWNERSHIP für den Alert).

• Diese Funktion gibt maximal 10.000 Zeilen zurück. Der Wert wird im Argument RESULT_LIMIT festgelegt. Der Standardwert ist 100.

  Beachten Sie, dass bei der Abfrage der Funktion ALERT_HISTORY die Argumente Alert-Name, Zeitbereich und Ergebnislimit zuerst angewendet werden und erst danach, falls angegeben, die Klauseln WHERE und LIMIT. Darüber hinaus gibt die Funktion ALERT_HISTORY Datensätze in absteigender Reihenfolge gemäß SCHEDULED_TIME-Wert zurück. Abgeschlossene Alerts (d. h. mit Status SUCCEEDED, FAILED oder CANCELLED) werden in der Regel früher geplant, sodass sie in der Regel später in der Reihenfolge der Suchergebnisse zurückgegeben werden.

  Wenn in der Praxis viele Alerts in Ihrem Konto ausgeführt werden, könnten die von der Funktion zurückgegebenen Ergebnisse weniger abgeschlossene Alerts als erwartet oder nur geplante Alerts enthalten, insbesondere wenn der RESULT_LIMIT-Wert relativ niedrig ist. Zur Abfrage des Verlaufs von bereits ausgeführten Alerts empfiehlt Snowflake eine Kombination der Argumente SCHEDULED_TIME_RANGE_START => constant_expr und/oder SCHEDULED_TIME_RANGE_END => constant_expr.

• Beim Aufrufen einer Tabellenfunktion des Information Schema muss die Sitzung über ein aktives INFORMATION_SCHEMA-Schema verfügen oder der Funktionsname muss vollqualifiziert sein. Weitere Details dazu finden Sie unter Snowflake Information Schema.

• Diese Funktion kann alle Ausführungen zurückgeben, die in den letzten 7 Tagen ausgeführt wurden, oder die nächste geplante Ausführung innerhalb der nächsten 8 Tage.

Ausgabe¶

Mit der Tabellenfunktion ALERT_HISTORY wird eine Zeile für jede Alert-Ausführung erstellt. Jede Zeile enthält die folgenden Spalten:

Beispiele¶

Siehe Überwachen der Ausführung von Alerts.