Neste documento, você verá informações de referência sobre o esquema dos dados de preços do Cloud Billing exportados para cada tabela no BigQuery.
Esquema de dados de preços
No conjunto de dados do BigQuery, os dados de preços da conta do Cloud Billing são carregados em uma tabela de dados denominada cloud_pricing_export.
As informações a seguir descrevem o esquema dos dados de preços da conta do Cloud Billing que são exportados para o BigQuery.
| Campo | Tipo | Descrição |
|---|---|---|
export_time |
Carimbo de data/hora | Um tempo de processamento associado a uma anexação de dados do Cloud Billing.
Ele sempre aumentará com cada nova exportação. |
pricing_as_of_time |
Carimbo de data/hora | Os dados de preços aplicáveis à sua conta do Cloud Billing são
gerados uma vez por dia para serem preparados para 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 do Cloud Billing ao 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 GCP (Google Cloud) ou Maps (Plataforma Google Maps). |
service.id |
String | O ID do serviço do Google Cloud ou da API da Plataforma Google Maps que relatou os dados do Cloud Billing. Por exemplo, 6F81-5844-456A. |
service.description |
String | A descrição do serviço do Google Cloud ou da API da Plataforma Google Maps que relatou 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 doGoogle Cloud . |
sku.description |
String | Uma descrição legível por humanos 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 nomes das SKUs de destino para as quais a SKU está sendo migrada. |
product_taxonomy |
Matriz de strings | Lista de categorias dos produtos que se aplicam à SKU, como Sem servidor, Cloud Run, TaskQueue, VMs sob demanda, Cores: por núcleo, entre 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:
|
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 por humanos da unidade de uso, como mês de gibibyte. |
account_currency_code |
String | A moeda em que a conta do Cloud Billing está configurada para operar, usando um código de moeda de três letras definido na 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 do Cloud Billing está configurada para
operar. Se a moeda da conta do Cloud Billing for USD,
a taxa de câmbio padrão será 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:
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
|
sku_attributes |
Struct | Contém atributos de par de chave-valor que descrevem a SKU, por exemplo,
model_name, gemini_2_5_flash ou
serving_method, batch.
|
sku_attributes.key |
String | Chave do atributo da SKU. Por exemplo, model_name,
serving_method, modality ou
token_type.
|
sku_attributes.value |
String | Valor do atributo de SKU. Por exemplo, gemini_2_5_flash,
batch, text ou input.
|
sku_granular_usage_units |
String | A unidade de uso granular da SKU, como tokens.
|
list_price |
Struct | O preço de tabela das SKUs do Google Cloud ou da Plataforma Google Maps
e dos
níveis de preço da SKU, em vigor a partir de
Os preços de tabela podem ser encontrados em
Os dados de preço de tabela são gerados e exportados para todos os clientes. Se sua conta do Cloud Billing 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 do Cloud Billing, com o preço padrão do modelo de consumo.
Os preços contratados, se aplicáveis à sua conta de faturamento do Cloud,
podem ser encontrados em
|
consumption_model_prices |
Lista de structs | O preço de tabela e os preços da conta de faturamento da SKU, para cada modelo de consumo. |
consumption_model_prices.consumption_model_id |
String | ID do modelo de consumo. |
consumption_model_prices.consumption_model_display_name
|
String | Nome de exibição do modelo de consumo. |
consumption_model_prices.list_price |
Struct | O preço de tabela das SKUs do Google Cloud ou da Plataforma Google Maps
e dos
níveis de preço da SKU, em vigor a partir de
Esse campo é adicionado à estrutura Consulte
|
consumption_model_prices.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 do Cloud Billing, com o preço do modelo de consumo especificado. Esse campo é adicionado à estrutura billing_account_price para mais detalhes.
|
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:
|
price_info.discount_percent |
Numérico | 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 contrato com um desconto percentual vinculado a uma
data específica (FIXED_DISCOUNT), essa é 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.
Às vezes, quando uma SKU é dividida em duas, o desconto é migrado da SKU antiga para as novas.
|
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:
|
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:
|
tiered_rates |
Matriz de strings | Informações sobre o
nível de preços, incluindo o preço da SKU em USD e o preço da SKU
na
moeda que a conta do Cloud Billing está configurada para usar.
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.pricing_unit_quantity |
Ponto flutuante | 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 |
Ponto flutuante | 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érico | O preço da SKU em dólares americanos. |
tiered_rates.account_currency_amount |
Numérico | O preço do nível da SKU convertido de USD para a
moeda que a conta do Cloud Billing está configurada para usar,
usando a
currency_conversion_rate.
Esse preço convertido é calculado usando a seguinte fórmula:
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
|
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 um nível de uso sem custo financeiro. Por exemplo: de 1 a 1.000 unidades não têm custo financeiro. 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_intervalda SKU: diária ou mensal.- As SKUs diárias são redefinidas todos os dias à 0h no horário do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7).
- As SKUs mensais são redefinidas para zero no primeiro dia de cada mês (por exemplo: janeiro, fevereiro etc.), à meia-noite no horário do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7).
Os níveis operam de maneira independente para cada conta do Cloud Billing e não são agregados em várias contas do Cloud Billing, mesmo que os projetos estejam na mesma organização ou pertençam à mesma pessoa jurídica.
As camadas operam com independência por SKU: o uso de uma SKU só afeta o preço dessa SKU. Não há SKUs em que o uso afete o preço por níveis de outra SKU.
É possível que os níveis de preço de tabela da SKU não se alinhem exatamente com os níveis de preço 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.
Exemplos de consulta de dados de preços
Nesta seção, apresentamos exemplos de como consultar os dados de preços do Cloud Billing exportados para o BigQuery.
- Ver os preços de tabela de uma SKU específica
- Ver os preços de tabela de uma SKU específica e incluir a descrição do serviço
- Usar a taxonomia do produto e taxonomia geográfica para consultar SKUs
Nesta seção, apresentamos exemplos diferentes de como consultar os dados de preços do Cloud Billing exportados para o BigQuery.
Valores comuns usados nas consultas de preços de exemplo
Os exemplos de consulta nesta seção usam os seguintes valores:
- Nome da tabela:
project.dataset.cloud_pricing_export - ID da SKU:
2DA5-55D3-E679(Cloud Run - Solicitações)
Ver os preços de tabela de uma SKU específica
Neste exemplo, demonstramos uma consulta que retorna o
list_price
para cada
nível de preços
de uma SKU especificada.
SQL padrão
SELECT sku.id, sku.description, list_price.* FROM `project.dataset.cloud_pricing_export` WHERE DATE(_PARTITIONTIME) = "2020-07-20" AND sku.id = "2DA5-55D3-E679" ;
_PARTITIONTIME é um campo gerado automaticamente pelo BigQuery
e representa a data referente aos dados. Em vez de _PARTITIONTIME,
é possível usar um campo que a exportação do Cloud Billing gera explicitamente,
como
pricing_as_of_time.
Esta é a mesma consulta configurada para usar o campo pricing_as_of_time:
SELECT sku.id, sku.description, list_price.* FROM `project.dataset.cloud_pricing_export` WHERE DATE(pricing_as_of_time) = "2020-07-20" AND sku.id = "2DA5-55D3-E679" ;
Resultados da consulta
| Linha | ID | descrição | pricing_unit | 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 | COUNT | CONTA | MENSAL | 1000000 | 0 | 0 | 0 |
| 1000000 | 2000000 | 0,4 | 0,4 |
Ver os preços de tabela de uma SKU específica e incluir a descrição do serviço
Os dois exemplos nesta seção demonstram consultas que retornam o
list_price
para cada
nível de preços
de uma SKU especificada, além de incluir a descrição da SKU e
do serviço.
- O exemplo 1 retorna uma SKU por linha, com os níveis de preços exibidos como dados aninhados.
- O exemplo 2 demonstra como desaninhar os dados para retornar uma linha por SKU por nível de preço.
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:
| Linha | 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 | MENSAL | 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:
| Linha | 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 |
Usar a taxonomia do produto e taxonomia geográfica para consultar SKUs
- Taxonomia do produto é uma lista de categorias dos produtos que se aplicam à SKU, como sem servidor, Cloud Run ou VMs sob demanda.
- Taxonomia geográfica são os metadados geográficos que se aplicam a uma SKU e consiste em valores de tipo e região.
Ver a taxonomia do produto de uma SKU
Este exemplo demonstra uma consulta que retorna a lista product_taxonomy para uma SKU especificada, em que o ID da SKU = 2DA5-55D3-E679 (Cloud Run - Solicitações).
SQL padrão
SELECT sku.id AS sku_id, sku.description AS sku_description, service.id AS service_id, service.description as service_description, product_taxonomy FROM `project.dataset.cloud_pricing_export` WHERE DATE(_PARTITIONTIME) = "2020-07-20" AND sku.id = "2DA5-55D3-E679" ;
Resultados da consulta:
| Linha | sku_id | sku_description | service_id | service_description | product_taxonomy |
|---|---|---|---|---|---|
| 1 | 2DA5-55D3-E679 | Solicitações | 152E-C115-5142 | Cloud Run | GCP |
| Sem servidor | |||||
| Cloud Run | |||||
| Outro |
Ver todas as SKUs para uma taxonomia de produto específica
Este exemplo demonstra uma consulta que retorna todas as SKUs que correspondem a um
product_taxonomy especificado.
Nessa consulta, especificamos Sem servidor como o valor de product taxonomy.
SQL padrão
SELECT sku.id AS sku_id, sku.description AS sku_description, service.id AS service_id, service.description as service_description, product_taxonomy FROM `project.dataset.cloud_pricing_export` WHERE DATE(_PARTITIONTIME) = "2020-07-20" AND "Serverless" in UNNEST(product_taxonomy) LIMIT 10 ;
Resultados da consulta:
| Linha | sku_id | sku_description | service_id | service_description | product_taxonomy |
|---|---|---|---|---|---|
| 1 | 0160-BD7B-4C40 | Saída de intraregião da rede do Cloud Tasks | F3A6-D7B7-9BDA | Cloud Tasks | GCP |
| Sem servidor | |||||
| Cloud Tasks | |||||
| Outro | |||||
| 2 | FE08-0A74-7AFD | Saída da API GOOGLE do Cloud Tasks | F3A6-D7B7-9BDA | Cloud Tasks | GCP |
| Sem servidor | |||||
| Cloud Tasks | |||||
| Outro | |||||
| 3 | A81A-32A2-B46D | Armazenamento de fila de tarefas de Salt Lake City | F17B-412E-CB64 | App Engine | GCP |
| Sem servidor | |||||
| GAE | |||||
| Outro | |||||
| Fila de tarefas |
Ver todas as SKUs de taxonomias geográficas e de produto específicas
Este exemplo demonstra uma consulta que retorna todas as SKUs correspondentes a uma região
geo_taxonomy
especificada e um product_taxonomy
especificado,
em que region = us-east4 e product_taxonomy = VMs sob demanda.
SQL padrão
SELECT sku.id AS sku_id, sku.description AS sku_description, service.id AS service_id, service.description as service_description, geo_taxonomy, product_taxonomy FROM `project.dataset.cloud_pricing_export` WHERE DATE(_PARTITIONTIME) = "2020-07-20" AND "VMs On Demand" in UNNEST(product_taxonomy) AND geo_taxonomy.type = "REGIONAL" AND "us-east4" in UNNEST (geo_taxonomy.regions) ;
Resultados da consulta:
| Linha | sku_id | sku_description | service_id | service_description | geo_taxonomy.type | geo_taxonomy.regions | product_taxonomy |
|---|---|---|---|---|---|---|---|
| 1 | 9174-81EE-425B | Premium de locatário individual para RAM da instância de locatário individual em execução na Virgínia | 6F81-5844-456A | Compute Engine | REGIONAL | us-east4 | GCP |
| Computação | |||||||
| GCE | |||||||
| VMs sob demanda | |||||||
| Memória: por GB | |||||||
| 2 | C3B9-E891-85ED | RAM da instância de locatário individual em execução na Virgínia | 6F81-5844-456A | Compute Engine | REGIONAL | us-east4 | GCP |
| Computação | |||||||
| GCE | |||||||
| VMs sob demanda | |||||||
| Memória: por GB | |||||||
| 3 | 6E2A-DCD9-87ED | RAM da instância pré-definida N1 em execução na Virgínia | 6F81-5844-456A | Compute Engine | REGIONAL | us-east4 | GCP |
| Computação | |||||||
| GCE | |||||||
| VMs sob demanda | |||||||
| Memória: por GB |
Retorna os preços de tabela de uma SKU com vários níveis de preço
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:
| Linha | 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 | MENSAL | 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:
| Linha | 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 |
Temas relacionados
Tópicos relacionados aos dados exportados do Cloud Billing
- Configurar a exportação de dados do Cloud Billing para o BigQuery
- Exemplo de consultas para a exportação de dados do Cloud Billing para o BigQuery
Relatórios de custos e preços disponíveis no console do Google Cloud
- Ver relatórios de faturamento e tendências de custo do Cloud Billing
- Visualizar e fazer o download dos detalhes de custo da fatura ou do extrato
- Visualizar e fazer o download dos preços dos serviços de nuvem do Google
- Noções básicas sobre o valor economizado com os relatórios de detalhamento de custos
- Analisar a eficácia dos descontos por compromisso de uso
- Ver o histórico de custos e pagamentos