Noções básicas sobre as tabelas de dados do Cloud Billing no BigQuery

Nesta página, você verá informações de referência sobre o esquema dos dados do Cloud Billing exportados para cada tabela no BigQuery.

Tabelas de dados de faturamento

Logo depois de ativar a exportação do Cloud Billing para o BigQuery, as tabelas de dados de faturamento são criadas automaticamente no conjunto de dados do BigQuery.

Frequência de carregamentos de dados

Exportação diária de detalhes de custo:

  • Quando você ativa a exportação diária de detalhes de custo para o BigQuery, os dados de custo do Google Cloud podem levar algumas horas para serem exibidos.
  • Os serviços do Google Cloud informam dados de uso e custo para processos do Cloud Billing em intervalos variados.
  • O Cloud Billing exporta dados de uso e custo para seu conjunto de dados do BigQuery em intervalos regulares. Não há garantias de entrega ou latência para a exportação para o BigQuery.
  • Como a frequência de relatórios de uso varia de acordo com o serviço do Google Cloud, talvez você não veja dados de uso e custo do Cloud Billing de imediato para todos os serviços do Google Cloud usados recentemente.

Exportação de preços:

  • Quando você ativa a exportação de preços para o BigQuery pela primeira vez, pode levar até 48 horas para começar a ver seus dados de preços do Google Cloud.
  • Depois de ativar a exportação de preços, os dados de preços aplicáveis à sua conta de faturamento do Cloud são exportados para o BigQuery uma vez por dia.

Disponibilidade de dados:

  • O conjunto de dados do BigQuery só reflete os dados do Faturamento do Cloud incorridos a partir da data em que você ativou e exportou pela primeira vez. Os dados do Faturamento do Cloud não são adicionados retroativamente. Por isso, você não verá os dados do Faturamento do Cloud referentes ao uso que ocorreram antes da exportação.
  • Se você excluir dados exportados, como os registros de exportação do BigQuery, não será possível preencher os registros excluídos.
  • Os carregamentos do BigQuery são compatíveis com ACID (em inglês). Portanto, se você consultar o conjunto de dados de exportação do Faturamento do Cloud do BigQuery enquanto os dados estiverem sendo carregados nele, não encontrará dados parcialmente carregados. Saiba mais sobre as características do BigQuery.
  • Veja outras limitações que podem afetar a exportação dos dados de faturamento para o BigQuery, como conjuntos de dados com chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) ativadas.

Esquema dos dados detalhados de custo diário

No conjunto de dados do BigQuery, os dados detalhados de custo do Google Cloud são carregados em uma tabela de dados denominada gcp_billing_export_v1_<BILLING_ACCOUNT_ID>.

As informações a seguir descrevem o esquema dos dados de custo diários do Google Cloud que são exportados para o BigQuery.

Campo Tipo Descrição
billing_account_id String

O ID da Conta de faturamento do Cloud ao qual o uso está associado.

Para revendedores: no caso de custos de uso gerados por uma subconta de faturamento do Cloud, trata-se do ID da subconta (não o ID da Conta de faturamento do Cloud do revendedor pai).

invoice.month String

O ano e o mês (AAAAMM) da fatura que inclui os itens de linha de custo. Por exemplo: "201901" equivale a janeiro de 2019.

Use este campo para ver as cobranças totais na fatura. Consulte Exemplos de consultas para exportação do Faturamento do Cloud para o BigQuery.

cost_type String

O tipo de custo representado por este item de linha: erro regular, imposto, ajuste ou arredondamento.

service.id String O código do serviço que está associado ao uso.
service.description String O serviço do Google Cloud que relatou os dados do Faturamento do Cloud.
sku.id String O ID do recurso usado pelo serviço. Para ver a lista completa de SKUs, consulte SKUs do Google Cloud.
sku.description String Uma descrição do tipo de recurso usado pelo serviço. Por exemplo, um tipo de recurso do Cloud Storage é o armazenamento padrão dos EUA.
usage_start_time Carimbo de data/hora O horário de início da janela de uso por hora em que o custo determinado foi calculado. O uso e os custos de todos os serviços são exibidos com granularidade de hora em hora, o que significa que o uso do serviço de longa duração está distribuído em várias janelas horárias.

