Catégories :

Fonctions de table

REST_EVENT_HISTORY

Renvoie une liste de requêtes API REST SCIM adressées à Snowflake sur un intervalle de temps spécifié.

Syntaxe

REST_EVENT_HISTORY(
      REST_SERVICE_TYPE => 'scim'
      [, TIME_RANGE_START => <constant_expr> ]
      [, TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ] )
Copy

Arguments

Obligatoire :

REST_SERVICE_TYPE => 'scim'

Le type de service API REST. Actuellement, Snowflake accepte uniquement SCIM.

Facultatif :

{} => <constant_expr>, . {} => <constant_expr>

Plage de temps (au format TIMESTAMP_LTZ), dans les 7 derniers jours durant lesquels l’événement de connexion s’est produit.

  • Si {} n’est pas spécifié, tous les journaux des sept derniers jours sont renvoyés.

  • Si {} n’est pas spécifié, tous les journaux sont renvoyés.

Si l’intervalle de temps ne tombe pas dans les 7 derniers jours, une erreur est renvoyée.

Pour plus d’informations sur les fonctions que vous pouvez utiliser, voir Fonctions de date et d’heure.

RESULT_LIMIT => <integer>

Un nombre spécifiant le nombre maximum de lignes renvoyé par la fonction.

Si le nombre de lignes correspondantes est supérieur à cette limite, les requêtes avec l’heure de fin la plus récente (ou celles qui sont toujours en cours d’exécution) sont renvoyées, jusqu’à la limite spécifiée.

Plage : de 1 à 10000

Par défaut : 100.

Notes sur l’utilisation

  • Actuellement, la fonction de table REST_EVENT_HISTORY ne peut être utilisée qu’avec SCIM.

  • Seuls les administrateurs de compte (c’est-à-dire les utilisateurs dotés du rôle ACCOUNTADMIN) peuvent obtenir des résultats de requête.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

EVENT_TIMESTAMP

TIMESTAMP_LTZ

Heure de l’occurrence de l’événement.

EVENT_ID

NUMBER

L’identificateur unique de la demande.

EVENT_TYPE

TEXT

La catégorie d’événements API REST. Actuellement, SCIM est la seule valeur possible.

ENDPOINT

TEXT

Le point de terminaison de la demande API (par exemple scim/v2/Users/<id>).

METHOD

TEXT

La méthode HTTP utilisée dans la demande.

STATUS

TEXT

Le résultat du statut HTTP de la demande.

ERROR_CODE

TEXT

Code d’erreur si la demande n’a pas abouti.

DETAILS

TEXT

Une description du résultat de la demande API au format JSON.

CLIENT_IP

TEXT

L’adresse IP d’où provient la demande.

ACTOR_NAME

TEXT

Le nom de l’acteur qui fait la demande.

ACTOR_DOMAIN

TEXT

Le domaine (c’est-à-dire l’intégration de sécurité) dans lequel la demande a été effectuée.

RESOURCE_NAME

TEXT

Le nom de l’objet faisant la demande.

RESOURCE_DOMAIN

TEXT

Le type d’objet (par exemple l’utilisateur) qui fait la demande.

Exemples

Renvoyer les demandes API REST SCIM effectuées au cours des cinq dernières minutes, jusqu’à 200 demandes.

use role accountadmin;
use database my_db;
use schema information_schema;
select *
  from table(rest_event_history(
      rest_service_type => 'scim',
      time_range_start => dateadd('minutes',-5,current_timestamp()),
      time_range_end => current_timestamp(),
      200))
  order by event_timestamp;
Copy