Mises à jour du modèle de données des remises sur engagement d'utilisation basées sur les dépenses

Dans le cadre de l'expansion du programme de remises sur engagement d'utilisation (CUD), nous mettons à jour le modèle de données des CUD basées sur les dépenses et fournissons des outils pour vous aider à vous préparer aux changements, qui incluent :

Exemple d'exportation de données BigQuery

Vous pouvez utiliser l'exemple d'exportation de données BigQuery pour préparer vos systèmes internes aux modifications apportées à vos données de remises sur engagement d'utilisation basées sur les dépenses. Pour utiliser l'exemple d'exportation de données, vous devez suivre les étapes principales suivantes :

  1. Vérifiez les conditions préalables.
  2. Activez l'exportation des exemples de données.
  3. Laissez les nouvelles données s'accumuler.
  4. Explorez le nouveau modèle de données et les nouvelles requêtes.
  5. Mettez à jour vos systèmes et workflows internes en conséquence.

Prérequis

Pour utiliser l'exemple d'exportation de données, vous devez remplir les conditions préalables suivantes :

  • Vous devez avoir configuré une exportation détaillée ou standard des données de facturation pour votre compte de facturation Cloud. Pour en savoir plus, consultez Configurer l'exportation des données Cloud Billing vers BigQuery.

  • Vous devez disposer d'autorisations sur le projet propriétaire de l'exportation et sur le compte de facturation Cloud sur lequel vous activez l'exportation. Exemple :

    • Autorisation bigquery.datasets.create sur le projet contenant l'ensemble de données.
    • Autorisation billing.accounts.getUsageExportSpec sur le compte de facturation Cloud.

    Pour trouver les rôles Cloud Billing prédéfinis qui contiennent ces autorisations (par exemple, Lecteur de compte de facturation, Gestionnaire des coûts du compte de facturation ou Administrateur de compte de facturation), consultez Contrôle des accès et autorisations Cloud Billing. Pour en savoir plus sur les autorisations spécifiques à BigQuery, consultez Rôles et autorisations IAM BigQuery.

  • Lorsque vous créez un compte de facturation Cloud, l'attribution proportionnelle est activée par défaut pour les engagements basés sur les dépenses. Sinon, vous devez l'avoir activée pour utiliser cette exportation. Pour ce faire, suivez ces instructions.

  • Si vous utilisez VPC Service Controls pour les ressources BigQuery de votre projet ou de votre organisation, vous devez créer des règles d'entrée et de sortie pour activer correctement les exportations de données vers BigQuery.

    1. Créez une règle d'entrée qui donne à la personne l'accès nécessaire pour créer l'exportation : 
      
  - ingressFrom:
      identities:
      - PRINCIPAL_IDENTIFIER_OF_USER_INITIATING_EXPORT
      sources:
      - accessLevel: "*"
  ingressTo:
      roles:
      - roles/bigquery.dataOwner
      resources:
      - projects/YOUR_PROJECT_ID_TO_HOST_EXPORT_DATA
  title: 'Ingress Rule Name'

      Pour en savoir plus sur les formats des identifiants principaux, consultez Identifiants principaux.

    2. Créez une règle de sortie pour autoriser l'accès Google Cloud à l'ensemble de données BigQuery via VPC Service Controls : 
      
  - egressTo:
      roles:
      - roles/bigquery.dataOwner
      resources:
      - projects/710382390241
  egressFrom:
      identityType: ANY_IDENTITY
      sources:
      - accessLevel: "*"
      sourceRestriction: RESTRICTION_STATUS
  title: 'Egress Rule Name'

Activer l'exportation des exemples de données

