Vue TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

Aperçu

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

La vue INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER fournit les totaux d'utilisation du stockage quotidiens pour les 90 derniers jours pour les types de tables suivants.

• Tables standards
• Vues matérialisées
• Clones de tables ayant un delta en octets par rapport à la table de base
• Instantanés de tables ayant un delta en octets par rapport à la table de base

La vue INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER exclut les tables sans octets facturables. Les types de tables suivants sont exclus :

• Tables externes
• Tables anonymes
• Tables vides
• Clones de table n'ayant pas de delta en octets par rapport à la table de base
• Instantanés de tables n'ayant pas de delta en octets par rapport à la table de base

Lorsque vous interrogez la vue INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, les résultats de la requête contiennent une ligne par jour pour chaque table ou vue matérialisée du dossier parent du projet en cours, y compris ses sous-dossiers.

Les données de cette table ne sont pas disponibles en temps réel. Les données de la table mettent environ 72 heures à s'afficher dans cette vue.

La vue renvoie l'utilisation du stockage en Mio/s. Par exemple, si un projet utilise 1 000 000 d'octets physiques pendant 86 400 secondes (24 heures), l'utilisation physique totale est de 86 400 000 000 d'octets par seconde, ce qui est converti en 82 397 Mio/s, comme illustré dans l'exemple suivant :

86,400,000,000 / 1,024 / 1,024 = 82,397

La valeur d'utilisation du stockage se trouve dans la colonne BILLABLE_TOTAL_PHYSICAL_USAGE. Pour en savoir plus, consultez les détails des tarifs de stockage.

Remarque : Les données de cette vue ont une date de début au 1er octobre 2023. Vous pouvez interroger la vue pour des dates antérieures, mais les données renvoyées sont incomplètes.

Autorisations requises

Pour interroger la vue INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, vous devez disposer des autorisations IAM (Identity and Access Management) suivantes pour le dossier parent du projet :

• bigquery.tables.get
• bigquery.tables.list

Chacun des rôles IAM prédéfinis suivants inclut les autorisations ci-dessus :

• roles/bigquery.dataViewer
• roles/bigquery.dataEditor
• roles/bigquery.metadataViewer
• roles/bigquery.admin

Pour en savoir plus sur les autorisations BigQuery, consultez la section Rôles et autorisations IAM BigQuery.

Schéma

La vue INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER présente le schéma suivant :

Nom de la colonne	Type de données	Valeur
usage_date	DATE	Date de facturation pour les octets affichés, au fuseau horaire America/Los_Angeles
folder_numbers	REPEATED INTEGER	ID numérique des dossiers contenant le projet, en commençant par le dossier qui contient immédiatement contient le projet, suivi du dossier contenant le dossier enfant, et ainsi de suite. Par exemple, si FOLDER_NUMBERS est [1, 2, 3], le dossier 1 contient immédiatement le projet, le dossier 2 contient 1 et le dossier 3 contient 2. Cette colonne n'est renseignée que dans TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER.
project_id	STRING	ID du projet qui contient l'ensemble de données
table_catalog	STRING	ID du projet qui contient l'ensemble de données
project_number	INT64	Numéro du projet contenant l'ensemble de données
table_schema	STRING	Nom de l'ensemble de données contenant la table ou la vue matérialisée, également appelé datasetId
table_name	STRING	Nom de la table ou de la vue matérialisée, également appelé tableId
billable_total_logical_usage	INT64	Utilisation logique totale, en Mio/s. Renvoie 0 si l'ensemble de données utilise le modèle de facturation du stockage physique billing model.
billable_active_logical_usage	INT64	Utilisation logique datant de moins de 90 jours, en Mio /s. Renvoie 0 si l'ensemble de données utilise le modèle de facturation du stockage physique billing model.
billable_long_term_logical_usage	INT64	Utilisation logique datant de plus de 90 jours, en Mio s. Renvoie 0 si l'ensemble de données utilise le modèle de facturation du stockage physique billing model.
billable_total_physical_usage	INT64	Utilisation totale, en Mio/s. Cela inclut les octets physiques utilisés pour le stockage sécurisé et le stockage temporel. Renvoie 0 si l'ensemble de données utilise le modèle de facturation de stockage logique .
billable_active_physical_usage	INT64	Utilisation physique datant de moins de 90 jours, en Mio/s. Cela inclut les octets physiques utilisés pour le stockage sécurisé et le stockage temporel. Renvoie 0 si l'ensemble de données utilise le modèle de facturation de stockage logique .
billable_long_term_physical_usage	INT64	Utilisation physique datant de plus de 90 jours, en Mio/s. Renvoie 0 si l'ensemble de données utilise le modèle de facturation de stockage logique .

Pour plus de stabilité, nous vous recommandons de lister explicitement les colonnes dans vos requêtes de schéma d'informations au lieu d'utiliser un caractère générique (SELECT *). Cela empêche les requêtes de s'interrompre si le schéma sous-jacent change.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. Si vous ne spécifiez pas de qualificatif de région, les métadonnées sont extraites de toutes les régions. Le tableau suivant explique le champ d'application de la région pour cette vue :

Nom de la vue	Champ d'application de la ressource	Champ d'application de la région
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER	Dossier contenant le projet spécifié	REGION

Remplacez l'élément suivant :

• Facultatif : PROJECT_ID : ID de votre Google Cloud projet. Si non spécifié, le projet par défaut est utilisé.
• REGION : tout nom de région d'ensemble de données. Par exemple, `region-us`.
  Remarque : Vous devez utiliser un qualificatif de région pour interroger les vues INFORMATION_SCHEMA. L'emplacement d'exécution de la requête doit correspondre à la région de la INFORMATION_SCHEMA vue.

Pour récupérer les informations de stockage des tables du dossier parent du projet spécifié, exécutez la requête suivante :

SELECT * FROM `myProject`.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER;

Exemple

La requête suivante affiche l'utilisation de toutes les tables du dossier à la date la plus récente :

SELECT
  usage_date,
  project_id,
  table_schema,
  table_name,
  billable_total_logical_usage,
  billable_total_physical_usage
FROM
  (
    SELECT
      *,
      ROW_NUMBER()
        OVER (PARTITION BY project_id, table_schema, table_name ORDER BY usage_date DESC) AS rank
    FROM
      `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER
  )
WHERE rank = 1;

Le résultat ressemble à ce qui suit :

+--------------+------------+--------------+------------+------------------------------+-------------------------------+
| usage_date   | project_id | table_schema | table_name | billable_total_logical_usage | billable_total_physical_usage |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_x    |     734893409201             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_z    |     110070445455             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_y    |            0                 |         52500873256           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_t    |            0                 |         32513713981           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_m    |      8894535352              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_n    |      4183337201              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+