Para mais informações, consulte a documentação do BigQuery sobre os tipos de dados de carimbo de data/hora. Consulte também Diferenças entre os dados exportados e as faturas abaixo.

usage_end_time Carimbo de data/hora O horário de término da janela de uso por hora em que o custo determinado foi calculado. O uso e os custos de todos os serviços são exibidos com granularidade de hora em hora, o que significa que o uso do serviço de longa duração está distribuído em várias janelas horárias.

Para mais informações, consulte a documentação do BigQuery sobre os tipos de dados de carimbo de data/hora. Consulte também Diferenças entre os dados exportados e as faturas abaixo.

project Struct project contém campos que descrevem o projeto do Cloud Billing, como ID, número, nome, números de ancestralidade e rótulos.
project.id String O ID do projeto do Google Cloud que gerou os dados do Faturamento do Cloud.
project.number String Um identificador exclusivo, anônimo e gerado internamente para o projeto do Google Cloud que produziu os dados do Faturamento do Cloud. Nos casos de suporte e em outras comunicações com o cliente, o Google se referirá ao seus projetos com esse número.
project.name String O nome do projeto do Google Cloud que gerou os dados do Faturamento do Cloud.
project.ancestry_numbers String Os ancestrais na hierarquia de recursos do projeto identificado pelo project.id especificado (por exemplo, my-project-123).

Por exemplo: /ParentOrgNumber/ParentFolderNumber/. Saiba mais sobre a Hierarquia de recursos.

project.labels.key String Se houver rótulos, é a parte chave no par de chave-valor que compreende o rótulo no projeto do Google Cloud em que ocorreu o uso. Para mais informações sobre o uso de rótulos, consulte Como usar rótulos.
project.labels.value String Se houver rótulos, é a parte valor no par de chave-valor que compreende o rótulo no projeto do Google Cloud em que ocorreu o uso. Para mais informações sobre o uso de rótulos, consulte Como usar rótulos.
labels.key String Se houver rótulos, é a parte chave no par de chave-valor que compreende o rótulo no recurso do Google Cloud em que ocorreu o uso. Para mais informações sobre o uso de rótulos, consulte Como usar rótulos.
labels.value String Se houver rótulos, é a parte valor no par de chave-valor que compreende o rótulo no recurso do Google Cloud em que ocorreu o uso. Para mais informações sobre o uso de rótulos, consulte Como usar rótulos.
system_labels.key String Se houver rótulos do sistema, é a parte chave no par de chave-valor que compreende o rótulo gerado pelo sistema no recurso onde o uso ocorreu. Consulte também Rótulos do sistema disponíveis.
system_labels.value String Se houver rótulos do sistema, é a parte valor no par de chave-valor que compreende o rótulo gerado pelo sistema no recurso onde o uso ocorreu. Consulte também Rótulos do sistema disponíveis.
location.location String Local do uso no nível de um país, região ou zona, ou global para recursos que não têm local específico. Veja mais informações em Regiões e zonas.
location.country String Quando location.location é um país, região ou zona, este campo é o país de uso, por exemplo, US. Veja mais informações em Regiões e zonas.
location.region String Quando location.location é um país ou uma região, este campo é a região de uso, por exemplo, us-central1. Veja mais informações em Regiões e zonas.
location.zone String Quando location.location é uma zona, este campo é a zona de uso, por exemplo, us-central1-a. Veja mais informações em Regiões e zonas.
cost Float O custo do uso antes de qualquer crédito, para uma precisão de até seis casas decimais. Para conseguir o custo total, incluindo os créditos, é preciso incluir credits.amount no custo. Veja esta consulta de exemplo para mais informações.
currency String A moeda em que o custo é cobrado. Para mais informações, consulte Moeda local para faturamento e pagamentos.
currency_conversion_rate Ponto flutuante A taxa de câmbio de dólares americanos para a moeda local. Ou seja, cost ÷ currency_conversion_rate é o custo em dólares americanos.
usage.amount Ponto flutuante A quantidade de usage.unit usada.
usage.unit String A unidade base em que o uso do recurso é medido. Por exemplo, a unidade base para armazenamento padrão é byte-segundos.
usage.amount_in_pricing_units Ponto flutuante A quantidade de usage.pricing_unit usada.
usage.pricing_unit String A unidade em que o uso de recursos é medido, de acordo com a API Cloud Billing Catalog.
credits Struct credits contém campos que descrevem a estrutura e o valor dos créditos associados às SKUs do Google Cloud e da Plataforma Google Maps.
credits.id String Se presente, indica que um crédito está associado à SKU do produto. Os valores de credits.id são um identificador alfanumérico exclusivo (por exemplo, 12-b34-c56-d78) ou uma descrição do tipo de crédito (como Desconto por uso contínuo: CPU).