Pour activer l'exportation des exemples de données, procédez comme suit :

  1. Ouvrez la section "Exportation de la facturation" de la console Google Cloud .

    Accéder à l'exportation de la facturation

  2. Dans la boîte de dialogue Exportation de la facturation, sélectionnez le compte de facturation Cloud pour lequel vous souhaitez activer l'exportation des exemples de données, comme illustré dans l'écran suivant. Boîte de dialogue utilisée pour sélectionner le compte

  3. Le processus d'exportation des données commence et prend environ une journée. Le message suivant s'affichera jusqu'à ce que l'exemple d'exportation soit prêt : Écran affichant le message indiquant que l'exportation des exemples de données n'est pas prête Une fois l'exemple d'exportation de données activé, la collecte des données Cloud Billing commence. De nouvelles données sont ajoutées en continu jusqu'en janvier 2026. Laissez suffisamment de temps pour que suffisamment de données s'accumulent dans l'exportation avant de mettre à jour vos systèmes pour les aligner sur le nouveau modèle de données.

  4. Lorsque l'exportation est prête, la notification suivante s'affiche dans la section "Facturation" de la console Google Cloud  : Écran affichant le message indiquant que l'exportation des exemples de données est prête

    L'exportation de données est créée en tant qu'ensemble de données associé dans le même projet BigQuery que celui qui contient votre exportation détaillée de la facturation. Toutefois, elle utilise le projet d'exportation standard si l'exportation détaillée n'est pas présente. Comme il s'agit d'un ensemble de données associé, vous n'encourrez pas de frais supplémentaires pour l'exportation d'échantillons. Pour en savoir plus, consultez Présentation de BigQuery Sharing.

  5. Cliquez sur Afficher l'exemple de jeu de données pour ouvrir BigQuery dans la consoleGoogle Cloud , où vous pourrez exécuter des requêtes pour comprendre vos KPI importants liés aux CUD.

Exemples de limites d'exportation

L'exportation d'échantillons de données est un outil qui vous aide à vous préparer aux modifications du modèle de données. Il utilise le schéma détaillé, et non le schéma standard. Il ne remplace pas les exportations détaillées ou standards de production. Au lieu de cela, l'exemple vous permet de tester les modifications apportées à vos requêtes qui s'adaptent aux changements du modèle de données. Ces modifications du modèle de données s'appliquent de la même manière aux exportations standard et détaillées. L'exportation standard est une agrégation de l'exportation détaillée et contient beaucoup moins de lignes. Cette différence est due à deux colonnes qui figurent dans le schéma d'exportation détaillée, mais pas dans l'exportation standard :

  • resource : structure contenant des informations sur les ressources.
  • Abonnement : contient subscription.instance_id.

Si vos requêtes n'utilisent pas ces deux colonnes, elles fonctionnent de manière identique dans les exportations standards et détaillées, et produisent les mêmes résultats. Toutefois, les requêtes affectées par le nombre de lignes (par exemple, les requêtes impliquant des nombres) font exception.

Si vos requêtes mises à jour génèrent les résultats attendus lors des tests effectués sur l'exemple d'exportation, vous pouvez vous attendre à ce qu'elles génèrent les résultats souhaités lorsqu'elles seront exécutées sur l'exportation détaillée ou standard après la migration.

L'exportation d'exemples de données diffère également des exportations de données de production de plusieurs façons importantes :

  • Après la migration : n'utilisez pas les exemples d'exportation après avoir activé le nouveau modèle de données, car ils ne seront plus précis.
  • Taille de la sortie : en raison des différences d'agrégation des données, la taille de l'exportation d'échantillon peut varier par rapport à l'exportation réelle que vous voyez après avoir activé ces modifications.
  • Méthodes d'arrondi : en raison des différences de méthodes d'arrondi, de légers écarts peuvent se produire pour les montants très faibles ou les devises autres que l'USD.
  • Frais au prorata : l'exemple d'exportation peut surestimer les coûts de la première et de la dernière heure d'un achat de CUD, car il ne tient pas compte des frais d'engagement partiels de la même manière. Si vous achetez une remise sur engagement d'utilisation basée sur les dépenses, les frais de la première heure sont calculés au prorata.
  • Recommandation Time Basis pour la comparaison : lorsque vous comparez l'exportation d'échantillon et les exportations de production, utilisez usage_start_time comme base pour définir les périodes dans les deux exportations, et non export_time. Le regroupement par date de partition (champ export_time) ne garantit pas un instantané cohérent de l'utilisation, car les données de chaque exportation sont importées à des moments différents.
  • Actualité des données : l'exportation d'échantillons est générée selon une programmation avec un délai par rapport à votre exportation BigQuery de production. Des écarts peuvent se produire, en particulier pour les dates d'utilisation les plus récentes, en raison du calendrier de traitement des données. En effet, les données d'utilisation sont renseignées plus lentement dans l'exportation d'échantillon que dans l'exportation de production.
    • Recommandation pour les comparaisons : n'essayez pas de comparer des données exportées datant de moins d'une semaine.usage_start_time
  • Exhaustivité des données historiques : le processus de génération de l'exemple d'exportation est distinct de l'exportation standard. Ce processus peut être affecté par des problèmes opérationnels ou des incidents de service. Dans de rares cas, cela a entraîné des données incomplètes ou manquantes dans l'exportation d'échantillons pour des plages de dates spécifiques. Par exemple, l'exemple d'exportation a rencontré des problèmes d'exhaustivité des données pour les exportations datées entre le 6 et le 9 août 2025.
    • Recommandation pour la comparaison : lorsque vous validez l'exportation d'échantillons, en particulier pour les données historiques, sachez que de telles anomalies peuvent exister. Pour obtenir un aperçu plus précis, vous pouvez effectuer des tests avec des mois de facturation complets plus récents (par exemple, septembre 2025).

