Atualizações no modelo de dados dos CUDs com base em gastos

Importante:esta página explica o novo e aprimorado programa de descontos por compromisso de uso (CUDs), que se aplica a todos os clientes que comprarem os primeiros CUDs baseados em gastos a partir de 15 de julho de 2025. Os clientes podem ativar agora para aproveitar a nova experiência de CUD. Para mais informações, consulte Melhorias no programa de CUDs baseados em gastos.

Como parte da expansão do programa de descontos por compromisso de uso (CUDs), atualizamos o modelo de dados de CUDs com base em gastos e oferecemos ferramentas para ajudar você a se preparar para as mudanças, que incluem:

• Exportação de dados de amostra do BigQuery: um conjunto de dados de amostra que demonstra como ativar muda a aparência das exportações de dados de CUD com base em gastos no BigQuery.
• Exemplos de consultas de KPI de CUD: consultas de exemplo para usar com a exportação de dados de amostra do BigQuery e calcular indicadores principais de desempenho (KPIs) importantes de CUD.
• Novos detalhes de CUD: descrições de novos campos de CUD e migração de dados, por exemplo, novos IDs de SKUs de taxa de CUD, nomes de ofertas e IDs de modelo de consumo.

Exportação de dados de amostra do BigQuery

É possível usar a exportação de dados de amostra do BigQuery para preparar seus sistemas internos para as mudanças que ocorrem nos dados de CUDs com base em gastos. O processo para usar a exportação de dados de amostra tem estas etapas principais:

1. Confira os pré-requisitos.
2. Ative a exportação de dados de amostra.
3. Deixe os novos dados se acumularem.
4. Explore o novo modelo de dados e as consultas.
5. Atualize seus sistemas e fluxos de trabalho internos de acordo com as mudanças.

Pré-requisitos

Você precisa atender aos seguintes pré-requisitos para usar a exportação de dados de amostra:

• Você precisa ter uma exportação de dados de faturamento detalhada ou padrão configurada para sua conta do Cloud Billing. Para mais informações, consulte Configurar a exportação de dados do Cloud Billing para o BigQuery.

• Você precisa ter permissões no projeto proprietário da exportação e na conta do Cloud Billing em que a exportação está sendo ativada. Exemplo:

  • Permissão bigquery.datasets.create no projeto que contém o conjunto de dados.
  • Permissão billing.accounts.getUsageExportSpec na conta do Cloud Billing.

  Para encontrar papéis predefinidos do Cloud Billing que contêm essas permissões, como Leitor da conta de faturamento, Gerente de custos da conta de faturamento ou Administrador da conta de faturamento, consulte Controle de acesso e permissões do Cloud Billing. Para mais informações sobre permissões específicas do BigQuery, consulte Papéis e permissões do BigQuery IAM

• Quando você cria uma conta do Cloud Billing, a atribuição proporcional é ativada por padrão para compromissos baseados em gastos. Caso contrário, você precisa ter ativado essa opção para usar a exportação. Para isso, siga estas instruções.

• Se você usa o VPC Service Controls para recursos do BigQuery no seu projeto ou organização, crie regras de entrada e saída para ativar corretamente as exportações de dados para o BigQuery.

  1. Crie uma regra de entrada que dê acesso à pessoa para criar a exportação:

     
       - 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'
       

     Consulte Identificadores principais para mais informações sobre formatos de identificadores principais.

  2. Crie uma regra de saída para permitir o acesso Google Cloud ao conjunto de dados do BigQuery pelo VPC Service Controls:

     
       - egressTo:
           roles:
           - roles/bigquery.dataOwner
           resources:
           - projects/710382390241
       egressFrom:
           identityType: ANY_IDENTITY
           sources:
           - accessLevel: "*"
           sourceRestriction: RESTRICTION_STATUS
       title: 'Egress Rule Name'
       

  Observação:se você pular esta etapa, vai receber o seguinte erro ao tentar iniciar a exportação: Você não tem permissão para ativar o conjunto de dados.

Ativar a exportação de dados de amostra

Para ativar a exportação de dados de amostra, siga estas etapas:

1. Abra a seção "Exportação de faturamento" do console Google Cloud .

   Acessar a exportação de faturamento