Se o campo credits.id estiver vazio, a SKU do produto não está associada a um crédito.

credits.full_name String O nome do crédito associado à SKU do produto. Esta é uma descrição legível de um credits.id alfanumérico. Por exemplo: Crédito de avaliação gratuita ou Desconto por uso contínuo com base em gastos.

Os valores credits.full_name estão presentes apenas para SKUs com um credits.id alfanumérico. Se o valor de credits.id for uma descrição do tipo de crédito (como Desconto por uso contínuo: CPU), o campo credits.full_name estará vazio.

credits.type String Este campo descreve a finalidade ou a origem do credits.id. Os tipos de crédito incluem:
  • COMMITTED_USAGE_DISCOUNT: Contratos por uso contínuo com base em recursos para o Compute Engine em retorno a preços com muito desconto para uso da VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: Contratos por uso contínuo com base em gastos adquiridos para serviços em troca do seu compromisso em gastar um valor mínimo.
  • DISCOUNT: o tipo de crédito com desconto é usado para créditos recebidos após um limite de gastos contratual ser atingido. Nos relatórios do Cloud Billing disponíveis no Console do Cloud, o tipo de crédito com desconto é listado como Descontos com base em gastos (contratuais).
  • FREE_TIER: alguns serviços oferecem uso gratuito de recursos até os limites especificados. Nesses serviços, os créditos são aplicados para implementar o uso de nível gratuito.
  • PROMOTION: o tipo de crédito promocional inclui Teste gratuito do Google Cloud e créditos de campanha de marketing ou outras concessões para usar o Google Cloud. Quando disponíveis, os créditos promocionais são considerados uma forma de pagamento e são aplicados automaticamente para reduzir a fatura total.
  • RESELLER_MARGIN: se você for um revendedor, o tipo de crédito de margem de revendedor indica os descontos do Programa de revendedores ganhos em cada item de linha qualificado.
  • SUBSCRIPTION_BENEFIT: créditos ganhos ao adquirir assinaturas de longo prazo para serviços em troca de descontos.
  • SUSTAINED_USAGE_DISCOUNT: o tipo de crédito de descontos por uso prolongado é um desconto automático que você ganha pela execução de recursos específicos do Compute Engine em uma parte significativa do faturamento do mês.
credits.name String Uma descrição do crédito aplicado à conta de faturamento do Cloud.
credits.amount Ponto flutuante Valor do crédito aplicado ao uso. Os créditos são sempre valores negativos.
adjustment_info Struct adjustment_info contém campos que descrevem a estrutura e o valor de um ajuste nos itens de linha de custo associados a uma conta do Cloud Billing.

Os valores adjustment_info só estarão presentes se o item de linha de custo for gerado para uma modificação do Faturamento do Cloud. Pode ocorrer uma modificação por motivos de correção ou não. O tipo adjustment_info contém detalhes sobre o ajuste, caso tenha sido emitido para corrigir um erro ou outros motivos.

adjustment_info.id string Se presente, indica que um ajuste está associado a um item de linha de custo. adjustment_info.id é o ID exclusivo de todos os ajustes associados causados por um problema.
adjustment_info.description string A descrição do ajuste e a causa.
adjustment_info.type String

O tipo de ajuste.

