Catégories :

Schéma d’information, 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.

Voir aussi :

WAREHOUSE_METERING_HISTORY

Syntaxe

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

Arguments

Tous les arguments sont facultatifs.

DATE_RANGE_START => expr_constante , . DATE_RANGE_END => expr_constante

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 => 'chaîne'

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.

Sortie

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)

Nombre moyen de requêtes exécutées.

AVG_QUEUED_LOAD

NUMBER(38,2)

Nombre moyen de requêtes en file d’attente parce que l’entrepôt était surchargé.

AVG_QUEUED_PROVISIONING

NUMBER(38,2)

Nombre moyen de requêtes mises en file d’attente parce que l’entrepôt était provisionné.

AVG_BLOCKED

NUMBER(38,2)

Nombre moyen de 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())));

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()));