Catégories :

Information Schema , Fonctions de table

WAREHOUSE_METERING_HISTORY

Cette fonction de table peut être utilisée dans des requêtes pour retourner l’utilisation horaire des crédits pour un seul entrepôt virtuel (ou tous les entrepôts de votre compte) sur une période donnée.

Note

Cette fonction renvoie l’utilisation du crédit au cours des 6 derniers mois.

Voir aussi :

WAREHOUSE_LOAD_HISTORY

Syntaxe

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

Arguments

Obligatoire :

DATE_RANGE_START => constant_expr

Date de début, au cours des 6 derniers mois, pour laquelle l’utilisation de l’entrepôt virtuel est retournée.

Facultatif :

DATE_RANGE_END => constant_expr

Date de fin, au cours des 6 derniers mois, pour laquelle l’utilisation de l’entrepôt virtuel est retournée.

Par défaut : CURRENT_DATE est utilisé.

WAREHOUSE_NAME => 'string'

Nom de l’entrepôt virtuel pour lequel récupérer l’utilisation du crédit. Notez que le nom de l’entrepôt doit être entre guillemets simples. De plus, si le nom de l’entrepôt comporte des espaces, des caractères en majuscules ou en minuscules ou des caractères spéciaux, le nom doit être délimité par des guillemets doubles dans des guillemets simples (par exemple, '"My Warehouse"' vs 'mywarehouse').

Par défaut : tous les entrepôts virtuels qui ont fonctionné pendant la période spécifiée.

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.

  • L’ordre et la structure des arguments dépendent de l’inclusion ou non des mots clés de l’argument (par ex. DATE_RANGE_START) :

    • Les mots clés ne sont pas nécessaires si les arguments sont spécifiés dans l’ordre.

    • Si les mots clés de l’argument sont inclus, les arguments peuvent être spécifiés dans n’importe quel ordre.

Sortie

La fonction renvoie les colonnes suivantes, classées par WAREHOUSE_NAME et START_TIME :

Nom de la colonne

Type de données

Description

START_TIME

TIMESTAMP_LTZ

Début de l’heure à laquelle cette utilisation de l’entrepôt virtuel a eu lieu.

END_TIME

TIMESTAMP_LTZ

Fin de l’heure à laquelle cette utilisation de l’entrepôt virtuel a eu lieu.

WAREHOUSE_NAME

TEXT

Nom de l’entrepôt.

CREDITS_USED

NUMBER

Nombre de crédits facturés pour cet entrepôt virtuel dans cette heure.

CREDITS_USED_COMPUTE

NUMBER

Nombre de crédits utilisés pour l’entrepôt dans l’heure.

CREDITS_USED_CLOUD_SERVICES

NUMBER

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

Exemples

Récupérer l’utilisation horaire de l’entrepôt virtuel au cours des 10 derniers jours pour tous les entrepôts virtuels qui ont fonctionné pendant cette période :

select *
from table(information_schema.warehouse_metering_history(dateadd('days',-10,current_date())));
Copy

Récupérer l’utilisation horaire de l’entrepôt virtuel pour l’entrepôt virtuel testingwh à une date spécifiée :

select *
from table(information_schema.warehouse_metering_history('2017-10-23', '2017-10-23', 'testingwh'));
Copy
Langage: Français