Kategorien:

Tabellenfunktionen

REST_EVENT_HISTORY

Gibt eine Liste von SCIM-REST-API-Anforderungen zurück, die in einem bestimmten Zeitintervall an Snowflake gesendet wurden.

Syntax

REST_EVENT_HISTORY( <REST_SERVICE_TYPE> , <TIME_RANGE_START> , <TIME_RANGE_END> , <RESULT_LIMIT> )

Argumente

REST_SERVICE_TYPE

Der Typ des REST-API-Dienstes. Snowflake unterstützt derzeit ausschließlich SCIM.

TIME_RANGE_START

Der Startzeitstempel. Weitere Informationen zu verfügbaren Funktionen finden Sie unter Datums- und Uhrzeitfunktionen.

TIME_RANGE_END

Der Endzeitstempel. Weitere Informationen zu verfügbaren Funktionen finden Sie unter Datums- und Uhrzeitfunktionen.

RESULT_LIMIT

Eine Zahl, die die maximale Anzahl der von der Funktion zurückgegebenen Zeilen angibt:

Wenn die Anzahl der übereinstimmenden Zeilen größer als dieser Grenzwert ist, werden die Abfragen mit der jüngsten Endzeit (oder Abfragen, die noch ausgeführt werden) zurückgegeben – bis zum angegebenen Grenzwert.

Bereich: 1 bis 10000

Standard: 100.

Nutzungshinweise

  • Derzeit kann die Tabellenfunktion REST_EVENT_HISTORY nur mit SCIM verwendet werden.

  • Nur Kontoadministratoren (d. h. Benutzer mit der Rolle ACCOUNTADMIN) können Abfrageergebnisse erhalten.

Ausgabe

Die Funktion gibt die folgenden Spalten zurück:

Spaltenname

Datentyp

Beschreibung

EVENT_TIMESTAMP

TIMESTAMP_LTZ

Zeitpunkt des Auftretens des Ereignisses.

EVENT_ID

NUMBER

Der eindeutige Bezeichner der Anforderung.

EVENT_TYPE

TEXT

Die REST-API-Ereigniskategorie. Derzeit ist SCIM der einzig mögliche Wert.

METHOD

TEXT

Die in der Anforderung verwendete HTTP-Methode.

STATUS

TEXT

Das HTTP-Statusergebnis der Anforderung.

ERROR_CODE

TEXT

Fehlercode, wenn die Anfrage nicht erfolgreich war.

CLIENT_IP

TEXT

IP-Adresse, von der die Anfrage stammt.

ACTOR_NAME

TEXT

Der Name des Akteurs, der die Anfrage gestellt hat.

ACTOR_DOMAIN

TEXT

Die Domäne (d. h. Sicherheitsintegration), in der die Anforderung gestellt wurde.

RESOURCE_NAME

TEXT

Der Name des Objekts, das die Anforderung gestellt hat.

RESOURCE_DOMAIN

TEXT

Der Objekttyp (z. B. Benutzer), der die Anforderung gestellt hat.

Beispiele

Geben Sie die in den letzten fünf Minuten gestellten SCIM-REST-API-Anforderungen zurück. Es sind bis zu 200 Anforderungen möglich.

use role accountadmin;
use database my_db:
use schema information_schema;
select *
  from table(rest_event_history(
      'scim',
      dateadd('minutes',-5,current_timestamp()),
      current_timestamp(),
      200))
  order by event_timestamp;