Catégories :

Schéma d’information, Fonctions de table

STAGE_STORAGE_USAGE_HISTORY

Cette fonction de table peut être utilisée pour interroger l’utilisation moyenne quotidienne du stockage de données, en octets, pour toutes les zones de préparation Snowflake de votre compte dans une plage de dates spécifiée. La sortie comprendra un stockage pour :

  • les zones de préparation internes nommées.

  • les zones d’échelonnage par défaut (pour les tables et les utilisateurs).

Note

Cette fonction renvoie l’utilisation du stockage de la zone de préparation au cours des 6 derniers mois.

Voir aussi :

DATABASE_STORAGE_USAGE_HISTORY , WAREHOUSE_METERING_HISTORY

Syntaxe

STAGE_STORAGE_USAGE_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ] )

Arguments

Tous les arguments sont facultatifs.

DATE_RANGE_START => expr_constante , . DATE_RANGE_END => expr_constante

La plage de dates, au cours des 6 derniers mois, pour laquelle vous souhaitez récupérer l’utilisation du stockage de la zone de préparation :

  • 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, DATE_RANGE_END est utilisée comme date de début de plage (c’est-à-dire que la valeur par défaut est un jour d’utilisation du stockage).

Si la plage se situe en dehors des 6 derniers mois, une erreur est renvoyé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.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

USAGE_DATE

DATE

Date (dans le fuseau horaire UTC) de cet enregistrement d’utilisation du stockage

AVERAGE_STAGE_BYTES

NUMBER

Nombre d’octets de stockage utilisés par la zone de préparation

Exemples

Récupérez l’utilisation moyenne quotidienne de l’espace de stockage des 10 derniers jours pour toutes les zones de préparation internes de votre compte :

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