QUERY_HISTORY , QUERY_HISTORY_BY_*¶

Syntaxe¶

QUERY_HISTORY(
      [ END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ]
      [, INCLUDE_CLIENT_GENERATED_STATEMENT => <boolean_expr> ] )

QUERY_HISTORY_BY_SESSION(
      [ SESSION_ID => <constant_expr> ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ]
      [, INCLUDE_CLIENT_GENERATED_STATEMENT => <boolean_expr> ] )

QUERY_HISTORY_BY_USER(
      [ USER_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ]
      [, INCLUDE_CLIENT_GENERATED_STATEMENT => <boolean_expr> ] )

QUERY_HISTORY_BY_WAREHOUSE(
      [ WAREHOUSE_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ]
      [, INCLUDE_CLIENT_GENERATED_STATEMENT => <boolean_expr> ] )

Arguments¶

Tous les arguments sont facultatifs.

END_TIME_RANGE_START => constant_expr , . END_TIME_RANGE_END => constant_expr

Intervalle de temps (au format TIMESTAMP_LTZ), au cours des 7 derniers jours, pendant lequel la requête a été exécutée :

• Si END_TIME_RANGE_END n’est pas spécifié, la fonction renvoie toutes les requêtes, y compris celles qui sont toujours en cours d’exécution.

• Si END_TIME_RANGE_END est CURRENT_TIMESTAMP, la fonction renvoie uniquement les requêtes terminées.

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

Note

Si aucune heure de début ou de fin n’est spécifiée, les requêtes les plus récentes sont renvoyées, jusqu’à la limite spécifiée.

SESSION_ID => constant_expr

S’applique uniquement à QUERY_HISTORY_BY_SESSION

L’identificateur numérique d’une session ou CURRENT_SESSION Seules les requêtes de la session spécifiée sont renvoyées.

Par défaut : CURRENT_SESSION

USER_NAME => 'string'

S’applique uniquement à QUERY_HISTORY_BY_USER

Une chaîne de caractères spécifiant un nom d’utilisateur ou CURRENT_USER Seules les requêtes exécutées par l’utilisateur spécifié sont renvoyées. Notez que le nom d’utilisateur doit être entre guillemets simples. De plus, si le nom de connexion contient des espaces, des caractères en majuscules et minuscules ou des caractères spéciaux, le nom doit être entre guillemets doubles à l’intérieur des guillemets simples (p. ex. '"User 1"' vs 'user1'). Vous ne pouvez pas spécifier SYSTEM (USER_NAME =>'SYSTEM'), qui est un service d’arrière-plan plutôt qu’un utilisateur. Toutefois, vous pouvez filtrer sur user_name='SYSTEM' lorsque vous exécutez des requêtes sur les fonctions de table QUERY_HISTORY.

Par défaut : CURRENT_USER

WAREHOUSE_NAME => 'string'

S’applique uniquement à QUERY_HISTORY_BY_WAREHOUSE

Une chaîne spécifiant un nom d’entrepôt ou CURRENT_WAREHOUSE. Seules les requêtes exécutées par cet entrepôt sont renvoyées. Notez que le nom de l’entrepôt doit être entre guillemets simples. De plus, si le nom de l’entrepôt contient des espaces, des caractères en majuscules et minuscules ou des caractères spéciaux, le nom doit être entre guillemets doubles à l’intérieur des guillemets simples (p. ex. '"My Warehouse"' vs 'mywarehouse').

Par défaut : CURRENT_WAREHOUSE

RESULT_LIMIT => num

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.

INCLUDE_CLIENT_GENERATED_STATEMENT => 'boolean_expr'

Indique si les instructions générées par le client sont incluses dans les requêtes de fonctions de table (compte tenu de la valeur de la colonne is_client_generated_statement).

Par défaut : FALSE.

Le site ACCOUNT_USAGE Vue QUERY_HISTORY contient également une colonne is_client_generated_statement, mais les requêtes portant sur cette vue renvoient toutes les instructions, qu’elles soient ou non générées par le client. Si nécessaire, vous pouvez filtrer le résultat de la requête.

Notes sur l’utilisation¶

