Kategorien:

Tabellenfunktionen

<service_name>!SPCS_GET_EVENTS

Gibt die Ereignisse zurück, die Snowflake für den angegebenen Dienst gesammelt hat. Weitere Informationen dazu finden Sie unter Auf Plattformereignisse 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_EVENTS(
  [ 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 Ereignisse 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 Überwachen von Diensten, wird sie standardmäßig auf „Vor einem Tag“ eingestellt.

END_TIME => constant_expr

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

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

Ausgabe

Spalte

Typ

Beschreibung

TIMESTAMP

TIMESTAMP_NTZ

Universal Coordinated Time (UTC)-Zeitstempel, zu dem Snowflake das Ereignis erfasst hat. Dieser Wert wird der TIMESTAMP-Spalte in der Ereignistabelle zugeordnet.

SEVERITY

VARCHAR

Schweregrad des Ereignisses. Dieser Wert wird dem Feld severity_text in der Spalte RECORD der Ereignistabelle zugeordnet.

EVENT_NAME

VARCHAR

Name des Ereignisses. Dieser Wert wird dem Feld name in der Spalte RECORD der Ereignistabelle zugeordnet.

EVENT_DETAILS

OBJECT

Details zu dem Ereignis. Dieser Wert wird der VALUE-Spalte in der Ereignistabelle zugeordnet.

INSTANCE_ID

NUMBER

Bezeichner der Dienstinstanz, wenn das Ereignis mit einer Dienstinstanz zusammenhängt. Dieser Wert wird dem Feld snow.service.instance in der Spalte RESOURCE_ATTRIBUTES der Ereignistabelle zugeordnet.

CONTAINER_NAME

VARCHAR

Name des Containers, wenn das Ereignis mit einem Container zusammenhängt. Dieser Wert wird dem Feld snow.service.container.name in der Spalte RESOURCE_ATTRIBUTES der Ereignistabelle zugeordnet.

RECORD

OBJECT

Ereignisinformationen im JSON-Format. Dieser Wert wird der RECORD-Spalte in der Ereignistabelle zugeordnet.

RECORD_ATTRIBUTES

OBJECT

Zusätzliche Informationen über das Ereignis. Dieser Wert wird der RECORD_ATTRIBUTES-Spalte in der Ereignistabelle zugeordnet.

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

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

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 Ereignisse in der Ausgabe angezeigt werden.

Beispiele

Rufen Sie die Ereignisse ab, die Snowflake im Laufe des vergangenen Tages für den my_test_job-Job erfasst hat.

SELECT * FROM TABLE(my_test_job!SPCS_GET_EVENTS());
Copy

Beispielausgabe:

+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+
| TIMESTAMP               | SEVERITY | EVENT_NAME              | EVENT_DETAILS                          | INSTANCE_ID | CONTAINER_NAME | RECORD                               | RECORD_ATTRIBUTES |
|-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------|
| 2025-06-26 00:23:40.933 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Completed successfully", |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "DONE"                     |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:35.919 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Running",                |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "READY"                    |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:34.127 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Waiting to start",       |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "PENDING"                  |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+

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

SELECT * FROM TABLE(my_test_job!SPCS_GET_EVENTS(START_TIME => DATEADD('day', -3, CURRENT_TIMESTAMP())));
Copy
Sprache: Deutsch