As tarefas incluem:

  • USAGE_CORRECTION: uma correção devido ao uso informado incorretamente.
  • PRICE_CORRECTION: uma correção devido a regras de precificação incorretas.
  • METADATA_CORRECTION: uma correção para corrigir metadados sem alterar o custo.
  • GOODWILL: um crédito emitido para o cliente pela reputação.
  • SALES_BASED_GOODWILL: um crédito emitido para o cliente pela loja, como parte de um contrato.
  • SLA_VIOLATION: um crédito emitido para o cliente devido a uma violação de objetivo de nível de serviço (SLO).
  • BALANCE_TRANSFER: um ajuste para transferir fundos de uma conta para pagamento para outra.
  • ACCOUNT_CLOSURE: um ajuste para levar uma conta encerrada a um saldo zero.
  • GENERAL_ADJUSTMENT: uma modificação geral da conta de faturamento.
adjustment_info.mode String

Como o ajuste foi emitido.

Os modos incluem:

  • PARTIAL_CORRECTION: a correção nega parcialmente o uso e o custo originais.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: a correção rejeita totalmente o uso e o custo originais e emite itens de linha corrigidos com o uso e o custo atualizados.
  • COMPLETE_NEGATION: a correção nega totalmente o uso e o custo originais, e nenhum uso adicional é monetizado novamente.
  • MANUAL_ADJUSTMENT: o ajuste é alocado para custo e uso manualmente.
export_time Timestamp Um tempo de processamento associado a um anexo de dados do Faturamento do Cloud. Ele sempre aumentará com cada nova exportação.
Consulte também Diferenças entre os dados exportados e as faturas abaixo.

Sobre os marcadores

Você verá colunas para marcadores no conjunto de dados do BigQuery, mas na versão atual alguns valores de marcadores estarão vazios. Os dados de exportação de rótulos serão preenchidos em horários diferentes para serviços diferentes, dependendo de quando cada serviço fornece esses dados.

Rótulos do sistema disponíveis

Os rótulos do sistema são pares de chave-valor para metadados importantes sobre o recurso que gerou o uso. Os seguintes rótulos de sistema são automaticamente incluídos no uso aplicável.

system_labels.key Exemplo de system_labels.value Descrição
compute.googleapis.com/machine_spec n1-standard-1, custom-2-2048 Configuração da máquina virtual. Consulte Tipos de máquina para mais informações.
compute.googleapis.com/cores para n1-standard-4 é 4. Para custom-2-2048 é 2 O número de vCPUs disponíveis para a máquina virtual.
compute.googleapis.com/memory para n1-standard-4 é 15360 (isto é, 15 GB * 1024 MB/GB), para custom-2-2048 é 2048 A quantidade de memória (em MB) disponível para a máquina virtual.

Diferenças entre os dados exportados e as faturas

Como os serviços do Google Cloud informam dados de uso e custo aos processos do Faturamento do Cloud em intervalos variados, pode haver um pequeno atraso (até alguns dias) nos informes de uso. No final de um mês, é possível que o uso informado com atraso não esteja incluído na fatura desse mês e, em vez disso, passe para a fatura do mês seguinte. No entanto, esse mesmo uso inclui um carimbo de data/hora de acordo com a data e a hora de uso real quando o uso é informado aos processos do Faturamento do Cloud.

Quando você consulta seus custos usando campos de carimbo de data/hora, os dados retornados podem identificar o uso informado posteriormente que não foi incluído originalmente na fatura gerada para o mesmo mês de uso. Consequentemente, os dados do Faturamento do Cloud retornados podem não ser mapeados diretamente para essa fatura.

Os campos do carimbo de data/hora incluem:

  • usage_start_time
  • usage_end_time
  • export_time

Para retornar dados do Faturamento do Cloud que sejam mapeados diretamente para uma fatura, consulte invoice.month em vez dos campos de carimbo de data/hora.

Impostos

A partir de 1º de setembro de 2020, os dados detalhados de custo diário mostrarão a garantia de impostos de cada um dos seus projetos, em vez de um único item de linha. Se você tiver consultas ou visualizações que dependem de dados fiscais, talvez seja necessário atualizar as consultas para considerar essas alterações.

