Catégories :

Information Schema , Fonctions de table

QUERY_ACCELERATION_HISTORY

La fonction QUERY_ACCELERATION_HISTORY est utilisée pour interroger l’historique du service d’accélération des requêtes dans une plage de dates spécifiée. Les informations renvoyées comprennent les crédits utilisés pour le service d’accélération des requêtes au niveau de l’entrepôt pour une période donnée.

Syntaxe

QUERY_ACCELERATION_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ]
      [ , WAREHOUSE_NAME => '<string>' ] )
Copy

Paramètres

Tous les arguments sont facultatifs.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

La plage de dates/heures pour afficher l’historique d’accélération des requêtes.

Par exemple, si vous spécifiez que la date de début est 2019-05-03 et que la date de fin est 2019-05-05, vous obtiendrez des données pour les 3, 4 et 5 mai. (Les points de terminaison sont inclus.)

  • Si ni date de début, ni date de fin n’est spécifiée, la valeur par défaut correspondra aux 12 dernières heures.

  • Si aucune date de fin n’est spécifiée, mais si une date de début est spécifiée, alors CURRENT_DATE à minuit est utilisée comme date de fin de plage.

  • Si aucune date de début n’est spécifiée, mais qu’une date de fin est spécifiée, la plage commence 12 heures avant le début de DATE_RANGE_END.

WAREHOUSE_NAME => string

Nom de l’entrepôt. Si spécifié, affiche uniquement l’historique de l’entrepôt spécifié.

Si un nom d’entrepôt n’est pas spécifié, les résultats comprendront l’historique de chaque entrepôt utilisant le service d’accélération des requêtes.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

START_TIME

TIMESTAMP_LTZ

Début de la période spécifiée pendant laquelle le service a été utilisé.

END_TIME

TIMESTAMP_LTZ

Fin de la période spécifiée pendant laquelle le service a été utilisé.

CREDITS_USED

NUMBER

Nombre de crédits utilisés par le service.

WAREHOUSE_NAME

TEXT

Nom de l’entrepôt où l’utilisation a eu lieu.

NUM_FILES_SCANNED

NUMBER

Nombre de fichiers analysés par le service.

NUM_BYTES_SCANNED

NUMBER

Nombre d’octets analysés par le service.

Notes sur l’utilisation

  • Renvoie les résultats uniquement pour le rôle ACCOUNTADMIN ou tout rôle auquel le privilège global MONITOR USAGE a été explicitement accordé.

  • Lors de l’appel d’une fonction de la table de schémas d’informations, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou le nom de la fonction doit être complètement qualifié. Pour plus de détails, voir Schéma d’information de Snowflake.