Schémas :

ACCOUNT_USAGE, READER_ACCOUNT_USAGE

Vue QUERY_HISTORY

Cette vue Account Usage peut être utilisée pour interroger l’historique des requêtes Snowflake selon différentes dimensions (plage de temps, session, utilisateur, entrepôt, etc.) au cours des 365 derniers jours (1 an).

La vue est disponible dans les schémas ACCOUNT_USAGE et READER_ACCOUNT_USAGE avec les différences suivantes :

  • La colonne suivante est disponible uniquement dans la vue du compte de lecteur :

    • READER_ACCOUNT_NAME

  • Les colonnes suivantes ne sont pas fournies dans la vue du compte de lecteur :

    • CLUSTER_NUMBER

    • BYTES_SCANNED

    • ROWS_PRODUCED

    • OUTBOUND_DATA_TRANSFER_CLOUD

    • INBOUND_DATA_TRANSFER_CLOUD

    • INBOUND_DATA_TRANSFER_REGION

    • INBOUND_DATA_TRANSFER_BYTES

Voir aussi :

QUERY_HISTORY , QUERY_HISTORY_BY_* (fonction de table d’Information Schema)

Colonnes

Nom de la colonne

Type de données

Description

READER_ACCOUNT_NAME

TEXT

Nom du compte de lecteur dans lequel l’instruction SQL a été exécutée.

QUERY_ID

TEXT

Identificateur interne / généré par le système pour l’instruction SQL.

QUERY_TEXT

TEXT

Texte de l’instruction SQL.

DATABASE_ID

NUMBER

Identificateur interne/généré par le système pour la base de données utilisée.

DATABASE_NAME

TEXT

Base de données en cours d’utilisation au moment de la requête.

SCHEMA_ID

NUMBER

Identificateur interne / généré par le système pour le schéma utilisé.

SCHEMA_NAME

TEXT

Schéma en cours d’utilisation au moment de la requête.

QUERY_TYPE

TEXT

DML, requête, etc. Si la requête est en cours d’exécution ou a échoué, le type de requête peut être UNKNOWN.

SESSION_ID

NUMBER

Session qui a exécuté l’instruction.

USER_NAME

TEXT

Utilisateur qui a émis la requête.

ROLE_NAME

TEXT

Rôle actif dans la session au moment de la requête.

WAREHOUSE_ID

NUMBER

Identificateur interne / généré par le système pour l’entrepôt utilisé.

WAREHOUSE_NAME

TEXT

Entrepôt sur lequel la requête a été exécutée, le cas échéant.

WAREHOUSE_SIZE

TEXT

Taille de l’entrepôt lorsque cette instruction est exécutée.

WAREHOUSE_TYPE

TEXT

Type de l’entrepôt lorsque cette instruction est exécutée.

CLUSTER_NUMBER

NUMBER

Le cluster (dans un entrepôt multi-cluster) sur lequel cette instruction a été exécutée.

QUERY_TAG

TEXT

Balise de requête définie pour cette instruction via le paramètre de session QUERY_TAG.

EXECUTION_STATUS

TEXT

Statut d’exécution de la requête : succès, échec, incident.

ERROR_CODE

NUMBER

Code d’erreur, si la requête a renvoyé une erreur

ERROR_MESSAGE

TEXT

Message d’erreur si la requête a renvoyé une erreur

START_TIME

TIMESTAMP_LTZ

Heure de début de l’instruction (dans le fuseau horaire UTC)

END_TIME

TIMESTAMP_LTZ

Heure de fin de l’instruction (fuseau horaire UTC) ou NULL si l’instruction est toujours en cours d’exécution.

TOTAL_ELAPSED_TIME

NUMBER

Temps écoulé (en millisecondes).

BYTES_SCANNED

NUMBER

Nombre d’octets analysés par cette instruction.

PERCENTAGE_SCANNED_FROM_CACHE

FLOAT

Pourcentage de données analysées à partir du cache du disque local.

BYTES_WRITTEN

NUMBER

Octets écrits (par exemple, lors du chargement dans une table).

BYTES_WRITTEN_TO_RESULT

NUMBER

Octets écrits dans un objet de résultat.

BYTES_READ_FROM_RESULT

NUMBER

Octets lus à partir d’un objet de résultat.

ROWS_PRODUCED

NUMBER

Nombre de lignes produites par cette instruction.

ROWS_INSERTED 1

NUMBER

Nombre de lignes insérées par la requête.

ROWS_UPDATED 1

NUMBER