Por exemplo, para os custos registrados antes de 1º de setembro, os dados detalhados de custo são semelhantes aos exemplos a seguir, que mostram uma responsabilidade total de impostos de US$ 10.

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 projeto-exemplo Normal US$ 60
123456-ABCDEF-123456 projeto-teste Normal US$ 40
123456-ABCDEF-123456 [vazio] Tributo US$ 10

Nos custos registrados após 1º de setembro, os US$ 10 são divididos em US$ 6 para example-project e US$ 4 para test-project:

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 projeto-exemplo Normal US$ 60
123456-ABCDEF-123456 projeto-teste Normal US$ 40
123456-ABCDEF-123456 projeto-exemplo Tributo US$ 6
123456-ABCDEF-123456 projeto-teste Tributo US$ 4

Erros e ajustes

No caso improvável de que os dados do Faturamento do Cloud contenham um erro ou exijam um ajuste, eles serão anexados com dados que anulam o erro. Todas as colunas permanecerão as mesmas, exceto estas:

  • cost
  • credit
  • usage.amount
  • export_time

Se você precisar determinar quais dados são novos, faça isso consultando export_time.

Nos seus dados exportados, o mês da fatura para ajustes do Faturamento do Cloud e os tributos associados refletem o mês em que o ajuste foi emitido. No entanto, o ajuste pode ser aplicado a uma fatura em um mês diferente do mês de emissão do ajuste. Para saber se e onde um ajuste é aplicado, você precisará revisar os documentos da nota da fatura ou de crédito/débito disponíveis na página de documentos do Console do Google Cloud. Para mais detalhes sobre como analisar ajustes e como eles são aplicados, consulte Noções básicas sobre notas e ajustes.

Exemplos de consultas para dados detalhados de custo diário

Exemplos de consulta detalhadas de custo diários


Esquema de dados de preços

No conjunto de dados do BigQuery, os dados de preços da conta de faturamento do Cloud são carregados em uma tabela denominada cloud_pricing_export.

As informações a seguir descrevem o esquema dos dados de preços da conta de faturamento do Cloud que são exportados para o BigQuery.

Campo Tipo Descrição
export_time Timestamp Um tempo de processamento associado a um anexo de dados do Faturamento do Cloud. Ele sempre aumentará com cada nova exportação.
pricing_as_of_time Timestamp Os dados de preços aplicáveis à sua conta de faturamento do Cloud são gerados uma vez por dia para prepará-los para a exportação para o BigQuery. Esse é o carimbo de data/hora diário de quando os dados de preço foram gerados.
billing_account_id String

O ID da conta de faturamento do Cloud ao qual o preço está associado.

Para revendedores: para preços associados a uma subconta do Cloud Billing, esse é o ID da subconta, e não é o ID da conta do Cloud Billinb do revendedor pai.

billing_account_name String

O nome da conta de faturamento do Cloud à qual o preço está associado.

business_entity_name String O nome da família de serviços do Google para o serviço que oferece a SKU. Os valores incluem o GCP (Google Cloud) ou o Google Maps (Plataforma Google Maps).
service.id String O ID do serviço do Google Cloud ou da API Plataforma Google Maps que relatou os dados do Faturamento do Cloud. Por exemplo, 6F81-5844-456A.
service.description String A descrição do serviço do Google Cloud ou da API Google Maps Platform que informou os dados do Cloud Billing. Por exemplo, Compute Engine.
sku.id String O identificador exclusivo da SKU do recurso usado pelo serviço. Por exemplo, 2E27-4F75-95CD. Para ver a lista completa de SKUs, consulte SKUs do Google Cloud.
sku.description String Uma descrição legível da SKU do recurso usado pelo serviço. Por exemplo, Núcleo da instância predefinida N1 em execução nas Américas.
sku.destination_migration_mappings Matriz de strings Os SKUs de destino para os quais a SKU está sendo migrada.
product_taxonomy Matriz de strings Lista de categorias de produtos que se aplicam à SKU, como sem servidor, Cloud Run, TaskQueue, VMs sob demanda, núcleos: por núcleo e outras.
geo_taxonomy Struct Metadados geográficos que se aplicam à SKU, como regiões e multirregiões, como us-east4, União Europeia.
geo_taxonomy.type String O tipo de metadados geográficos associados à SKU. Os valores válidos são:
  • GLOBAL: não tem regiões
  • REGIONAL: tem uma região
  • MULTI_REGION: tem duas ou mais regiões
