Catégories :

Information Schema , Fonctions de table

WAREHOUSE_LOAD_HISTORY

Cette fonction de table peut être utilisée pour interroger l’historique des activités (définies comme « chargement de requête ») pour un seul entrepôt virtuel au sein d’une plage de dates spécifiée.

Note

Cette fonction renvoie l’activité de l’entrepôt au cours des 14 derniers jours.

Note

La spécification d’une valeur de date qui se situe à moins d’une minute de l’horodatage actuel peut produire des résultats inexacts.

Voir aussi :

WAREHOUSE_METERING_HISTORY

Syntaxe

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

Arguments

Tous les arguments sont facultatifs.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

La plage de dates, dans les 14 derniers jours, pour laquelle il est possible de récupérer les données de l’historique de charge de l’entrepôt :

  • Si aucune date de fin n’est spécifiée, CURRENT_DATE est utilisée comme date de fin de plage.

  • Si aucune date de début n’est spécifiée, la plage commence 10 minutes avant le début de DATE_RANGE_END (c’est-à-dire que la valeur par défaut est d’afficher les 10 minutes précédentes de l’historique de charge). Par exemple, si DATE_RANGE_END est CURRENT_DATE, alors le DATE_RANGE_START par défaut est 11h50 PM le jour précédent .

Si la plage tombe en dehors des 15 derniers jours, une erreur est renvoyée.

Note

Si la période sélectionnée est inférieure à 8 heures, la charge est affichée par intervalles de 5 secondes ; sinon, des intervalles de 5 minutes sont utilisés.

WAREHOUSE_NAME => 'string'

Le nom de l’entrepôt pour lequel vous souhaitez récupérer l’historique de la charge d’utilisation. 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

Notes sur l’utilisation

  • Pour obtenir des résultats à partir de cette fonction, l’un des rôles ou privilèges suivants est requis :

    • Le rôle ACCOUNTADMIN peut obtenir des résultats avec cette fonction, car il dispose de toutes les autorisations de compte globales.

    • Un rôle doté du privilège global MONITOR USAGE sur ACCOUNT peut interroger cette fonction pour n’importe quel entrepôt du compte.

    • Un rôle doté du privilège MONITOR sur WAREHOUSE peut interroger cette fonction pour l’entrepôt pour lequel il dispose d’autorisations.

    • Un rôle doté du privilège OWNERSHIP sur WAREHOUSE dispose de toutes les autorisations sur l’entrepôt, y compris MONITOR.

    Pour plus de détails, voir Privilèges de contrôle d’accès.

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

Sortie

Note

Pour les colonnes de sortie de cette fonction, la valeur de la charge de la requête est le rapport entre le temps d’exécution total (en secondes) de toutes les requêtes dans un état spécifique dans un intervalle et le temps total (en secondes) pour cet intervalle.

Par exemple, si « 276 secondes » était le temps total pour 4 requêtes dans un intervalle de 5 minutes (300 secondes), alors la valeur de la charge de requête est 276 / 300 = 0,92.

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

START_TIME

TIMESTAMP_LTZ

Début de l’intervalle de temps spécifié (dans le fuseau horaire UTC) dans lequel l’utilisation de l’entrepôt a eu lieu.

END_TIME

TIMESTAMP_LTZ

Fin de l’intervalle de temps spécifié (dans le fuseau horaire UTC) dans lequel l’utilisation de l’entrepôt a eu lieu.

WAREHOUSE_NAME

TEXT

Nom de l’entrepôt.

AVG_RUNNING

NUMBER(38,2)

Interrogez la valeur de charge des requêtes exécutées.

AVG_QUEUED_LOAD

NUMBER(38,2)

Interrogez la valeur de charge des requêtes mises en file d’attente parce que l’entrepôt était surchargé.

AVG_QUEUED_PROVISIONING

NUMBER(38,2)

Interrogez la valeur de charge des requêtes mises en attente parce que l’entrepôt était en cours de mise en service.

AVG_BLOCKED

NUMBER(38,2)

Interrogez la valeur de charge des requêtes bloquées par un verrou de transaction.

Exemples

Récupérez l’historique de charge de la dernière heure, par intervalles de 5 secondes, pour l’entrepôt actuellement utilisé pour votre session :

use warehouse mywarehouse;

select *
from table(information_schema.warehouse_load_history(date_range_start=>dateadd('hour',-1,current_timestamp())));
Copy

Récupérez l’historique de chargement des 14 derniers jours, par intervalles de 5 minutes, pour l’entrepôt actuellement utilisé pour votre session :

use warehouse mywarehouse;

select *
from table(information_schema.warehouse_load_history(date_range_start=>dateadd('day',-14,current_date()), date_range_end=>current_date()));
Copy
Langage: Français