Exemple d'exportation de données avant et après le nouveau modèle de CUD

Le nouveau modèle de remises sur engagement d'utilisation basées sur les dépenses vous oblige à planifier et à ajuster vos systèmes internes susceptibles de consommer des données Cloud Billing. Par conséquent, nous fournissons les scénarios suivants pour montrer comment le schéma d'exportation des données et les données changent, avant et après le nouveau modèle CUD. Nous divisons ensuite ces scénarios en situations où vous surutilisez et sous-utilisez vos CUD pour montrer l'effet sur l'exportation de données.

Dans les deux scénarios, supposons que vous ayez acheté une VM E2-Standard-8 dans US Central 1, composée de deux SKU pour la RAM et les cœurs. Ces SKU utilisent les ID fictifs RAM SKU et Core SKU, respectivement.

Vous achetez ensuite un 1 Year GCE Flex CUD pour 0,1 $/h dans le cas d'une utilisation excessive et pour 0,3 $/h dans le cas d'une utilisation insuffisante. Dans les données, ils sont représentés par l'ID fictif Fee SKU.

Scénario de remise sur engagement d'utilisation surutilisée

Dans le scénario de surutilisation, vous avez effectué les achats mentionnés précédemment et surutilisé les CUD.

Données "avant"

Avant le nouveau modèle de remise sur engagement d'utilisation, le schéma d'exportation et les valeurs de données Cloud Billing se présentent comme dans le tableau ci-dessous.

SKU cost usage.amount_in_pricing_units usage.pricing_unit price.effective_price originating-sku 1 subscription.instance_id credits
SKU des frais 0.046868 6.509490 heure 0,0072 SKU RAM subscriptions/e52fd279-0851-4f53-a533-093119e27bad []
SKU des frais 0.025132 3,490510 heure 0,0072 SKU principal subscriptions/e52fd279-0851-4f53-a533-093119e27bad []
SKU RAM 0.174496 8 gibioctet-heure 0.02181159 null null [{"amount":-0.065095,"full_name":"Remise sur engagement d'utilisation - en dollars : engagements GCE", "type":"COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE"}]
SKU principal 0,093568 32 heure 0.00292353 null null [{"amount":-0.034905,"full_name":"Remise sur engagement d'utilisation - en dollars : engagements GCE", "type":"COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE"}]

1. Cette colonne représente la valeur du libellé goog-originating-sku-id.

Données après

Après le nouveau modèle de CUD, le schéma et les valeurs de données de votre exportation Cloud Billing ressemblent à ceux du tableau suivant.