2. Na caixa de diálogo Exportação de faturamento, selecione a conta do Cloud Billing em que você quer ativar a exportação de dados de amostra, conforme mostrado na tela a seguir.

3. O processo de exportação de dados começa e leva aproximadamente um dia para ser ativado. Você vai ver a seguinte nota até que ela esteja pronta: Depois de ativar a exportação de dados de amostra, ela começa a coletar dados do Faturamento do Cloud, com novos dados adicionados continuamente até janeiro de 2026. Aguarde tempo suficiente para que os dados sejam acumulados na exportação antes de atualizar seus sistemas para se alinhar ao novo modelo de dados.

4. Quando a exportação estiver pronta, você vai ver a seguinte notificação na seção "Faturamento" do console do Google Cloud :

   A exportação de dados é criada como um conjunto de dados vinculado no mesmo projeto do BigQuery que contém a exportação detalhada de faturamento, mas usa o projeto de exportação padrão se a exportação detalhada não estiver presente. Como é um conjunto de dados vinculado, não há cobranças extras pela exportação de amostra. Para mais informações, consulte Introdução ao BigQuery Sharing.

5. Clique em Ver conjunto de dados de amostra para abrir o BigQuery no consoleGoogle Cloud , onde é possível executar consultas para entender seus KPIs importantes de CUD.

Observação: se você for um revendedor, use a exportação de dados de amostra para visualizar as mudanças na conta de faturamento escolhida. A Exportação de dados de refaturamento, ativada usando o Partner Sales Console, adota o novo esquema de dados no lançamento do recurso. No entanto, os dados de custo só preenchem essas novas colunas depois que a conta principal ou subconta correspondente ativa o recurso. As subcontas de faturamento precisam ativar a opção separadamente depois que a conta de faturamento principal fizer isso.

Limitações de exportação de amostras

A exportação de dados de amostra é uma ferramenta para ajudar você a se preparar para as mudanças no modelo de dados e usa o esquema detalhado, não o padrão. Ela não substitui as exportações detalhadas ou padrão de produção. Em vez disso, o exemplo permite testar atualizações nas consultas que se ajustam às mudanças no modelo de dados. Essas mudanças no modelo de dados se aplicam igualmente às exportações padrão e detalhadas. A exportação padrão é uma agregação da exportação detalhada e contém muito menos linhas. Essa diferença é devido a duas colunas que aparecem no esquema de exportação detalhada, mas não na exportação padrão:

• resource: uma struct que contém informações sobre recursos.
• assinatura: contém subscription.instance_id.

Se as consultas não usarem essas duas colunas, elas vão funcionar de maneira idêntica nas exportações padrão e detalhada e vão gerar os mesmos resultados. No entanto, uma exceção são as consultas afetadas pelo número de linhas, por exemplo, as que envolvem contagens.

Se as consultas atualizadas gerarem resultados conforme o esperado ao serem testadas com a exportação de amostra, elas também vão gerar os resultados pretendidos quando forem executadas na exportação detalhada ou padrão após a migração.

A exportação de dados de amostra também difere das exportações de dados de produção nestes aspectos importantes:

• Pós-migração: não use as exportações de amostra depois de ativar o novo modelo de dados, porque elas não serão mais precisas.
• Tamanho da saída: devido a diferenças na agregação de dados, o tamanho da exportação de amostra pode variar em relação à exportação real que você vê depois de ativar essas mudanças.
• Métodos de arredondamento: devido a diferenças nos métodos de arredondamento, podem ocorrer pequenas discrepâncias em valores muito pequenos ou em moedas que não sejam o dólar americano.
• Taxas proporcionais: a exportação de amostra pode superestimar os custos da primeira e da última hora de uma compra de CUD porque não considera as taxas de compromisso de hora parcial da mesma forma. A compra de um CUD baseado em gastos faz o rateio da taxa pela primeira hora.
• Recomendação de base de tempo para comparação: ao comparar a exportação de amostra e as de produção, use usage_start_time como base para definir períodos nas duas exportações, e não export_time. O agrupamento por data de partição (o campo export_time) não garante um instantâneo consistente do uso porque os dados de cada exportação são enviados em horários diferentes.
• Atualização de dados: a exportação de amostra é gerada em uma programação com um atraso em comparação com a exportação de produção do BigQuery. Podem ocorrer discrepâncias, principalmente nas datas de uso mais recentes, devido ao tempo de processamento dos dados. Isso acontece porque os dados de uso são preenchidos mais lentamente na exportação de amostra do que na de produção.
  • Recomendação para comparação: não tente fazer comparações em dados de exportação com usage_start_time menos de uma semana.
