Vue TABLE_STORAGE_BY_ORGANIZATION

La vue INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION contient une ligne pour chaque table ou vue matérialisée pour l'ensemble de l'organisation associée au projet en cours. Les données de ce tableau ne sont pas conservées en temps réel et peuvent être retardées de quelques secondes à quelques minutes.

Les vues de stockage de tables vous permettent de surveiller facilement la consommation de stockage actuelle. Elles fournissent également des informations sur l'utilisation d'octets logiques non compressés, d'octets compressés physiques ou d'octets de fonctionnalité temporelle dans votre espace de stockage. Ces informations peuvent vous aider dans des tâches telles que la planification de la croissance future et la compréhension des modèles de mise à jour des tables.

Données incluses dans les colonnes *_BYTES

Les colonnes *_BYTES des vues de stockage de tables incluent des informations sur votre utilisation des octets de stockage. Ces informations sont déterminées en examinant votre utilisation de l'espace de stockage pour les vues matérialisées et les types de tables suivants :

  • Tables permanentes créées via l'une des méthodes décrites sur la page Créer et utiliser des tables
  • Tables temporaires créées dans des sessions. Ces tables sont placées dans des ensembles de données ayant des noms générés comme "_c018003e063d09570001ef33ae401fad6ab92a6a".
  • Tables temporaires créées dans des requêtes à plusieurs instructions ("scripts"). Ces tables sont placées dans des ensembles de données ayant des noms générés comme "_script72280c173c88442c3a7200183a50eeeaa4073719".

Les données stockées dans le cache des résultats de requête ne vous sont pas facturées et ne sont donc pas incluses dans les valeurs des colonnes *_BYTES.

Les clones et les instantanés affichent les valeurs de la colonne *_BYTES comme s'il s'agissait de tables complètes, plutôt que d'afficher les valeurs delta du stockage utilisé par la table de base, ce qui constitue une surestimation. Votre facture tient compte correctement de ce delta dans l'utilisation de l'espace de stockage.

Prévoir la facturation du stockage

Afin de prévoir la facturation mensuelle du stockage d'un ensemble de données, vous pouvez utiliser les colonnes logical ou physical *_BYTES de cette vue, selon le modèle de facturation du stockage des ensembles de données utilisé par l'ensemble de données. Notez qu'il ne s'agit que d'une prévision approximative. Les montants de facturation précis sont calculés en fonction de l'utilisation par l'infrastructure de facturation de l'espace de stockage BigQuery et sont visibles dans Cloud Billing.

Pour les ensembles de données qui utilisent un modèle de facturation logique, vous pouvez prévoir vos coûts de stockage mensuels comme suit :

((ACTIVE_LOGICAL_BYTES valeur / POW(1024, 3)) * tarification des octets logiques actifs) + ((valeur LONG_TERM_LOGICAL_BYTES / POW(1024, 3)) * tarification des octets logiques à long terme)

La valeur ACTIVE_LOGICAL_BYTES d'une table reflète les octets actifs actuellement utilisés par cette table.

Pour les ensembles de données qui utilisent un modèle de facturation physique, vous pouvez prévoir vos coûts de stockage comme suit :

((valeur ACTIVE_PHYSICAL_BYTES + FAIL_SAFE_PHYSICAL_BYTES / POW(1024, 3)) * tarification des octets physiques actifs) + ((valeur LONG_TERM_PHYSICAL_BYTES / POW(1024, 3)) * tarification des octets physiques à long terme)

La valeur ACTIVE_PHYSICAL_BYTES d'une table reflète les octets actifs actuellement utilisés par cette table, ainsi que les octets utilisés pour les fonctionnalités temporelles de cette table.

Pour afficher uniquement les octets actifs de la table, soustrayez la valeur TIME_TRAVEL_PHYSICAL_BYTES de la valeur ACTIVE_PHYSICAL_BYTES.

Pour en savoir plus, consultez les tarifs de stockage.

Autorisations requises

Pour interroger la vue INFORMATION_SCHEMA.TABLE_STORAGE_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.admin
  • roles/bigquery.dataViewer
  • roles/bigquery.dataEditor
  • roles/bigquery.metadataViewer

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_BY_ORGANIZATION présente le schéma suivant :

Nom de la colonne Type de données Valeur
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
CREATION_TIME TIMESTAMP Date/Heure de création de la table
DELETED BOOLEAN Indique si la table est supprimée ou non.
STORAGE_LAST_MODIFIED_TIME TIMESTAMP Date et heure de la dernière écriture des données dans la table.
TOTAL_ROWS INT64 Nombre total de lignes dans la table ou la vue matérialisée
TOTAL_PARTITIONS INT64 Nombre de partitions présentes dans la table ou la vue matérialisée. Les tables non partitionnées renvoient la valeur 0.
TOTAL_LOGICAL_BYTES INT64 Nombre total d'octets (non compressés) logiques dans la table ou la vue matérialisée
ACTIVE_LOGICAL_BYTES INT64 Nombre d'octets (non compressés) logiques datant de moins de 90 jours
LONG_TERM_LOGICAL_BYTES INT64 Nombre d'octets (non compressés) logiques datant de plus de 90 jours
TOTAL_PHYSICAL_BYTES INT64 Nombre total d'octets (compressés) physiques utilisés pour le stockage, y compris les octets actifs, à long terme et de fonctionnalité temporelle (données supprimées ou modifiées)
ACTIVE_PHYSICAL_BYTES INT64 Nombre d'octets (compressés) physiques datant de moins de 90 jours, y compris les octets de fonctionnalité temporelle (données supprimées ou modifiées)
LONG_TERM_PHYSICAL_BYTES INT64 Nombre d'octets (compressés) physiques datant de plus de 90 jours
TIME_TRAVEL_PHYSICAL_BYTES INT64 Nombre d'octets (compressés) physiques utilisés par le stockage temporel (données supprimées ou modifiées)
FAIL_SAFE_PHYSICAL_BYTES INT64 Nombre d'octets (compressés) physiques utilisés par le stockage protégé des défaillance (données supprimées ou modifiées)
TABLE_TYPE STRING Type de table. Par exemple, "EXTERNAL" ou "BASE TABLE".

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. 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_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 : tout nom de région d'ensemble de données. Exemple : region-us.

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_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_BY_ORGANIZATION;

Exemple

L'exemple suivant montre quels projets d'une organisation utilisent le plus d'espace de stockage.

SELECT
  project_id,
  SUM(total_logical_bytes) AS total_logical_bytes
FROM
  `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION
GROUP BY
  project_id
ORDER BY
  total_logical_bytes DESC;

Le résultat ressemble à ce qui suit :

+---------------------+---------------------+
|     project_id      | total_logical_bytes |
+---------------------+---------------------+
| projecta            |     971329178274633 |
+---------------------+---------------------+
| projectb            |     834638211024843 |
+---------------------+---------------------+
| projectc            |     562910385625126 |
+---------------------+---------------------+