SKU cost usage.amount_in_pricing_units usage.pricing_unit consumption_model.description price.effective_price originating-sku 1 subscription.instance_id credits
SKU des frais 0.046868 0.046868330 heure Par défaut 1 SKU RAM subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb [{"amount":"-0.046868",""type":"FEE_UTILIZATION_OFFSET"}]
SKU des frais 0.025132 0.025131670 heure Par défaut 1 SKU principal subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb [{"amount":"-0.025132",""type":"FEE_UTILIZATION_OFFSET"}]
SKU RAM 0.109398 5.015577498 gibioctet-heure Par défaut 0.02181159 null null []
SKU principal 0.058648 20.06066639 heure Par défaut 0.00292353 null null []
SKU RAM 0.046868 2.984422502 gibioctet-heure Remises sur engagement d'utilisation flexibles Compute Engine de 1 an 0.01570434 null subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb []
SKU principal 0.025132 11.93933361 heure Remises sur engagement d'utilisation flexibles Compute Engine de 1 an 0.00210494 null subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb []

1. Cette colonne représente la valeur du libellé goog-originating-sku-id.

Notez les points suivants dans ce nouveau modèle CUD :

  • Il y a deux lignes pour chaque CUD, au lieu d'une.
  • Une nouvelle colonne consumption_model.description sépare les entrées CUD supplémentaires, où :
    • La valeur Compute Flexible CUDs 1 Year indique que vous avez bénéficié de la remise sur engagement d'utilisation attendue.
    • La valeur Default indique que vous avez dépassé votre engagement d'utilisation et que votre coût est revenu au prix par défaut pour le montant du dépassement. Cela est également indiqué par l'absence de valeur pour subscription.instance_id.
    • Les lignes de frais CUD ont également la valeur Default, car les remises ne s'y appliquent pas. Le champ credits indique qu'un décalage négatif a été appliqué pour annuler les frais.

Scénario de remise sur engagement d'utilisation sous-utilisée

Pour ce scénario de sous-utilisation, nous partons du principe que vous avez effectué les achats mentionnés précédemment et que vous avez sous-utilisé les CUD.

Données "avant"

Avant le nouveau modèle de remise sur engagement d'utilisation, le schéma et les valeurs de données de votre exportation Cloud Billing se présentent comme dans le tableau ci-dessous.

SKU cost usage.amount_in_pricing_units usage.pricing_unit price.effective_price originating-sku 1 subscription.instance_id credits
SKU des frais 0.022994 3.194 heure 0,0072 null subscriptions/e52fd279-0851-4f53-a533-093119e27bad []
SKU des frais 0.125637 17.450 heure 0,0072 SKU RAM subscriptions/e52fd279-0851-4f53-a533-093119e27bad []
SKU des frais 0.067369 9.357 heure 0,0072 SKU principal subscriptions/e52fd279-0851-4f53-a533-093119e27bad []
SKU RAM 0.174496 8 gibioctet-heure 0.02181159 null null [{"amount":-0.174496,"full_name":"Remise sur engagement d'utilisation - en dollars : engagements GCE", "type":"COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE"}]
SKU principal 0,093568 32 heure 0.00292353 null null [{"amount":-0.093568,"full_name":"Remise sur engagement d'utilisation - en dollars : engagements GCE", "type":"COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE"}]

1. Cette colonne représente la valeur du libellé goog-originating-sku-id.

Données après

Après le nouveau modèle de CUD, le schéma et les valeurs de données de votre exportation Cloud Billing ressemblent à ceux du tableau suivant.

SKU cost usage.amount_in_pricing_units usage.pricing_unit price.effective_price consumption_model.description originating-sku 1 subscription.instance_id credits
SKU des frais 0.022994 0,0230 heure 1 Par défaut null subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb []
SKU des frais 0.125637 0.1256371 heure 1 Par défaut SKU RAM subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb [{"amount":"-0.1256348",""type":"FEE_UTILIZATION_OFFSET"}]
SKU des frais 0.067369 0.0673690 heure 1 Par défaut SKU principal subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb [{"amount":"-0.0673581",""type":"FEE_UTILIZATION_OFFSET"}]
SKU RAM 0.125637 8 gibioctet-heure 0.0157043448 Remises sur engagement d'utilisation flexibles Compute Engine de 1 an null subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb []
SKU principal 0.067369 32 heure 0.0021049416 Remises sur engagement d'utilisation flexibles Compute Engine de 1 an null subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb []

1. Cette colonne représente la valeur du libellé goog-originating-sku-id.

Notez les points suivants dans ce nouveau modèle CUD :

  • Il y a deux lignes pour chaque CUD, au lieu d'une.
  • Une nouvelle colonne consumption_model.description sépare les entrées CUD supplémentaires, où :
    • La valeur Compute Flexible CUDs 1 Year indique que vous avez bénéficié de la remise sur engagement d'utilisation attendue.
    • La valeur Default indique les lignes de frais liés aux remises sur engagement d'utilisation, car les remises ne s'y appliquent pas. Au lieu de cela, le champ credits indique qu'un décalage négatif a été appliqué pour annuler les frais, qui ont été cumulés dans la première ligne.
  • La première ligne affiche la somme des frais d'utilisation cumulée.

Exemples de requêtes pour les principaux KPI de CUD

Pour obtenir des exemples de requêtes montrant comment utiliser les métriques de KPI pour valider le bon fonctionnement de vos systèmes avec le nouveau modèle de données, consultez Exemples de requêtes pour le nouveau modèle de données CUD.

Exportation Cloud Billing vers BigQuery

Les exportations Cloud Billing vers BigQuery (standard, détaillé et refacturation (revendeur uniquement)) comportent les champs nouveaux ou modifiés suivants :

Champ Type Nouveaux ou modifiés
price Struct Existant (aucune modification de l'exportation détaillée ou de refacturation, ajout à l'exportation standard)
price.list_price Numérique Nouveau champ
price.effective_price_default Numérique Nouveau champ
price.list_price_consumption_model Numérique Nouveau champ
price.effective_price Numérique Existant (description mise à jour dans l'exportation détaillée et de refacturation ; ajout à l'exportation standard)
price.tier_start_amount Numérique Déjà disponible dans l'exportation détaillée, ajoutée à l'exportation standard.
price.unit Chaîne Déjà disponible dans l'exportation détaillée, ajoutée à l'exportation standard.
price.pricing_unit_quantity Numérique Déjà disponible dans l'exportation détaillée, ajoutée à l'exportation standard.
cost_at_list Numérique Champ existant, description mise à jour pour refléter les modifications.
cost Numérique Champ existant, description mise à jour pour refléter les modifications.
cost_at_effective_price_default Numérique Nouveau
cost_at_list_consumption_model Numérique Nouveau
consumption_model Struct Nouveau
consumption_model.id Chaîne Nouveau
consumption_model.description Chaîne Nouveau

Modifications apportées à l'exportation des prix

L'exportation des tarifs Cloud Billing vers BigQuery ajoute ou modifie les champs suivants pour les informations tarifaires :

Champ Type Nouveautés/Modifications
list_price Struct Mis à jour
billing_account_price Struct Mis à jour
consumption_model_prices Liste de structs Nouveau
consumption_model_prices.consumption_model_id Chaîne Nouveau
consumption_model_prices.consumption_model_display_name Chaîne Nouveau
consumption_model_prices.list_price.tiered_rates.start_usage_amount Float Nouveau
consumption_model_prices.list_price.tiered_rates.usd_amount Numérique Nouveau
consumption_model_prices.billing_account_price.tiered_rates.start_usage_amount Float Nouveau
consumption_model_prices.billing_account_price.tiered_rates.usd_amount Numérique Nouveau

Nouvelles informations sur les produits CUD

Les nouveaux SKU de frais pour la remise sur engagement d'utilisation remplacent les SKU existants. De nouveaux ID d'offre et d'ID de modèle de consommation s'appliquent à toutes les remises sur engagement d'utilisation concernées. Vous pouvez utiliser les informations suivantes pour ajuster vos requêtes et vos tableaux de bord.

Migration des offres et des ID de modèle de consommation

Pour obtenir la liste des offres et des ID de modèle de consommation qui seront migrés de l'ancien modèle de données pour les remises sur engagement d'utilisation vers le nouveau modèle de données, consultez ID de SKU, d'offres et de modèle de consommation pour les remises sur engagement d'utilisation migrés.

Migration des ID de SKU de frais de remise sur engagement d'utilisation

Pour afficher la liste des ID de SKU de frais de remise sur engagement d'utilisation et des ID de modèle de consommation qui migrent de l'ancien vers le nouveau modèle de données, consultez ID de SKU, d'offres et de modèle de consommation pour la remise sur engagement d'utilisation migrés.