Kategorien:

Information Schema, Tabellenfunktionen

SERVERLESS_ALERT_HISTORY

Diese Tabellenunktion dient zur Abfrage des Nuztungsverlaufs der serverlosen Benachrichtigung. Die von der Funktion zurückgegebenen Informationen umfassen den Namen der Benachrichtigung und die durch die Ausführung der einzelnen Benachrichtigungen verbrauchten Credits.

Syntax

SERVERLESS_ALERT_HISTORY(
  [ DATE_RANGE_START => <constant_expr> ]
  [ , DATE_RANGE_END => <constant_expr> ]
  [ , ALERT_NAME => '<string>' ] )
Copy

Argumente

Alle Argumente sind optional.

DATE_RANGE_START => constant_expr, . DATE_RANGE_END => constant_expr

Der Zeitbereich (Datum/Uhrzeit) des Nutzungsfensters:

  • Wenn kein Enddatum angegeben ist, wird CURRENT_DATE als Ende des Bereichs verwendet.

  • Wenn kein Startdatum angegeben wird, beginnt der Bereich 10 Minuten vor dem Start von DATE_RANGE_END (d. h. standardmäßig werden die letzten 10 Minuten des Verlaufs angezeigt). Wenn DATE_RANGE_END beispielsweise den Wert CURRENT_DATE hat, ist der Standardwert für DATE_RANGE_START 23:50 Uhr des vorherigen Tages.

ALERT_NAME => string

Der Name der Benachrichtigung, für die der Nutzungsverlauf abgerufen werden soll. Es werden nur die Nutzungsdaten für die angegebene Benachrichtigung zurückgegeben.

Beachten Sie, dass der Benachrichtigungsname in einfache Anführungszeichen gesetzt werden muss. Wenn der Benachrichtigungsname Leerzeichen, Groß- und Kleinbuchstaben oder Sonderzeichen enthält, muss der Name außerdem innerhalb der einfachen Anführungszeichen in doppelte Anführungszeichen gesetzt werden (z. B. '"My Alert"' vs. 'myalert').

Nutzungshinweise

  • Die Tabellenfunktion liefert nur Ergebnisse für die Rolle ACCOUNTADMIN oder für jede Rolle, der explizit die globale Berechtigung MONITOR USAGE erteilt wurde.

    Bemerkung

    Eine Rolle mit der Berechtigung MONITOR USAGE kann die Credit-Nutzung pro Objekt anzeigen, jedoch keine Objektnamen.

  • Beim Aufruf 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.

  • Der Verlauf wird in Schritten von 1 Stunde angezeigt.

Ausgabe

Die Funktion gibt die folgenden Spalten zurück:

Spaltenname

Datentyp

Beschreibung

START_TIME

TIMESTAMP_LTZ

Beginn des angegebenen Zeitbereichs.

END_TIME

TIMESTAMP_LTZ

Ende des angegebenen Zeitbereichs.

ALERT_NAME

TEXT

Name des Alerts.

CREDITS_USED

TEXT

Anzahl der Credits, die für die serverlose Benachrichtigung während des START_TIME- und END_TIME-Zeitfensters abgerechnet werden.

Beispiele

Rufen Sie für Ihr Konto den Nutzungsverlauf für einen Bereich von einer Stunde ab:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>'2024-10-08 19:00:00.000 -0700',
    DATE_RANGE_END=>'2024-10-08 20:00:00.000 -0700'));
Copy

Beispielausgabe:

+-------------------------------+-------------------------------+------------+--------------+
| START_TIME                    | END_TIME                      | ALERT_NAME | CREDITS_USED |
|-------------------------------+-------------------------------+------------+--------------|
| 2024-10-08 04:16:22.000 -0700 | 2024-10-08 05:16:22.000 -0700 | A1         |  0.000286714 |
| 2024-10-08 05:16:22.000 -0700 | 2024-10-08 06:16:22.000 -0700 | A1         |  0.007001568 |
+-------------------------------+-------------------------------+------------+--------------+

Rufen Sie den Verlauf der letzten 12 Stunden für Ihr Konto ab:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(H, -12, CURRENT_TIMESTAMP)));
Copy

Rufen Sie den Verlauf der letzten Woche für Ihr Konto ab:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(D, -7, CURRENT_DATE),
    DATE_RANGE_END=>CURRENT_DATE));
Copy

Rufen Sie den Nutzungsverlauf der letzten Woche für eine bestimmte Benachrichtigung in Ihrem Konto ab:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(D, -7, CURRENT_DATE),
    DATE_RANGE_END=>CURRENT_DATE,
    ALERT_NAME=>'my_database.my_schema.my_alert'));
Copy