<service_name>!SPCS_GET_METRICS¶

Gibt die Metriken zurück, die Snowflake für den angegebenen Dienst gesammelt hat. Weitere Informationen dazu finden Sie unter Auf Plattformmetriken zugreifen.

Bemerkung

Die Funktion wird nur für Services und Jobs unterstützt, die in Release 9.20 oder höher erstellt wurden.

Siehe auch:: Überwachen von Diensten

Syntax¶

<service_name>!SPCS_GET_METRICS(
    [ START_TIME => <constant_expr> ],
    [ END_TIME => <constant_expr> ] )

Copy

Argumente¶

START_TIME => constant_expr

Startzeit (im TIMESTAMP_LTZ-Format) für den Zeitbereich, aus dem Metriken abgerufen werden sollen. Verfügbare Funktionen zum Erstellen von Daten-, Zeit- und Zeitstempeldaten finden Sie unter Datums- und Uhrzeitfunktionen.

Wenn die START_TIME nicht angegeben ist, wird sie standardmäßig auf „Vor einem Tag“ eingestellt.

END_TIME => constant_expr

Endzeit (im TIMESTAMP_LTZ-Format) für den Zeitbereich, aus dem Metriken abgerufen werden sollen.

Wenn END_TIME nicht angegeben ist, wird standardmäßig der aktuelle Zeitstempel verwendet.

Ausgabe¶

Die Funktion gibt die folgenden Spalten zurück:

Spalte	Datentyp	Beschreibung
`TIMESTAMP`	TIMESTAMP_NTZ	Universal Coordinated Time (UTC)-Zeitstempel, zu dem Snowflake die Metrik erfasst hat.
`METRIC_NAME`	VARCHAR	Name der Kennzahl.
`VALUE`	VARCHAR	Wert der Metrik.
`UNIT`	VARCHAR	Einheit der zurückgegebenen Metrik.
`INSTANCE_ID`	NUMBER	Name der Dienstinstanz, wenn die Metrik mit der Dienstinstanz zusammenhängt.
`CONTAINER_NAME`	VARCHAR	Name des Containers, wenn die Metrik mit dem Container zusammenhängt. Eine Volume-Metrik hat zum Beispiel keinen Containernamen.
`RESOURCE`	VARCHAR	Hardware, z. B.GPU, die Gegenstand der Metrik ist. Diese Spalte ist nicht ausgefüllt.
`RECORD`	OBJECT	Schlüssel-Wert-Paare, die Metrikinformationen liefern.
`RECORD_ATTRIBUTES`	OBJECT	Schlüssel-Wert-Paare, die zusätzliche Informationen über die Metrik liefern.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung	Objekt	Anmerkungen
OWNERSHIP	Dienst

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

Es kann einige Minuten dauern, bis Metriken in der Ausgabe erscheinen.

Beispiele¶

Rufen Sie die Metriken ab, die Snowflake im Laufe des letzten Tages für den my_test_job-Job gesammelt hat; dies ist die Standardeinstellung.

SELECT * FROM TABLE(my_test_job!SPCS_GET_METRICS());

Copy

Rufen Sie die Metriken ab, die Snowflake im Laufe der letzten drei Tage für den my_test_job-Job gesammelt hat.

SELECT * from TABLE(my_test_job!SPCS_GET_METRICS(start_time => DATEADD('day', -3, CURRENT_TIMESTAMP())));

Copy

Rufen Sie die Metriken des letzten Tages für die spcs_get_metrics-Jobinstanz 0 in dem Container namens main ab.

SELECT * FROM TABLE(my_test_job!SPCS_GET_METRICS())
 WHERE instance_id = 0 AND container_name = 'main';

Copy