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