Catégories :

Information Schema , Fonctions de table

DATABASE_STORAGE_USAGE_HISTORY

Cette fonction de table peut être utilisée pour interroger l’utilisation quotidienne moyenne de stockage, en octets, pour une seule base de données (ou toutes les bases de données de votre compte) au sein d’une plage de dates donnée. Les résultats incluent :

  • Toutes les données stockées dans les tables de la ou des bases de données.

  • Toutes les données historiques conservées dans Fail-safe pour la ou les bases de données.

Note

Cette fonction renvoie l’utilisation de l’espace de stockage au cours des 6 derniers mois.

Voir aussi :

STAGE_STORAGE_USAGE_HISTORY , WAREHOUSE_METERING_HISTORY

Syntaxe

DATABASE_STORAGE_USAGE_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ]
      [, DATABASE_NAME => '<string>' ] )
Copy

Arguments

Tous les arguments sont facultatifs.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

La plage de dates, au cours des 6 derniers mois, pour laquelle il est possible de récupérer l’utilisation du stockage de la base de données :

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

DATABASE_NAME => 'string'

Le nom de la base de données pour récupérer l’historique d’utilisation du stockage. Notez que le nom de la base de données doit être entre guillemets simples. De plus, si le nom de base de données 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 DB"' vs 'mydb').

Si aucune base de données n’est spécifiée, les données sont renvoyées pour toutes les bases de données de votre compte.

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.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

USAGE_DATE

DATE

Date de cet enregistrement d’utilisation de l’espace de stockage

DATABASE_NAME

TEXT

Nom de la base de données

AVERAGE_DATABASE_BYTES

NUMBER

Nombre d’octets utilisés pour le stockage de base de données

AVERAGE_FAILSAFE_BYTES

NUMBER

Nombre d’octets utilisés pour le stockage Fail-safe

Si une base de données a été supprimée et que la période de conservation des données est écoulée (c’est-à-dire que la base de données ne peut pas être récupérée à l’aide de Time Travel), le nom de la base de données est indiqué par DROPPED_id, où id est un identificateur généré en interne. Cet ID peut être utilisé pour faire correspondre les entrées au niveau des lignes renvoyées par la fonction de table.

Exemples

Récupérez l’utilisation quotidienne moyenne de stockage pour les 10 derniers jours, par base de données, pour toutes les bases de données de votre compte :

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