Comprendre les tables de données Cloud Billing dans BigQuery

Cette page fournit des informations de référence pour le schéma des données Cloud Billing exportées vers chaque table dans BigQuery.

Tables de données de facturation

Peu de temps après l'activation de l'exportation Cloud Billing vers BigQuery, les tables de données de facturation sont automatiquement créées dans l'ensemble de données BigQuery.

  • Table de coût d'utilisation standard : dans votre ensemble de données BigQuery, cette table est nommée gcp_billing_export_v1_<BILLING_ACCOUNT_ID>.
  • Table de coût d'utilisation détaillé : inclut tous les champs de données présentes dans la table de coût d'utilisation standard, ainsi que des champs supplémentaires qui fournissent des données de coût au niveau des ressources, comme une machine virtuelle ou un disque SSD qui génère une utilisation du service. Dans votre ensemble de données BigQuery, cette table est nommée gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>.
  • Grille tarifaire : dans votre ensemble de données BigQuery, cette table est nommée cloud_pricing_export.

Fréquence des chargements de données

Exportation des coûts d'utilisation standards et détaillés :

  • Lorsque vous activez l'exportation du coût d'utilisation standard ou détaillé vers BigQuery pour la première fois, l'affichage de vos données de coût Google Cloud peut prendre quelques heures.
  • Les services Google Cloud transmettent les données d'utilisation et de coût aux processus de facturation Cloud Billing à des intervalles variables.
  • Cloud Billing exporte les données d'utilisation et de coût vers votre ensemble de données BigQuery à intervalles réguliers (il n'existe aucune garantie de diffusion ou de latence pour l'exportation vers BigQuery).
  • Étant donné que la fréquence des rapports d'utilisation varie selon le service Google Cloud, il est possible que vous ne voyiez pas immédiatement les données d'utilisation et de coût de Cloud Billing pour tous les services Google Cloud récemment utilisés.

Exportation des tarifs :

  • Lorsque vous activez l'exportation des tarifs vers BigQuery pour la première fois, l'affichage des données de tarification Google Cloud peut prendre jusqu'à 48 heures.
  • Une fois l'exportation des tarifs activée, les données de tarification applicables à votre compte Cloud Billing sont exportées quotidiennement vers BigQuery.

Disponibilité des données :

  • Pour les clients qui activent les exportations des données de coût d'utilisation standard ou de tarification, votre ensemble de données BigQuery ne reflète que les données Cloud Billing générées à compter de la date à laquelle vous avez activé l'exportation pour la première fois. Les données Cloud Billing ne sont pas ajoutées rétroactivement. Par conséquent, les données de facturation Cloud générées avant l'activation de l'exportation ne s'affichent pas.
  • Pour les clients qui activent l'exportation des données de coût d'utilisation détaillé pour la première fois, les données Cloud Billing sont disponibles à partir du début du mois précédent. Par exemple, si vous activez l'exportation des données de coût d'utilisation détaillé le 23 septembre, votre exportation inclura les données à compter du 1er août.
    • Pour les clients ayant activé, désactivé, puis réactivé l'exportation des données de coût d'utilisation détaillé, il est possible que les données de facturation Cloud ne soient pas disponibles pour la période pendant laquelle elles ont été explicitement désactivées.
  • Si vous supprimez des données exportées, telles que des enregistrements d'exportation BigQuery, nous ne pouvons pas les remplacer.
  • Notez que les tâches de chargement BigQuery sont conformes aux normes ACID et que les données ne seront donc que partiellement chargées si vous envoyez une requête à l'ensemble de données d'exportation BigQuery Cloud Billing pendant que des données sont en train d'y être chargées. En savoir plus sur les caractéristiques BigQuery
  • Consultez les autres limites susceptibles de compromettre l'exportation de vos données de facturation vers BigQuery, telles que les ensembles de données avec des clés de chiffrement gérées par le client (CMEK).

Schéma des données de coût d'utilisation standard

Les informations suivantes décrivent le schéma des données de coût d'utilisation standard Google Cloud exportées vers BigQuery. Elles contiennent des informations d'ordre général concernant l'utilisation et les coûts liés au compte de facturation Cloud, telles que l'ID du compte, la date de facturation, les services, les SKU, les projets, les libellés, les emplacements, le coût, l'utilisation, les crédits, les ajustements et la devise.

Les données de coût d'utilisation standard n'incluent pas les données de coût au niveau des ressources, comme les machines virtuelles ou les disques SSD qui génèrent une utilisation du service. Si vous souhaitez exporter des données de coût au niveau des ressources vers BigQuery à des fins d'analyse, envisagez d'activer les données de coût d'utilisation détaillé. Les données de coût d'utilisation détaillé exportées incluent tous les champs et informations contenus dans les données de coût d'utilisation standard.

Consultez les autres limites susceptibles de compromettre l'exportation de vos données de facturation vers BigQuery, telles que les ensembles de données avec des clés de chiffrement gérées par le client (CMEK).

Dans votre ensemble de données BigQuery, vos données de coût d'utilisation standard de Google Cloud sont chargées dans une table de données nommée gcp_billing_export_v1_<BILLING_ACCOUNT_ID>.

Champ Type Description
billing_account_id Chaîne

ID du compte de facturation Cloud auquel l'utilisation est associée.

Revendeurs : pour les coûts d'utilisation générés par un sous-compte de facturation Cloud, il s'agit de l'ID du sous-compte, et non de l'ID du compte de facturation Cloud principal du revendeur.
invoice.month Chaîne

Année et mois (AAAAMM) de la facture qui inclut les lignes de coûts. Par exemple : "201901" équivaut à janvier 2019.