Nombre de lignes mises à jour par la requête.

ROWS_DELETED 1

NUMBER

Nombre de lignes supprimées par la requête.

ROWS_UNLOADED 1

NUMBER

Nombre de lignes déchargées lors de l’exportation des données.

BYTES_DELETED 1

NUMBER

Nombre d’octets supprimés par la requête.

PARTITIONS_SCANNED

NUMBER

Nombre de micro-partitions analysées.

PARTITIONS_TOTAL

NUMBER

Nombre total de micro-partitions de toutes les tables incluses dans cette requête.

BYTES_SPILLED_TO_LOCAL_STORAGE

NUMBER

Volume de données déversées sur le disque local (« spill to disk »).

BYTES_SPILLED_TO_REMOTE_STORAGE

NUMBER

Volume de données déversées sur le disque distant (« spill to disk »).

BYTES_SENT_OVER_THE_NETWORK

NUMBER

Quantité de données envoyées sur le réseau.

COMPILATION_TIME

NUMBER

Temps de compilation (en millisecondes)

EXECUTION_TIME

NUMBER

Temps d’exécution (en millisecondes)

QUEUED_PROVISIONING_TIME

NUMBER

Temps (en millisecondes) passé dans la file d’attente de l’entrepôt à attendre que les serveurs de l’entrepôt soient provisionnés en raison de la création, de la reprise ou du redimensionnement de l’entrepôt.

QUEUED_REPAIR_TIME

NUMBER

Temps (en millisecondes) passé dans la file d’attente de l’entrepôt à attendre que les serveurs de l’entrepôt soient réparés.

QUEUED_OVERLOAD_TIME

NUMBER

Temps (en millisecondes) passé dans la file d’attente d’entrepôt en raison de la surcharge de l’entrepôt par la charge de la requête actuelle.

TRANSACTION_BLOCKED_TIME

NUMBER

Temps (en millisecondes) passé à être bloquée par un DML simultané.

OUTBOUND_DATA_TRANSFER_CLOUD

TEXT

Fournisseur Cloud cible pour les instructions qui déchargent des données vers une autre région et/ou un autre Cloud.

OUTBOUND_DATA_TRANSFER_REGION

TEXT

Région cible pour les instructions qui déchargent des données dans une autre région et / ou cloud.

OUTBOUND_DATA_TRANSFER_BYTES

NUMBER

Nombre d’octets transférés dans les instructions qui déchargent des données vers une autre région et/ou un autre Cloud.

INBOUND_DATA_TRANSFER_CLOUD

TEXT

Fournisseur de Cloud source pour les instructions qui chargent des données provenant d’une autre région et/ou d’un Cloud.

INBOUND_DATA_TRANSFER_REGION

TEXT

Région source pour les instructions qui chargent des données d’une autre région et/ou d’un autre Cloud.

INBOUND_DATA_TRANSFER_BYTES

NUMBER

Nombre d’octets transférés dans des instructions qui chargent des données d’une autre région et/ou d’un autre Cloud.

LIST_EXTERNAL_FILES_TIME

NUMBER

Temps (en millisecondes) consacré à la liste des fichiers externes.

CREDITS_USED_CLOUD_SERVICES

NUMBER

Nombre de crédits utilisés pour les services Cloud dans l’heure.

RELEASE_VERSION

NUMBER

Version de publication au format version_majeure.version_mineure.version_correctif.

EXTERNAL_FUNCTION_TOTAL_INVOCATIONS

NUMBER

Nombre total de fois que cette requête a appelé des services distants. Pour des détails importants, voir les notes d’utilisation.

EXTERNAL_FUNCTION_TOTAL_SENT_ROWS

NUMBER

Nombre total de lignes envoyées par cette requête dans tous les appels à tous les services distants.

EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS

NUMBER

Nombre total de lignes que cette requête a reçues de tous les appels vers tous les services distants.

EXTERNAL_FUNCTION_TOTAL_SENT_BYTES

NUMBER

Nombre total d’octets que cette requête a envoyés dans tous les appels à tous les services distants.

EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES

NUMBER

Nombre total d’octets que cette requête a reçus de tous les appels vers tous les services distants.

QUERY_LOAD_PERCENT

NUMBER

Pourcentage de charge que cette requête a placé sur l’entrepôt.

1(1,2,3,4,5)

Ces champs affichent des données uniquement pour les requêtes exécutées à partir du 18 janvier 2020.

Notes sur l’utilisation

  • La latence pour la vue peut atteindre 45 minutes.

  • 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).