• Renvoie les requêtes exécutées par l’utilisateur actuel. Retourne également les requêtes exécutées par n’importe quel utilisateur lorsque le rôle d’exécution, ou un rôle supérieur dans une hiérarchie, dispose de l’un ou l’autre des privilèges suivants :

  • Le privilège MONITOR ou OPERATE sur les entrepôts gérés par l’utilisateur où les requêtes ont été exécutées.

  • Le privilège MONITOR ou OPERATE sur la tâche. Exception : si la tâche exécute une procédure stockée de droit propriétaire ou UDF, le rôle requiert au moins le privilège MONITOR sur l’entrepôt sur lequel la tâche s’est exécutée pour voir la requête de la procédure stockée et la requête UDF.

  • Le privilège MONITOR EXECUTION sur le compte dans lequel réside la tâche.

  • Exceptions : ni les procédures stockées ni les fonctions définies par l’utilisateur (UDFs) ne peuvent exécuter cette requête.

  Pour plus d’informations, voir Privilèges de l’entrepôt virtuel.

• Lorsque vous appelez une fonction de table Information Schema, la session doit utiliser le INFORMATION_SCHEMA ou le nom de la fonction doit être entièrement qualifié. Pour plus d’informations, voir Schéma d’information de Snowflake.

• Les valeurs des colonnes external_function_total_invocations, external_function_total_sent_rows, external_function_total_received_rows, external_function_total_sent_bytes et external_function_total_received_bytes sont affectées par de nombreux facteurs, notamment :

  • Le nombre de fonctions externes dans l’instruction SQL.

  • Le nombre de lignes par lot envoyées à chaque service distant.

  • Le nombre de tentatives en raison d’erreurs transitoires (par exemple, parce qu’une réponse n’a pas été reçue dans le délai prévu).

• Les requêtes annulées sont identifiées par leur texte error_message (SQL execution canceled) et non par leur valeur execution_status.

Sortie¶

La fonction renvoie les colonnes suivantes :

Les valeurs potentielles de la colonne query_type comprennent :

• CREATE_USER

• CREATE_ROLE

• CREATE_NETWORK_POLICY

• ALTER_ROLE

• ALTER_NETWORK_POLICY

• ALTER_ACCOUNT

• DROP_SEQUENCE

• DROP_USER

• DROP_ROLE

• DROP_NETWORK_POLICY

• RENAME_NETWORK_POLICY

• REVOKE

Exemples¶

Récupère au maximum les 100 dernières requêtes exécutées dans la session en cours :

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY_BY_SESSION())
  ORDER BY start_time;

Récupère au maximum les 100 dernières requêtes exécutées par l’utilisateur actuel (ou par chaque utilisateur d’un entrepôt pour lequel l’utilisateur actuel a le privilège MONITOR) :

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY())
  ORDER BY start_time;

Récupère au maximum les 100 dernières requêtes exécutées au cours de l’heure écoulée par l’utilisateur actuel (ou exécutées par chaque utilisateur sur chaque entrepôt pour lequel l’utilisateur actuel a le privilège MONITOR) :

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY(DATEADD('hours',-1,CURRENT_TIMESTAMP()),CURRENT_TIMESTAMP()))
  ORDER BY start_time;

Récupère toutes les requêtes exécutées par l’utilisateur actuel (ou exécutées par chaque utilisateur sur chaque entrepôt pour lequel l’utilisateur actuel a le privilège MONITOR) dans un bloc de 30 minutes spécifié durant les 7 derniers jours :

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY(
    END_TIME_RANGE_START=>TO_TIMESTAMP_LTZ('2017-12-4 12:00:00.000 -0700'),
    END_TIME_RANGE_END=>TO_TIMESTAMP_LTZ('2017-12-4 12:30:00.000 -0700')));

Récupère le nombre d’instructions générées par le client qui ont été exécutées sur un entrepôt nommé my_xsmall_wh :

SELECT COUNT(*)
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY_BY_WAREHOUSE(
    WAREHOUSE_NAME => 'my_xsmall_wh',
    INCLUDE_CLIENT_GENERATED_STATEMENT => TRUE));