Vue TABLE_STORAGE_TIMELINE_BY_ORGANIZATION

La vue INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION fournit les totaux quotidiens d'utilisation du stockage au cours des 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

Les tables qui n'ont pas d'octets facturables ne sont pas incluses dans la vue INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION. Cela inclut les types de tables suivants :

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_ORGANIZATION, les résultats de la requête contiennent une ligne par jour pour chaque table ou vue matérialisée dans l'ensemble de l'organisation associée au projet en cours.

Les données de cette table ne sont pas disponibles en temps réel. Il faut environ 72 heures pour que les données de la table soient reflétées dans cette vue.

L'utilisation de l'espace de stockage est renvoyée en Mo/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 Mo/s, comme illustré dans l'exemple suivant :

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

Il s'agit de la valeur qui serait renvoyée par la colonne BILLABLE_TOTAL_PHYSICAL_USAGE.

Pour en savoir plus, consultez les détails des tarifs de stockage.

Autorisations requises

Pour interroger la vue INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION, vous avez besoin des autorisations IAM (Identity and Access Management) suivantes pour votre organisation :

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

Cette vue du schéma n'est disponible que pour les utilisateurs associés à des organisations Google Cloud définies.

Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

Schéma

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

`USAGE_DATE`	`DATE`	Date de facturation pour les octets affichés
`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 Mo. Renvoie 0 si l'ensemble de données utilise le modèle de facturation du stockage physique.
`BILLABLE_ACTIVE_LOGICAL_USAGE`	`INT64`	Utilisation logique datant de moins de 90 jours, en Mo/s. Renvoie 0 si l'ensemble de données utilise le modèle de facturation du stockage physique.
`BILLABLE_LONG_TERM_LOGICAL_USAGE`	`INT64`	Utilisation logique datant de plus de 90 jours, en Mo/s. Renvoie 0 si l'ensemble de données utilise le modèle de facturation du stockage physique.
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	Utilisation totale, en Mo/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 Mo/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 Mo/s. Renvoie 0 si l'ensemble de données utilise le modèle de facturation de stockage logique.

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_ORGANIZATION	Organisation contenant le projet spécifié	`REGION`

Remplacez les éléments suivants :

Facultatif : PROJECT_ID : ID de votre projet Google Cloud. Si non spécifié, le projet par défaut est utilisé.

+ REGION : nom de la région de l'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 vue INFORMATION_SCHEMA.

L'exemple suivant montre comment renvoyer des informations de stockage pour les tables d'un projet spécifié dans une organisation :

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

L'exemple suivant montre comment renvoyer des informations de stockage par projet pour les tables d'une organisation :

SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION;

Exemple

L'exemple suivant montre l'utilisation de toutes les tables de l'organisation pour la date d'utilisation 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_ORGANIZATION
  )
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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+