geo_taxonomy.regions Matriz de strings As regiões do Google Cloud associadas à SKU. Por exemplo, Europe-west2 ou US.

Uma região é um lugar geográfico específico, como Londres. Um local multirregional é uma área geográfica grande, como Estados Unidos, que contém dois ou mais lugares geográficos.

pricing_unit String A abreviação da unidade de uso em que o preço é especificado, como GiBy.mo.
pricing_unit_description String A descrição legível da unidade de uso, como mês do gibibyte.
account_currency_code String A moeda em que a conta de faturamento do Cloud está configurada para operar, usando um código de moeda de três letras definido no ISO 4217. Para mais informações, consulte Moeda local para faturamento e pagamentos automáticos.
currency_conversion_rate String A taxa de câmbio de dólares americanos para a moeda local em que a conta de faturamento do Cloud está configurada para operar. Se a moeda da conta de faturamento do Cloud for o dólar americano, a taxa de troca será padronizada como 1.0.

Se os custos do Cloud Billing forem faturados em uma moeda que não seja o dólar americano, será possível converter os custos de uso para dólar americano usando esta fórmula: cost ÷ currency_conversion_rate = custo do uso em dólar americano.

Quando o Google cobra em moeda local, convertemos os preços para a moeda local aplicável de acordo com as taxas de conversão publicadas pelas principais instituições financeiras. Isso inclui quaisquer sobretaxas coletadas para faturamento em uma moeda que não seja o dólar americano. Usamos as taxas que estão em vigor no pricing_as_of_time.

list_price Struct

O preço de tabela de SKUs do Google Cloud ou da Plataforma Google Maps e níveis de preços da SKU, em vigor desde o pricing_as_of_time.

list_price contém campos que descrevem a estrutura e o valor do preço de lista, incluindo:

Os preços de tabela podem ser encontrados em list_price.tiered_rates.usd_amount

Os dados de preço de tabela são gerados e exportados para todos os clientes. Se sua conta de faturamento do Cloud tiver preços personalizados e sob contrato específicos da conta de faturamento, eles também serão exportados.

billing_account_price Struct

Se você tiver o preço do contrato, esse será o preço negociado da SKU do contrato vinculado à sua conta de faturamento do Cloud.

billing_account_price contém campos que descrevem a estrutura e o valor do preço negociado para SKUs do Google Cloud e da Plataforma Google Maps e os níveis de preços da SKU. O billing_account_price inclui:

Os preços contratados, se aplicáveis à sua conta de faturamento do Cloud, podem ser encontrados em billing_account_price.tiered_rates.usd_amount

price_info Struct Informações em segundo plano sobre o preço do contrato.
price_info.price_reason String

Informações em segundo plano sobre a origem do preço do contrato.

As razões incluem:

  • FIXED_DISCOUNT: porcentagem de desconto no preço de tabela aplicada ao preço de tabela como uma data fixa.
  • FLOATING_DISCOUNT: percentual de desconto sobre o atual preço padrão (não aplicado a um preço de tabela de uma data específica).
  • MIGRATED_PRICE: aplicável a preços migrados de outras SKUs.
  • MERGED_PRICE: preço da SKU após a combinação de várias origens. Por exemplo, com níveis combinados, é possível que cada nível seja de uma origem diferente com tipos de desconto diferentes.
