- Kategorien:
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>' ] )
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). WennDATE_RANGE_END
beispielsweise den Wert CURRENT_DATE hat, ist der Standardwert fürDATE_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'));
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)));
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));
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'));