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> , <TIME_RANGE_START> , <TIME_RANGE_END> , <RESULT_LIMIT> )

Arguments

REST_SERVICE_TYPE

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

TIME_RANGE_START

L’horodatage de début. Pour plus d’informations sur les fonctions pouvant être utilisées, voir Fonctions de date et d’heure.

TIME_RANGE_END

L’horodatage de fin. Pour plus d’informations sur les fonctions pouvant être utilisées, voir Fonctions de date et d’heure.

RESULT_LIMIT

Un nombre spécifiant le nombre maximum de lignes renvoyées 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.

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 requête n’a pas abouti.

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(
      'scim',
      dateadd('minutes',-5,current_timestamp()),
      current_timestamp(),
      200))
  order by event_timestamp;