price_info.discount_percent Numérica Para preços de contrato resultantes de um desconto percentual (FIXED_DISCOUNT ou FLOATING_DISCOUNT), essa é a porcentagem do desconto usado.
price_info.discount_percent_fixed_date Data Para preços de contatos com um desconto de porcentagem aplicado em uma data específica (FIXED_DISCOUNT), esta é a data usada.
price_info.discount_migrated_from String Para descontos de preços por contrato que foram migrados de outras SKUs (MIGRATED_PRICE), esta é a SKU de origem do desconto. Em alguns casos, quando uma SKU é dividido em duas, o desconto é migrado da SKU antigo para as novas SKUs.
aggregation_info Struct Representa o nível de agregação e o intervalo para os níveis de preços de uma única SKU.
aggregation_info.aggregation_level String O nível em que o uso é somado para calcular o custo dos níveis de preços.

Os níveis incluem:

  • ACCOUNT: indica uma SKU com preços em vários níveis. O uso da SKU para os níveis de preços é agregado em todos os projetos em uma única conta de faturamento do Cloud.
  • PROJECT: indica uma SKU com preços com várias camadas. O uso de SKU para as camadas de preços é agregado por projeto.
  • UNKNOWN_AGGREGATION_LEVEL: indica uma SKU com preços de nível único. Esse é o valor padrão para SKUs com preços que não estão em níveis.
aggregation_info.aggregation_interval String O intervalo em que o uso é somado para calcular o custo dos níveis de preços.

Os intervalos incluem:

  • ONE_DAY: indica uma SKU com preços com vários níveis. O uso da SKU para os níveis de preço é agregado todos os dias.
  • ONE_MONTH: indica uma SKU com preços em várias camadas. O uso da SKU para os níveis de preços é agregado todo mês.
  • UNKNOWN_AGGREGATION_INTERVAL: indica uma SKU com preços de nível único. Esse é o valor padrão para SKUs com preços que não estão em níveis.
tiered_rates Matriz de strings Informações sobre o nível de preços, incluindo o preço da SKU em dólar americano, e o preço da SKU na moeda em que a conta de faturamento do cloud está configurada para uso.

Algumas SKUs têm apenas um nível de preço. Se uma SKU tiver várias camadas de preços, cada uma aparecerá como uma linha diferente. É possível identificar SKUs com vários níveis de preços usando o tiered_rates.start_usage_amount.

tiered_rates.pricing_unit_quantity Float A quantidade da unidade do nível do preço da SKU. Por exemplo, se o preço do nível for de US$ 1 por 1.000.000 de bytes, a coluna mostrará 1.000.000.
tiered_rates.start_usage_amount Float O limite de valor mais baixo para um determinado nível de preço, em unidades de preço. Por exemplo, uma SKU com três níveis de preços, como 0 a 100 unidades, 101 a 1000 unidades e mais de 1001 unidades, exibiria três linhas de preços, com 0, 101 e 1001 como os valores [tiered_rates].start_usage_amount.
tiered_rates.usd_amount Numérica O preço da SKU em dólares americanos.
tiered_rates.account_currency_amount Numérica O preço do nível de SKU convertido de dólar americano para a moeda em que a conta de faturamento do Cloud está configurada para ser usada, com o currency_conversion_rate.

Esse preço convertido é calculado usando a seguinte fórmula: tiered_rates.usd_amount * currency_conversion_rate = tiered_rates.account_currency_amount.

Quando o Google cobra em moeda local, convertemos os preços para a moeda local aplicável de acordo com as taxas de conversão publicadas pelas principais instituições financeiras. Isso inclui quaisquer sobretaxas coletadas para faturamento em uma moeda que não seja o dólar americano. Usamos as taxas que estão em vigor no pricing_as_of_time.

Sobre níveis de preços

Os preços da SKU são oferecidos por níveis de preços. Os níveis de preços fornecem uma estrutura de preços com base em diferentes níveis. Algumas SKUs têm apenas uma única camada de preços, enquanto outras têm várias camadas de preços. Exemplos de SKUs com preços de vários níves incluem o seguinte:

  • SKUs com nível de uso gratuito. Por exemplo: 1 a 1.000 unidades são gratuitas. Mais de 100 mil unidades custam US$ 1,00 cada.
  • SKUs em que o preço por unidade diminui depois que a quantidade de uso em um nível é excedida. Por exemplo: o preço de 1 a 100 unidades é de US$ 5 cada. Já uma quantidade de 101 a 1001 unidades tem o preço de US$ 4 cada, e mais de 1001 unidades custam US$ 3 cada.