• Integridade dos dados históricos: o processo que gera a exportação de amostra é separado da exportação padrão. Esse processo pode ser afetado por problemas operacionais ou incidentes de serviço. Em raras ocasiões, isso resultou em dados incompletos ou ausentes na exportação de amostra para intervalos de datas específicos. Por exemplo, a exportação de amostra teve problemas de integridade de dados para exportações datadas entre 6 e 9 de agosto de 2025.
  • Recomendação para comparação: ao validar a exportação de amostra, principalmente para dados históricos, saiba que essas anomalias podem existir. Testar com meses de faturamento mais recentes e completos (por exemplo, setembro de 2025) pode fornecer uma prévia mais precisa.

Exemplo de exportação de dados antes e depois do novo modelo de CUD

O novo modelo de CUD com base em gastos exige que você planeje e ajuste seus sistemas internos que podem consumir dados de faturamento do Cloud. Por isso, apresentamos os seguintes cenários para mostrar como o esquema de exportação de dados e os dados mudam antes e depois do novo modelo de CUD. Além disso, dividimos esses cenários em situações de uso excessivo e insuficiente dos CUDs para mostrar o efeito na exportação de dados.

Observação: os dados de preços nos cenários a seguir são apenas para fins de exemplo. Para conferir os preços mais recentes, consulte Preços do Compute Engine.

Nos dois cenários, considere que você comprou uma VM E2-Standard-8 em US Central 1, que consiste em duas SKUs para RAM e Core. Essas SKUs usam os IDs fictícios RAM SKU e Core SKU, respectivamente.

Em seguida, você compra um 1 Year GCE Flex CUD por US $0,1/h para o cenário de uso excessivo e US $0,3/h para o cenário de uso insuficiente. Eles são representados nos dados como o ID fictício Fee SKU.

Observação: em um cenário real, os valores de ID para SKU e SKU de taxa estariam em um formato de ID de 12 dígitos, por exemplo, F61D-4D51-AAFC.

Cenário de CUD superutilizado

No cenário de uso excessivo, você fez as compras mencionadas anteriormente e usou demais os CUDs.

Data anterior

Antes do novo modelo de CUD, o esquema de exportação e os valores de dados do Cloud Billing eram semelhantes à tabela a seguir.

SKU	cost	usage.amount_in_pricing_units	usage.pricing_unit	price.effective_price	originating-sku ^1	subscription.instance_id	credits
SKU da taxa	0.046868	6.509490	hora	0,0072	SKU de RAM	subscriptions/e52fd279-0851-4f53-a533-093119e27bad	[]
SKU da taxa	0.025132	3.490510	hora	0,0072	SKU principal	subscriptions/e52fd279-0851-4f53-a533-093119e27bad	[]
SKU de RAM	0.174496	8	gibibyte/hora	0.02181159	null	null	[{"amount":-0.065095,"full_name":"Committed use discount - dollar based: GCE Commitments", "type":"COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE"}]
SKU principal	0.093568	32	hora	0,00292353	null	null	[{"amount":-0.034905,"full_name":"Committed use discount - dollar based: GCE Commitments", "type":"COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE"}]

^{1. Essa coluna representa o valor do rótulo goog-originating-sku-id.}

Data após

Depois do novo modelo de CUD, o esquema de exportação e os valores de dados do Cloud Billing vão ficar parecidos com a tabela a seguir.