Vous pouvez utiliser ce champ pour obtenir le total des frais sur la facture. Consultez la section Exemples de requêtes BigQuery sur des données de facturation Cloud exportées.
cost_type Chaîne

Type de coût représenté par ce poste : erreur standard, de taxe, d'ajustement ou d'arrondi.
service.id Chaîne ID du service auquel l'utilisation est associée.
service.description Chaîne Le service Google Cloud ayant enregistré les données de facturation Cloud.
sku.id Chaîne ID de la ressource utilisée par le service. Pour obtenir la liste complète des SKU, consultez la page SKU Google Cloud.
sku.description Chaîne Description du type de ressource utilisé par le service. Stockage standard aux États-Unis est par exemple un type de ressource pour Cloud Storage.
usage_start_time Temporel Heure de début de la période d'utilisation horaire au cours de laquelle le coût donné a été calculé. L'utilisation et les coûts de tous les services s'affichent selon un horaire précis, ce qui signifie que l'utilisation des services pour des opérations de longue durée est répartie sur plusieurs périodes horaires.

Pour en savoir plus, accédez à la documentation BigQuery concernant les types de données d'horodatage. Consultez également la section Différences entre les données exportées et les factures ci-dessous.
usage_end_time Horodatage Heure de fin de la période d'utilisation horaire au cours de laquelle le coût donné a été calculé. L'utilisation et les coûts de tous les services s'affichent selon un horaire précis, ce qui signifie que l'utilisation des services pour des opérations de longue durée est répartie sur plusieurs périodes horaires.

Pour en savoir plus, accédez à la documentation BigQuery concernant les types de données d'horodatage. Consultez également la section Différences entre les données exportées et les factures ci-dessous.
project Struct project contient des champs qui décrivent le projet Cloud Billing, tels que l'ID, le numéro, le nom, ancêtre_numbers et les libellés.
project.id Chaîne ID du projet Google Cloud ayant généré les données Cloud Billing.
project.number Chaîne Identifiant unique, anonymisé et généré en interne pour le projet Google Cloud qui a généré les données Cloud Billing. Pour vos demandes d'assistance et autres communications client, Google désignera vos projets par ce numéro de projet.
project.name Chaîne Nom du projet Google Cloud ayant généré les données Cloud Billing.
project.ancestry_numbers Chaîne Ancêtres de la hiérarchie des ressources pour le projet identifié par la valeur project.id spécifiée (par exemple, my-project-123).

Par exemple : /ParentOrgNumber/ParentFolderNumber/. En savoir plus sur la hiérarchie des ressources.
project.ancestors Struct

Ce champ décrit la structure et la valeur de la hiérarchie des ressources d'un élément de ligne de coût, y compris les projets, les dossiers et les organisations. Les ancêtres sont classés en partant du nœud et en remontant vers la racine (projet, dossier, puis organisation).