Algumas observações sobre preços de vários níveis:

  • O contador de uso de níveis é redefinido como zero com base no aggregation_interval da SKU: diária ou mensal.

    • Os SKUs diários são redefinidos todos os dias às 12h do horário do Pacífico dos EUA e do Canadá (UTC-8).
    • As SKUs mensais são redefinidas para zero no primeiro dia de cada mês (por exemplo: janeiro, fevereiro e assim por diante), às 12h do horário do Pacífico dos EUA e do Canadá (UTC-8).
  • Os níveis operam com independência para cada conta de faturamento do Cloud e não são somados em várias contas, mesmo que os projetos estejam na mesma organização ou pertençam à mesma entidade legal.

  • As camadas operam com independência por SKU: o uso de uma SKU só afeta o preço dessa SKU. No momento, não há SKUs em que o uso afeta o preço em níveis de outra SKU.

  • É possível que os níveis de preço da SKU dos preços de tabela não estejam alinhados com os preços de preços do contrato. Essa situação é rara.

  • Se uma SKU tiver vários níveis de preços, cada um será listado como uma linha separada na tabela de preços. É possível identificar SKUs com vários níveis de preços usando o tiered_rates.start_usage_amount.

  • Dependendo de como você escreve a consulta, é possível retornar os níveis de preços da SKU como dados aninhados ou não aninhados. Para mais informações sobre dados aninhados e não aninhados, consulte os exemplos a seguir.

Exemplo de consultas de preços: retorna os preços de tabela de uma SKU com vários níveis de preços

Consulte os dados do BigQuery por nome da tabela. O nome da tabela usado na cláusula FROM da consulta é determinado usando três valores: project.dataset.BQ_table_name.

Valores comuns usados nestes exemplos:

  • Nome da tabela: project.dataset.cloud_pricing_export
  • ID da SKU: 2DA5-55D3-E679 (Cloud Run - Solicitações)

Exemplo 1: retorna dados aninhados

Este exemplo consulta uma única SKU para retornar os dados do list_price. Essa SKU tem vários níveis de preços. Os valores do campo de preço de tabela são exibidos em linhas individuais aninhadas na linha do ID da SKU.

SQL padrão

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"
;

Resultados da consulta:

Row 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 Solicitações 152E-C115-5142 Cloud Run CONTA MONTHLY 1000000 0 0 0
            1000000 2000000 0.4 0.4

Exemplo 2: retorna dados não aninhados que foram mesclados com a mesma tabela

Neste exemplo, consultamos uma única SKU para retornar o list price. A SKU tem vários níveis de preços. A consulta demonstra o uso do operador UNNEST para nivelar a matriz de tiered_rates e mesclar os campos com o mesma tabela, o que resulta em uma linha por nível de preço.

SQL padrão

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"
;

Resultados da consulta:

Row sku_id sku_description service_id service_description pricing_unit_quantity start_usage_amount usd_amount account_currency_amount
1 2DA5-55D3-E679 Solicitações 152E-C115-5142 Cloud Run 1000000.0 0.0 0.0 0.0
2 2DA5-55D3-E679 Solicitações 152E-C115-5142 Cloud Run 1000000.0 2000000.0 0.4 0.4

Todos os exemplos de consulta de dados de preços

Exemplos de consulta de dados de preços

Limitações

A exportação dos dados do Faturamento do Cloud para o BigQuery está sujeita às limitações a seguir:

  • O conjunto de dados do BigQuery reflete apenas os dados de faturamento do Google Cloud gerados a partir da data em que você configurou a exportação. Ou seja, os dados de faturamento do Google Cloud não são adicionados retroativamente. Portanto, você não verá os dados de faturamento do Cloud antes de ativar a exportação.
  • As chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) não são compatíveis com a exportação de dados de faturamento para o BigQuery. Se você ativar CMEK para um conjunto de dados, isso impedirá que o Faturamento do Cloud grave dados de faturamento nas tabelas apropriadas dentro desse conjunto de dados.

Relatórios de custos e preços disponíveis no Console do Google Cloud