SKU	cost	usage.amount_in_pricing_units	usage.pricing_unit	consumption_model.description	price.effective_price	originating-sku ^1	subscription.instance_id	credits
SKU da taxa	0.046868	0.046868330	hora	Padrão	1	SKU de RAM	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[{"amount":"-0.046868",""type":"FEE_UTILIZATION_OFFSET"}]
SKU da taxa	0.025132	0.025131670	hora	Padrão	1	SKU principal	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[{"amount":"-0.025132",""type":"FEE_UTILIZATION_OFFSET"}]
SKU de RAM	0,109398	5,015577498	gibibyte/hora	Padrão	0.02181159	null	null	[]
SKU principal	0,058648	20.06066639	hora	Padrão	0,00292353	null	null	[]
SKU de RAM	0.046868	2,984422502	gibibyte/hora	CUDs flexíveis do Compute por um ano	0.01570434	null	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[]
SKU principal	0.025132	11.93933361	hora	CUDs flexíveis do Compute por um ano	0.00210494	null	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[]

^{1. Essa coluna representa o valor do rótulo goog-originating-sku-id.}

Observe o seguinte neste novo modelo de CUD:

• Há duas linhas para cada CUD, em vez de uma para cada.
• Há uma nova coluna consumption_model.description que separa as entradas adicionais de CUD, em que:
  • O valor Compute Flexible CUDs 1 Year indica que você recebeu o desconto esperado do CUD.
  • O valor Default indica que você usou demais o CUD, e seu custo voltou aos preços padrão para o valor excedente. Isso também é indicado pelo fato de subscription.instance_id não ter valor.
  • As linhas de taxa de CUD também têm o valor Default porque os descontos não se aplicam a elas. Em vez disso, o campo credits indica que um desconto negativo foi aplicado para anular a taxa.

Cenário de CUD subutilizado

Para esse cenário de subutilização, presumimos que você fez as compras mencionadas anteriormente e subutilizou os CUDs.

Data anterior

Antes do novo modelo de CUD, o esquema de exportação e os valores de dados do Cloud Billing eram semelhantes à tabela a seguir.

SKU	cost	usage.amount_in_pricing_units	usage.pricing_unit	price.effective_price	originating-sku ^1	subscription.instance_id	credits
SKU da taxa	0.022994	3,194	hora	0,0072	null	subscriptions/e52fd279-0851-4f53-a533-093119e27bad	[]
SKU da taxa	0,125637	17.450	hora	0,0072	SKU de RAM	subscriptions/e52fd279-0851-4f53-a533-093119e27bad	[]
SKU da taxa	0,067369	9.357	hora	0,0072	SKU principal	subscriptions/e52fd279-0851-4f53-a533-093119e27bad	[]
SKU de RAM	0.174496	8	gibibyte/hora	0.02181159	null	null	[{"amount":-0.174496,"full_name":"Committed use discount - dollar based: GCE Commitments", "type":"COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE"}]
SKU principal	0.093568	32	hora	0,00292353	null	null	[{"amount":-0.093568,"full_name":"Committed use discount - dollar based: GCE Commitments", "type":"COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE"}]

^{1. Essa coluna representa o valor do rótulo goog-originating-sku-id.}

Data após

Depois do novo modelo de CUD, o esquema de exportação e os valores de dados do Cloud Billing vão ficar parecidos com a tabela a seguir.

SKU	cost	usage.amount_in_pricing_units	usage.pricing_unit	price.effective_price	consumption_model.description	originating-sku ^1	subscription.instance_id	credits
SKU da taxa	0.022994	0,0230	hora	1	Padrão	null	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[]
SKU da taxa	0,125637	0,1256371	hora	1	Padrão	SKU de RAM	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[{"amount":"-0.1256348",""type":"FEE_UTILIZATION_OFFSET"}]
SKU da taxa	0,067369	0.0673690	hora	1	Padrão	SKU principal	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[{"amount":"-0.0673581",""type":"FEE_UTILIZATION_OFFSET"}]
SKU de RAM	0,125637	8	gibibyte/hora	0.0157043448	CUDs flexíveis do Compute por um ano	null	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[]
SKU principal	0,067369	32	hora	0.0021049416	CUDs flexíveis do Compute por um ano	null	subscriptions/1fd3b130-40f8-4a79-ac6f-5753aaa0ceeb	[]

^{1. Essa coluna representa o valor do rótulo goog-originating-sku-id.}

Observe o seguinte neste novo modelo de CUD:

• Há duas linhas para cada CUD, em vez de uma para cada.
• Há uma nova coluna consumption_model.description que separa as entradas adicionais de CUD, em que:
  • O valor Compute Flexible CUDs 1 Year indica que você recebeu o desconto esperado do CUD.
  • O valor Default indica as linhas de taxa de CUD, porque os descontos não se aplicam a elas. Em vez disso, o campo credits indica que um valor negativo foi aplicado para negar as taxas, que foram acumuladas na primeira linha.
• A primeira linha mostra uma soma das taxas de CUD.

Exemplos de consultas para KPIs principais de CUD

Para exemplos de consultas que mostram como usar métricas de KPI para validar se os sistemas estão funcionando bem com o novo modelo de dados, consulte Exemplos de consultas para o novo modelo de dados de CUDs.

Exportação do Cloud Billing para o BigQuery

A exportação de dados padrão, detalhada e de refaturamento (somente revendedor) do Cloud Billing para o BigQuery tem os seguintes campos novos ou alterados:

Campo	Tipo	Novo ou atualizado
price	Struct	Existente (sem mudança na exportação detalhada ou de refaturamento, adicionando à exportação padrão)
price.list_price	Numérico	Novo campo
price.effective_price_default	Numérico	Novo campo
price.list_price_consumption_model	Numérico	Novo campo
price.effective_price	Numérico	Existente (descrição atualizada na exportação detalhada e de refaturamento; adicionada à exportação padrão).
price.tier_start_amount	Numérico	Já existe na exportação detalhada e será adicionado à exportação padrão.
price.unit	String	Já existe na exportação detalhada e será adicionado à exportação padrão.
price.pricing_unit_quantity	Numérico	Já existe na exportação detalhada e será adicionado à exportação padrão.
cost_at_list	Numérico	Campo atual, descrição atualizada para refletir as mudanças.
cost	Numérico	Campo atual, descrição atualizada para refletir as mudanças.
cost_at_effective_price_default	Numérico	Novo
cost_at_list_consumption_model	Numérico	Novo
consumption_model	Struct	Novo
consumption_model.id	String	Novo
consumption_model.description	String	Novo

Mudanças na exportação de preços

A exportação de preços do Cloud Billing para o BigQuery adiciona ou muda estes campos para informações de preços:

Campo	Tipo	Novo/Atualizado
list_price	Struct	Atualizado
billing_account_price	Struct	Atualizado
consumption_model_prices	Lista de structs	Novo
consumption_model_prices.consumption_model_id	String	Novo
consumption_model_prices.consumption_model_display_name	String	Novo
consumption_model_prices.list_price.tiered_rates.start_usage_amount	Ponto flutuante	Novo
consumption_model_prices.list_price.tiered_rates.usd_amount	Numérico	Novo
consumption_model_prices.billing_account_price.tiered_rates.start_usage_amount	Ponto flutuante	Novo
consumption_model_prices.billing_account_price.tiered_rates.usd_amount	Numérico	Novo

Novas informações sobre produtos de CUD

As novas SKUs de taxa de CUD substituem as atuais, e os novos IDs de oferta e de modelo de consumo se aplicam a todos os CUDs no escopo. Use os detalhes a seguir para ajustar suas consultas e painéis.

Migração de ofertas e ID do modelo de consumo

Para conferir uma lista das ofertas e dos IDs de modelo de consumo que serão migrados do modelo de dados de CUD antigo para o novo, consulte SKUs, ofertas e IDs de modelo de consumo de CUD migrados.

Migração do ID da SKU da taxa de CUD

Para conferir uma lista de IDs de SKU de taxa de CUD e IDs de modelo de consumo que migram do modelo de dados antigo para o novo, consulte SKUs, ofertas e IDs de modelo de consumo de CUD migrados.

Temas relacionados

• Melhorias no programa de CUDs com base em gastos
• Cronogramas para a migração do novo modelo de CUD
• Verificar seus descontos após a migração
• Escolher a quantidade certa de CUD para comprar
• Exemplos de consultas para o novo modelo de dados de CUDs
• SKUs, ofertas e IDs de modelo de consumo de CUD migrados
• Melhorias na interface do usuário de faturamento