project.ancestors.resource_name Chaîne Nom de ressource relatif de chaque ancêtre au format "resourceType/resourceNumber". L'utilisation de project.ancestors.resource_name offre une vue plus complète de project.ancestry_numbers.
project.ancestors.display_name Chaîne Nom que vous avez créé pour votre ressource dans la console.
project.labels.key Chaîne En cas de présence de libellés, la partie clé de la paire clé-valeur comportant le libellé du projet Google Cloud associé à l'utilisation. Pour en savoir plus sur les libellés, consultez la page Utiliser des libellés.
project.labels.value Chaîne En cas de présence de libellés, la partie valeur de la paire clé-valeur comportant le libellé du projet Google Cloud associé à l'utilisation. Pour en savoir plus sur les libellés, consultez la page Utiliser des libellés.
labels.key Chaîne En cas de présence de libellés, la partie clé de la paire clé-valeur comportant le libellé du projet Google Cloud associé à l'utilisation. Pour en savoir plus sur les libellés, consultez la page Utiliser des libellés.
project.labels.value Chaîne En cas de présence de libellés, la partie valeur de la paire clé-valeur comportant le libellé du projet Google Cloud associé à l'utilisation. Pour en savoir plus sur les libellés, consultez la page Utiliser des libellés.
labels.key Chaîne En cas de présence de libellés, la partie clé de la paire clé-valeur comportant le libellé de la ressource Google Cloud associée à l'utilisation. Pour en savoir plus sur les libellés, consultez la page Utiliser des libellés.
labels.value Chaîne En cas de présence de libellés, la partie valeur de la paire clé-valeur comportant le libellé de la ressource Google Cloud associée à l'utilisation. Pour en savoir plus sur les libellés, consultez la page Utiliser des libellés.
system_labels.key Chaîne Clé de la paire valeur/clé comportant le libellé généré par le système sur la ressource associée à l'utilisation (si des libellés système ont été définis). Consultez également Libellés système disponibles.
system_labels.value Chaîne Valeur de la paire valeur/clé comportant le libellé généré par le système sur la ressource associée à l'utilisation (si des libellés système ont été définis). Consultez également Libellés système disponibles.
location.location Chaîne Emplacement de l'utilisation au niveau d'un emplacement multirégional, d'un pays, d'une région ou d'une zone ; ou global pour les ressources qui n'ont pas d'emplacement spécifique. Pour en savoir plus, consultez les sections Zones géographiques et régions et Emplacements Google Cloud.
location.country Chaîne Lorsque location.location est un pays, une région ou une zone, ce champ correspond au pays d'utilisation, par exemple US. Pour en savoir plus, consultez les sections Zones géographiques et régions et Emplacements Google Cloud.
location.region Chaîne Lorsque location.location est une région ou une zone, ce champ correspond à la région d'utilisation, par exemple us-central1. Pour en savoir plus, consultez les sections Zones géographiques et régions et Emplacements Google Cloud.
location.zone Chaîne Lorsque location.location est une zone, ce champ correspond à la zone d'utilisation, par exemple us-central1-a. Pour en savoir plus, consultez les sections Zones géographiques et régions et Emplacements Google Cloud.
cost Float Coût de l'utilisation avant tout crédit, avec une précision allant jusqu'à six décimales. Pour obtenir le coût total, crédits inclus, tous les champs credits.amount doivent être ajoutés au coût. Pour en savoir plus, consultez cet exemple de requête.
currency Chaîne Devise dans laquelle les coûts sont facturés. Pour en savoir plus, consultez la page Devise locale pour la facturation et les paiements.
currency_conversion_rate Nombre à virgule flottante Taux de change du dollar américain dans la devise locale. Autrement dit, cost ÷ currency_conversion_rate correspond au coût en dollars américains.
usage.amount Nombre à virgule flottante Quantité d'usage.unit utilisée.
usage.unit Chaîne Unité de base dans laquelle l'utilisation des ressources est mesurée. Par exemple, l'unité de base pour le stockage standard est l'octet par seconde.
usage.amount_in_pricing_units Nombre à virgule flottante Quantité d'usage.pricing_unit utilisée.
usage.pricing_unit Chaîne Unité dans laquelle l'utilisation des ressources est mesurée, conformément à l'API Cloud Billing Catalog.
credits Struct credits contient des champs qui décrivent la structure et la valeur des crédits associés aux SKU Google Cloud et Google Maps Platform.
credits.id Chaîne S'il est présent, indique qu'un crédit est associé au code SKU du produit. Les valeurs credits.id sont des identifiants uniques alphanumériques (par exemple, 12-b34-c56-d78) ou une description du type de crédit (par exemple, Remise sur engagement d'utilisation : processeur).

Si le champ credits.id est vide, le SKU du produit n'est associé à aucun crédit.
credits.full_name Chaîne Le nom du crédit associé au code SKU du produit. Il s'agit d'une description lisible d'une valeur alphanumérique de credits.id. Comme exemple, on peut citer Crédit d'essai gratuit ou Remise sur engagement d'utilisation basée sur les dépenses.

Les valeurs credits.full_name ne sont présentes que pour les codes SKU avec une propriété credits.id alphanumérique. Si la valeur de credits.id est une description du type de crédit (par exemple Remise sur engagement d'utilisation : processeur), le champ credits.full_name est vide.

credits.type Chaîne Ce champ décrit l'objectif ou l'origine de l'objet credits.id. Les types de crédits incluent :
  • COMMITTED_USAGE_DISCOUNT : contrats d'engagement d'utilisation basés sur des ressources souscrits pour Compute Engine en retour à des prix fortement réduits pour l'utilisation des VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : contrats d'engagement d'utilisation basés sur les dépenses souscrits pour les services en échange de votre engagement à dépenser un montant minimal.
  • DISCOUNT : le type de crédit de la remise est utilisé pour les crédits gagnés après qu'un seuil de dépenses contractuel a été atteint. Notez que dans les rapports Cloud Billing disponibles dans Cloud Console, le type de crédit de la remise est indiqué sous la forme Remises basées sur les dépenses (contractuelles).
  • FREE_TIER : certains services proposent l'utilisation gratuite des ressources jusqu'aux limites spécifiées. Pour ces services, des crédits sont appliqués pour rendre leur utilisation gratuite.
  • PROMOTION : le type d'avoir promotionnel inclut un essai gratuit de Google Cloud et des crédits de campagne marketing, ou d'autres autorisations pour utiliser Google Cloud. Lorsqu'ils sont disponibles, les avoirs promotionnels sont considérés comme un mode de paiement et sont automatiquement appliqués pour réduire votre facture totale.
  • RESELLER_MARGIN : si vous êtes un revendeur, le type de crédit de la marge du revendeur indique le montant des remises du programme Revendeur remportées pour chaque ligne éligible.
  • SUBSCRIPTION_BENEFIT : crédits acquis en achetant des abonnements à long terme aux services en échange de remises.
  • SUSTAINED_USAGE_DISCOUNT : le type de crédit de remises automatiques proportionnelles à une utilisation soutenue est une remise automatique que vous gagnez en exécutant des ressources Compute Engine spécifiques pour une part importante du mois de facturation.
credits.name Chaîne Description du crédit appliqué au compte de facturation Cloud.
credits.amount Nombre à virgule flottante Montant du crédit appliqué à l'utilisation. Les crédits sont toujours des montants négatifs.
adjustment_info Struct adjustment_info contient des champs qui décrivent la structure et la valeur d'un ajustement des éléments de ligne de coût associée à un compte Cloud Billing.

Les valeurs adjustment_info ne sont présentes que si la ligne de coût a été générée pour une modification Cloud Billing. Une modification peut se produire pour des raisons liées aux corrections ou à la non-correction. Le type adjustment_info contient des détails sur l'ajustement, qu'il ait été émis pour corriger une erreur ou pour d'autres raisons.

adjustment_info.id Chaîne S'il est présent, indique qu'un ajustement est associé à un élément de ligne de coût. adjustment_info.id est un identifiant unique pour tous les ajustements associés causé par un problème donné.
adjustment_info.description Chaîne Description de l'ajustement et de sa cause.
adjustment_info.type Chaîne

Type d'ajustement.

Les types suivants sont inclus :

  • USAGE_CORRECTION : correction effectuée en raison d'une utilisation incorrecte constatée.
  • PRICE_CORRECTION : correction effectuée en raison de règles de tarification incorrectes.
  • METADATA_CORRECTION : correction permettant de corriger les métadonnées sans modifier le coût.
  • GOODWILL : crédit accordé à un client pour sa goodwill.
  • SALES_BASED_GOODWILL : crédit accordé au client pour sa goodwill, dans le cadre d'un contrat.
  • SLA_VIOLATION : crédit accordé au client en raison d'une violation de l'objectif de niveau de service (SLO).
  • BALANCE_TRANSFER : ajustement du transfert de fonds d'un compte de paiement vers un autre.
  • ACCOUNT_CLOSURE : ajustement pour appliquer un compte clôturé à un solde nul.
  • GENERAL_ADJUSTMENT : modification générale d'un compte de facturation.
adjustment_info.mode Chaîne

La manière dont l'ajustement a été émis.

Les modes disponibles sont les suivants :

  • PARTIAL_CORRECTION : la correction annule partiellement l'utilisation et le coût d'origine.
  • COMPLETE_NEGATION_WITH_REMONETIZATION : la correction annule complètement l'utilisation et le coût d'origine, et émet les éléments de ligne corrigés en cas d'utilisation et de coûts mis à jour.
  • COMPLETE_NEGATION : la correction annule complètement l'utilisation et le coût d'origine. Par ailleurs, aucune autre utilisation n'est plus remonétisée.
  • MANUAL_ADJUSTMENT : l'ajustement est alloué manuellement au coût et à l'utilisation.
export_time Horodatage Temps de traitement associé aux données Cloud Billing ajoutées. Cette valeur augmente toujours à chaque nouvelle exportation.
Consultez également la section Différences entre les données exportées et les factures ci-dessous.

Schéma des données de coût d'utilisation détaillé

Les données de coûts d'utilisation détaillé fournissent toutes les informations incluses dans les données de coût d'utilisation standard, ainsi que des champs supplémentaires fournissant des données de coût au niveau des ressources. comme une machine virtuelle ou un disque SSD qui génère une utilisation des services.

Les informations suivantes décrivent les champs supplémentaires fournis dans le schéma des données de coût d'utilisation détaillé de Google Cloud exportées vers BigQuery et non incluses dans le schéma de données de coût d'utilisation standard.

Dans votre ensemble de données BigQuery, vos données de coût détaillé de Google Cloud sont chargées dans une table de données nommée gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>.

Lorsque vous utilisez les données de coût d'utilisation détaillé dans BigQuery, tenez compte des points suivants :

  • Lorsque vous sélectionnez ou créez un ensemble de données BigQuery pour vos données de coût d'utilisation détaillé, vous devez utiliser un ensemble de données multirégional situé aux États-Unis (US) ou dans l'Union européenne (UE).
  • Lorsque vous activez l'exportation des données de coût d'utilisation détaillé pour la première fois, les données Cloud Billing sont disponibles à partir du début du mois précédent.
    • Si vous avez activé, désactivé, puis réactivé l'exportation des données de coût d'utilisation détaillé, il est possible que les données de facturation Cloud ne soient pas disponibles pour la période pendant laquelle elles ont été explicitement désactivées.
  • Consultez les autres limites susceptibles de compromettre l'exportation de vos données de facturation vers BigQuery, telles que les ensembles de données avec des clés de chiffrement gérées par le client (CMEK).
  • Tenez compte du volume de données supplémentaire dont vos tables BigQuery pourraient avoir besoin et du coût supplémentaire lors de l'activation des données de coût d'utilisation détaillé au lieu de l'exportation des données de coût d'utilisation standard. La précision accrue des informations au niveau des ressources peut augmenter le nombre de lignes, qui sont agrégées au format de coût d'utilisation standard. Nous vous recommandons de consulter la page Contrôler les coûts dans BigQuery afin de découvrir d'autres bonnes pratiques en matière de gestion des coûts BigQuery.
Champ Type Description
resource Struct

Champs qui décrivent la structure et la valeur des informations pertinentes pour les ressources de service (telles qu'une machine virtuelle ou un disque SSD) qui génèrent une utilisation du service.
resource.global_name Chaîne

Identifiant de service unique pour la ressource qui a généré une utilisation pertinente.
resource.name Chaîne

Identifiant spécifique au service pour la ressource qui a généré une utilisation pertinente. Il peut s'agir d'une entrée générée par l'utilisateur.

Comprendre les données de coût d'utilisation standard et détaillé

Les sections suivantes décrivent les données de coût d'utilisation standard et détaillé exportées vers BigQuery.

À propos des libellés

Vous verrez des colonnes pour les libellés dans votre ensemble de données BigQuery. Toutefois, certaines valeurs de libellés sont vides dans la version actuelle. Les données exportées pour les libellés seront insérées à différents moments pour divers services, en fonction de la date à laquelle chaque service les fournit.

Libellés système disponibles

Les libellés système sont des paires valeur/clé pour des métadonnées importantes concernant la ressource qui a généré l'utilisation. Les libellés système suivants sont automatiquement inclus dans l'utilisation applicable.

system_labels.key Exemple de fichier system_labels.value Description
compute.googleapis.com/machine_spec n1-standard-1, custom-2-2048 Configuration de la machine virtuelle. Pour plus d'informations, consultez la page Types de machines.
compute.googleapis.com/cores 4 pour n1-standard-4 ; 2 pour custom-2-2048 Nombre de processeurs virtuels disponibles sur la machine virtuelle
compute.googleapis.com/memory 15360 pour n1-standard-4 (soit 15 Go * 1024 Mo/Go) ; 2048 pour custom-2-2048 Quantité de mémoire (en Mo) disponible sur la machine virtuelle
compute.googleapis.com/is_unused_reservation true ; false Indique l'utilisation qui a été réservée via des Réservations zonales, mais qui n'a pas été utilisée.

Différences entre les données exportées et les factures

Étant donné que les services Google Cloud transmettent les données d'utilisation et de coût aux processus Cloud Billing à à des intervalles variables, les rapports d'utilisation peuvent être légèrement retardés (jusqu'à quelques jours). Au terme d'un mois calendaire, il se peut que l'utilisation de fin de mois ne soit pas incluse dans la facture du mois en cours, mais reportée sur la facture du mois suivant. Toutefois, cette même utilisation inclut un horodatage en fonction de la date et de l'heure d'utilisation réelles lorsque celle-ci est signalée aux processus Cloud Billing.

Lorsque vous interrogez vos coûts à l'aide des champs d'horodatage, les données renvoyées peuvent récupérer l'utilisation non constatée après l'émission de la facture se rapportant au même mois d'utilisation. Par conséquent, il est possible que les données Cloud Billing renvoyées ne correspondent pas directement à cette facture.

Les champs d'horodatage comprennent les suivants :

  • usage_start_time
  • usage_end_time
  • export_time

Pour renvoyer des données Cloud Billing directement associées à une facture, exécutez une requête sur invoice.month plutôt que sur les champs d'horodatage.

Taxes

À compter du 1er septembre 2020, vos données de coût d'utilisation affichent le montant de la taxe applicable à chacun de vos projets, au lieu d'une ligne unique. Si certaines de vos requêtes ou visualisations dépendent de données de taxes, vous devrez peut-être les mettre à jour pour tenir compte de ces modifications.

Par exemple, pour les coûts enregistrés avant le 1er septembre, vos données de coût d'utilisation ressemblent à l'exemple suivant, dans lequel le montant de la taxe s'élève à 10 USD.

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Standard 60 $
123456-ABCDEF-123456 test-project Standard 40 $
123456-ABCDEF-123456 [vide] Taxes 10 $

Pour les coûts enregistrés après le 1er septembre, les 10 $ de taxes sont décomposés, soit 6 $ pour example-project et 4 $ pour test-project :

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Standard 60 $
123456-ABCDEF-123456 test-project Standard 40 $
123456-ABCDEF-123456 example-project Taxes 6 $
123456-ABCDEF-123456 test-project Taxes 4 $

Erreurs et ajustements

Dans le cas peu probable où vos données Cloud Billing contiendraient une erreur ou nécessiteraient un ajustement, sachez que d'autres données seront ajoutées afin de corriger l'erreur. Les valeurs de toutes les colonnes resteront les mêmes, sauf pour les suivantes :

  • cost
  • credit
  • usage.amount
  • export_time

Pour identifier les nouvelles données, vous pouvez lancer une requête sur export_time.

Dans vos données exportées, le mois de facturation pour les ajustements Cloud Billing et les taxes associées reflète le mois où l'ajustement a été émis. Toutefois, l'ajustement peut être appliqué à une facture pour un mois différent de celui du mois d'émission de l'ajustement. Pour savoir si un ajustement est appliqué et dans quel contexte, vous devez consulter les documents de facture ou de note de crédit/débit disponibles sur la page des documents de Google Cloud Console. Pour en savoir plus sur l'analyse des ajustements et leur application, consultez la section Comprendre les notes et les ajustements.

Exemples de requêtes pour les données de coût d'utilisation standard

Exemples de requêtes de coût d'utilisation standard

Schéma des données de tarification

Dans votre ensemble de données BigQuery, les données de tarification de votre compte Cloud Billing sont chargées dans une table de données nommée cloud_pricing_export.

Les informations suivantes décrivent le schéma des données de tarification du compte Cloud Billing exportées vers BigQuery.

Champ Type Description
export_time Temporel Temps de traitement associé aux données Cloud Billing ajoutées. Cette valeur augmente toujours à chaque nouvelle exportation.
pricing_as_of_time Temporel Les données de tarification applicables à votre compte Cloud Billing sont générées une fois par jour afin de les préparer à l'exportation vers BigQuery. Il s'agit de l'horodatage quotidien correspondant à la date de génération des données de tarification.
billing_account_id Chaîne ID du compte de facturation Cloud auquel la tarification est associée.
billing_account_name Chaîne

Nom du compte Cloud Billing auquel le tarif est associé.
business_entity_name Chaîne Nom de la famille de services Google du service qui propose le code SKU. Les valeurs possibles sont GCP (Google Cloud) et Maps (Google Maps Platform).
service.id Chaîne ID du service Google Cloud ou de l'API Google Maps Platform ayant généré les données Cloud Billing. Par exemple, 6F81-5844-456A.
service.description Chaîne Description du service Google Cloud ou de l'API Google Maps Platform ayant généré les données Cloud Billing. Par exemple, Compute Engine.
sku.id Chaîne Identifiant unique du code SKU de la ressource utilisée par le service. Par exemple, 2E27-4F75-95CD. Pour obtenir la liste complète des codes SKU, consultez la page Codes SKU Google Cloud.
sku.description Chaîne Description lisible du code SKU de la ressource utilisé par le service. Par exemple, Cœur d'instance N1 prédéfini s'exécutant en région Amériques.
sku.destination_migration_mappings Tableau de chaînes Noms des codes SKU de destination vers lesquels ce code SKU est migré.
product_taxonomy Tableau de chaînes Liste des catégories de produits qui s'appliquent au code SKU, telles que Serverless, Cloud Run, TaskQueue, VMs On Demand, Cores : Per Core, etc.
geo_taxonomy Struct Métadonnées géographiques qui s'appliquent au code SKU, telles que des régions et des zones multirégionales comme us-east4 l'Union européenne.
geo_taxonomy.type Chaîne Type de métadonnées géographiques associé au code SKU. Les valeurs possibles sont les suivantes :
  • GLOBAL : aucune région
  • REGIONAL : possède une région
  • MULTI_REGION : possède au moins deux régions
geo_taxonomy.regions Tableau de chaînes Régions Google Cloud associées au code SKU. Par exemple, Europe-west2 ou US.

Une région est un emplacement géographique spécifique, par exemple Londres. Une zone multirégionale correspond à un secteur géographique de grande étendue, par exemple les États-Unis, et comporte au moins deux lieux géographiques.
pricing_unit Chaîne Forme abrégée de l'unité d'utilisation dans laquelle la tarification est spécifiée (par exemple "GiBy.mo").
pricing_unit_description Chaîne Description lisible de l'unité d'utilisation (par exemple "gibioctet/mois").
account_currency_code Chaîne Devise dans laquelle le compte Cloud Billing fonctionne, sous la forme d'un code de devise à trois lettres, défini dans la norme ISO 4217. Pour en savoir plus, consultez la page Devise locale pour la facturation et les paiements automatiques.
currency_conversion_rate Chaîne Taux de change du dollar américain dans la devise locale avec lequel le compte Cloud Billing fonctionne. Si la devise du compte Cloud Billing est "USD", le taux de change est de "1,0" par défaut.

Si vos coûts Cloud Billing sont facturés dans une devise autre que le dollar américain, vous pouvez convertir vos coûts d'utilisation en dollars américains en utilisant la formule suivante : cost ÷ currency_conversion_rate  = coût d'utilisation en dollars américains.

Notez que lorsque la facturation est effectuée en devise locale, nous convertissons les prix dans la devise locale applicable, conformément aux taux de change publiés par les principales institutions financières. Cela inclut toutes les surtaxes collectées pour la facturation dans une devise autre que le dollar américain. Nous utilisons les taux en vigueur pour l'horodatage pricing_as_of_time.
list_price Struct

Prix catalogue des codes SKU de Google Cloud ou de Google Maps Platform et des niveaux de tarification des codes SKU en vigueur à la date et à l'heure pricing_as_of_time.

list_price contient des champs qui décrivent la structure et la valeur du prix catalogue, y compris les éléments suivants :

Les prix catalogue sont disponibles sur list_price.tiered_rates.usd_amount

Les données des prix catalogue sont générées et exportées pour tous les clients. Si votre compte de facturation Cloud dispose d'une tarification personnalisée et contractuelle, les données tarifaires spécifiques à un compte de facturation sont également exportées.
billing_account_price Struct

Si vous disposez d'une tarification contractuelle, il s'agit du prix de code SKU négocié dans le contrat associé à votre compte de facturation Cloud.

billing_account_price contient des champs qui décrivent la structure et la valeur des tarifs négociés pour les codes SKU de Google Cloud et Google Maps Platform, ainsi que les niveaux de tarification des codes SKU. billing_account_price comprend :

Vos tarifs contractuels (selon les paramètres de votre compte de facturation Cloud) sont disponibles sur billing_account_price.tiered_rates.usd_amount
price_info Struct Informations générales sur la tarification contractuelle.
price_info.price_reason Chaîne

Informations générales sur l'origine de la tarification contractuelle.

Raisons possibles :

  • DEFAULT_PRICE : le prix par défaut correspond au prix catalogue actuel du code SKU.
  • FIXED_PRICE : prix fixe du SKU applicable pendant les conditions du contrat.
  • FIXED_DISCOUNT : pourcentage de remise par rapport au prix catalogue, ancré au prix catalogue à une date fixe.
  • FLOATING_DISCOUNT : pourcentage de remise par rapport au prix catalogue actuel (non ancré à un prix catalogue à une date spécifique).
  • MIGRATED_PRICE : applicable aux prix qui ont été migrés à partir d'autres codes SKU.
  • MERGED_PRICE : prix du code SKU après la fusion à partir de plusieurs sources. Par exemple, avec les niveaux fusionnés, chaque niveau peut provenir d'une source différente avec différents types de remises.
  • LIST_PRICE_AS_CEILING : fonctionnalité contractuelle facultative, disponible dans les nouveaux contrats à compter du 21 mars 2022. Lorsqu'il est actif, si le prix catalogue actuel est inférieur au prix fixe personnalisé, le prix catalogue (DEFAULT_Price) est utilisé pour le prix du code SKU. S'applique à tous les codes SKU à prix fixe du contrat, y compris les valeurs FIXED_PRICE, FIXED_DISCOUNT, MIGRATED_PRICE et MERGED_PRICE.
price_info.discount_percent Numérique Pour les tarifs contractuels résultant d'une remise en pourcentage (FIXED_DISCOUNT ou FLOATING_DISCOUNT), il s'agit du pourcentage de la remise utilisée.
price_info.discount_percent_fixed_date Date Pour les tarifs contractuels avec une remise en pourcentage ancrée à une date spécifique (FIXED_DISCOUNT), il s'agit de la date utilisée.
price_info.discount_migrated_from Chaîne Pour les remises sur tarification contractuelle migrées à partir d'autres codes SKU (MIGRATED_PRICE), il s'agit du code SKU source de la remise. Lorsqu'un code SKU est divisé en deux, la remise est transférée de l'ancien code SKU aux nouveaux codes.
aggregation_info Struct Représente le niveau et l'intervalle d'agrégation pour les niveaux de tarification d'un code SKU unique.
aggregation_info.aggregation_level Chaîne Niveau auquel l'utilisation est agrégée pour calculer le coût des niveaux de tarification.

Les niveaux incluent :

  • ACCOUNT : indique un code SKU avec tarification à plusieurs niveaux. L'utilisation des codes SKU pour les niveaux de tarification est agrégée dans tous les projets d'un même compte de facturation Cloud.
  • PROJECT : indique un code SKU avec une tarification à plusieurs niveaux. L'utilisation des codes SKU pour les niveaux de tarification est agrégée par projet.
  • UNKNOWN_AGGREGATION_LEVEL : indique un code SKU avec une tarification à un seul niveau. Il s'agit de la valeur par défaut pour les codes SKU avec une tarification non différenciée.
aggregation_info.aggregation_interval Chaîne Intervalle auquel l'utilisation est agrégée pour calculer le coût des niveaux de tarification.

Les intervalles incluent :

  • ONE_DAY : indique un code SKU avec une tarification à plusieurs niveaux. L'utilisation des codes SKU pour les niveaux de tarification est agrégée chaque jour.
  • ONE_MONTH : indique un code SKU avec une tarification à plusieurs niveaux. L'utilisation des codes SKU pour les niveaux de tarification est agrégée tous les mois.
  • UNKNOWN_AGGREGATION_INTERVAL : indique un code SKU avec une tarification à un seul niveau. Il s'agit de la valeur par défaut pour les codes SKU avec une tarification non différenciée.
tiered_rates Tableau de chaînes Informations sur le niveau de tarification, y compris le prix du code SKU en dollars américains et le prix du code SKU dans la devise avec laquelle le compte de facturation Cloud fonctionne.

Certains codes SKU n'ont qu'un seul niveau de tarification. Si un code SKU possède plusieurs niveaux de tarification, chaque niveau apparaît sous la forme d'une ligne distincte. Vous pouvez identifier les codes SKU avec plusieurs niveaux de tarification à l'aide de tiered_rates.start_usage_amount.
tiered_rates.pricing_unit_quantity Float Quantité d'unités du niveau de tarification des SKU. Par exemple, si la tarification du niveau est de 1 $ pour 1 000 000 octets, cette colonne indiquera 1 000 000.
tiered_rates.start_usage_amount Float Montant limite inférieur pour un niveau de tarification donné, en unités tarifaires. Par exemple, un code SKU comportant les trois niveaux de tarification "1 à 100 unités", "101 à 1 000 unités" et "1 001 unités et plus" affiche trois lignes de tarification dont les valeurs de [tiered_rates].start_usage_amount sont les suivantes : 1, 101 et 1 001.
tiered_rates.usd_amount Numérique Prix du code SKU en dollars américains.
tiered_rates.account_currency_amount Numérique Prix du niveau de tarification du code SKU que currency_conversion_rate a converti en devise que le compte de facturation Cloud utilise, à partir sa valeur en dollars américains.

Ce prix converti est calculé à l'aide de la formule suivante : tiered_rates.usd_amount * currency_conversion_rate = tiered_rates.account_currency_amount.

Lorsque la facturation est effectuée en devise locale, nous convertissons les prix dans la devise locale applicable, conformément aux taux de change publiés par les principales institutions financières. Cela inclut toutes les surtaxes collectées pour la facturation dans une devise autre que le dollar américain. Nous utilisons les taux en vigueur pour l'horodatage pricing_as_of_time.

À propos des niveaux de tarification

Les tarifs des codes SKU sont proposés par niveaux de tarification. Les niveaux de tarification fournissent une structure tarifaire basée sur différents niveaux. Certains codes SKU n'ont qu'un seul niveau de tarification, tandis que d'autres ont plusieurs niveaux de tarification. Voici quelques exemples de codes SKU à plusieurs niveaux :

  • Les codes SKU avec un niveau d'utilisation gratuit. Par exemple, les unités 1 à 1 000 sont gratuites. Les unités à partir de 1 001 sont facturées à 1 $ chacune.
  • Les codes SKU pour lesquels le prix par unité diminue lorsque la quantité d'utilisation d'un niveau est dépassée. Par exemple : les unités 1 à 100 sont facturées à 5 $ chacune, les unités 101 à 1 000 à 4 $ chacune et les unités à partir de 1 001 à 3 $ chacune.

Remarques concernant la tarification à plusieurs niveaux :

  • Le compteur d'utilisation du niveau est réinitialisé en fonction de la valeur aggregation_interval du code SKU : quotidien ou mensuel.

    • Les codes SKU quotidiens sont réinitialisés tous les jours à minuit (heure du Pacifique des États-Unis et du Canada, UTC-8 ou UTC-7).
    • Les codes SKU mensuels sont réinitialisés le premier jour de chaque mois civil (par exemple, janvier, février, etc.), à minuit (heure du Pacifique des États-Unis et du Canada (UTC-8 ou UTC-7).

  • Les niveaux fonctionnent indépendamment pour chaque compte de facturation Cloud et les différents comptes ne font pas l'objet d'un regroupement, même si les projets se trouvent dans la même organisation ou appartiennent à la même entité juridique.

  • Les niveaux fonctionnent indépendamment pour chaque code SKU : l'utilisation d'un code SKU ne peut affecter que le prix de ce code SKU spécifique. Actuellement, aucune utilisation d'un code SKU n'affecte la tarification différenciée d'un autre code SKU.

  • Sachez qu'il est possible que les niveaux de tarification des codes SKU concernant les prix catalogue ne correspondent pas exactement à ceux de la tarification contractuelle. Cette situation est rare.

  • Si un code SKU comporte plusieurs niveaux de tarification, chaque tarif de niveau de code SKU est répertorié sur une ligne distincte dans la grille tarifaire. Vous pouvez identifier les codes SKU avec plusieurs niveaux de tarification à l'aide de tiered_rates.start_usage_amount.

  • En fonction de la façon dont vous écrivez votre requête, vous pouvez renvoyer les niveaux de tarification des codes SKU sous forme de données imbriquées ou non imbriquées. Pour en savoir plus sur les données imbriquées et non imbriquées, consultez les exemples suivants.

Exemples de requêtes de tarification : Renvoie les prix catalogue pour un code SKU avec plusieurs niveaux de tarification

Vous interrogez vos données BigQuery par nom de table. Le nom de table utilisé dans la clause FROM de la requête est déterminé à l'aide de trois valeurs : project.dataset.BQ_table_name.

Valeurs courantes utilisées dans les exemples suivants :

  • Nom de la table : project.dataset.cloud_pricing_export
  • ID du code SKU : 2DA5-55D3-E679 (Cloud Run – Requêtes)

Exemple 1 : Renvoie des données imbriquées

Cet exemple interroge un seul code SKU pour renvoyer les données list_price. Ce code SKU possède plusieurs niveaux de tarification. Les valeurs du champ des prix catalogue s'affichent sur des lignes individuelles imbriquées sous la ligne d'ID de code SKU.

SQL standard

SELECT sku.id AS sku_id,
       sku.description AS sku_description,
       service.id AS service_id,
       service.description as service_description,
       list_price.*
FROM my-billing-admin-project.my_billing_dataset.cloud_pricing_export
WHERE DATE(_PARTITIONTIME) = "2020-07-20"
      AND sku.id = "2DA5-55D3-E679"
;

Résultats de la requête :

Ligne sku_id sku_description service_id service_description aggregation_info.
aggregation_level		 aggregation_info.
aggregation_interval		 tiered_rates.
pricing_unit_quantity		 tiered_rates.
start_usage_amount		 tiered_rates.
usd_amount		 tiered_rates.
account_currency_amount
1 2DA5-55D3-E679 Requêtes 152E-C115-5142 Cloud Run COMPTE MENSUEL 1000000 0 0 0
            1000000 2000000 0,4 0,4

Exemple 2 : Renvoyer des données non imbriquées associées à la même table

Cet exemple interroge un seul code SKU pour renvoyer la valeur de list price. Ce code SKU possède plusieurs niveaux de tarification. La requête illustre l'utilisation de l'opérateur UNNEST afin d'aplatir le tableau tiered_rates et de joindre les champs avec la même table, pour obtenir une ligne par niveau de tarification.

SQL standard

SELECT sku.id AS sku_id,
       sku.description AS sku_description,
       service.id AS service_id,
       service.description as service_description,
       tier.*
FROM `my-billing-admin-project.my_billing_dataset.cloud_pricing_export` as sku_pricing, UNNEST (sku_pricing.list_price.tiered_rates) as tier
WHERE DATE(_PARTITIONTIME) = "2020-07-20"
      AND sku.id = "2DA5-55D3-E679"
;

Résultats de la requête :

Ligne sku_id sku_description service_id service_description pricing_unit_quantity start_usage_amount usd_amount account_currency_amount
1 2DA5-55D3-E679 Requêtes 152E-C115-5142 Cloud Run 1000000,0 0,0 0,0 0,0
2 2DA5-55D3-E679 Requêtes 152E-C115-5142 Cloud Run 1000000,0 2000000,0 0,4 0,4

Tous les exemples de requêtes pour les données de tarification

Exemples de requêtes pour les données de tarification

Limites

L'exportation de données Cloud Billing vers BigQuery est soumise aux limitations suivantes.

  • Vos ensembles de données BigQuery contenant les données de coût d'utilisation standard et de tarification ne reflètent que les données de facturation Google Cloud générées depuis la date à laquelle vous avez configuré l'exportation Cloud Billing. Autrement dit, les données de facturation Google Cloud ne sont pas ajoutées rétroactivement. Par conséquent, les données Cloud Billing antérieures à l'activation de l'exportation n'apparaissent pas. Pour en savoir plus, consultez la section Disponibilité des données.
  • Vos ensembles de données BigQuery contenant les données de coût d'utilisation détaillé reflètent les données de facturation Google Cloud générées depuis le début du mois précédent, à partir du moment où vous avez activé l'exportation pour la première fois, à moins que vous ne l'activiez à nouveau. Autrement dit, les données de facturation Google Cloud ne sont ajoutées rétroactivement que pour le mois en cours et le mois précédent. Pour en savoir plus, consultez la section Disponibilité des données.
  • Lorsque vous exportez des données de coût d'utilisation détaillé, vous devez les exporter vers un ensemble de données configuré avec un emplacement multirégional, par exemple les États-Unis (US) ou l'Union européenne (UE). Si vous sélectionnez un ensemble de données qui n'est pas un emplacement multirégional, Cloud Billing ne peut pas écrire de données de facturation détaillées dans les tables appropriées de cet ensemble de données.
  • Les clés de chiffrement gérées par le client (CMEK) ne sont pas compatibles avec l'exportation de données de facturation vers BigQuery. Si vous activez la fonctionnalité CMEK pour votre ensemble de données de facturation, cela empêche Cloud Billing d'écrire des données de facturation dans les tables appropriées de cet ensemble de données. Au lieu de cela, vous devez configurer l'ensemble de données pour qu'il utilise le chiffrement par clés gérées par Google.

Rapports sur les coûts et les tarifs disponibles dans Google Cloud Console

Précédent
Configurer l'exportation des données de facturation vers BigQuery
Suivant
Exemples de requêtes de données de facturation dans BigQuery