Este documento fornece informações de referência para o esquema dos dados de preços da faturação do Google Cloud exportados para cada tabela no BigQuery.
Esquema dos dados de preços
No conjunto de dados do BigQuery, os dados de preços da conta de faturação do Google Cloud são carregados numa tabela de dados denominada cloud_pricing_export
.
As informações seguintes descrevem o esquema dos dados de preços da conta de faturação do Google Cloud que são exportados para o BigQuery.
Campo | Tipo | Descrição |
---|---|---|
export_time |
Indicação de tempo | Um tempo de processamento associado a uma anexação de dados do Cloud Billing.
Este valor aumenta sempre com cada nova exportação. |
pricing_as_of_time |
Indicação de tempo | Os dados de preços aplicáveis à sua conta de faturação do Google Cloud são
gerados uma vez por dia para os preparar para exportação para o
BigQuery. Esta é a indicação de tempo diária de quando os dados de preços 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 Google para o serviço que oferece o SKU. Os valores incluem GCP (Google Cloud) ou Maps (Google Maps Platform). |
service.id |
String | O ID do Google Cloud serviço ou da API Google Maps Platform que comunicou os dados de faturação do Google Cloud. Por exemplo, 6F81-5844-456A. |
service.description |
String | A descrição do Google Cloud serviço ou da API Google Maps Platform que comunicou os dados de faturação do Google Cloud. Por exemplo, Compute Engine. |
sku.id |
String | O identificador exclusivo do SKU do recurso usado pelo serviço. Por exemplo, 2E27-4F75-95CD. Para ver a lista completa de SKUs, consulte o artigo Google Cloud SKUs. |
sku.description |
String | Uma descrição legível do SKU do recurso usado pelo serviço. Por exemplo, N1 Predefined Instance Core em execução nas Américas. |
sku.destination_migration_mappings |
Matriz de strings | Os nomes dos SKUs de destino para os quais este SKU está a ser migrado. |
product_taxonomy |
Matriz de strings | Lista de categorias de produtos que se aplicam ao SKU, como Serverless,
Cloud Run, TaskQueue, VMs On Demand, Cores: Per Core e outros.
product_taxonomy
|
geo_taxonomy |
Struct | Metadados geográficos que se aplicam ao SKU, como regiões e
multirregiões, como us-east4, a União Europeia.
geo_taxonomy
|
geo_taxonomy.type |
String | O tipo de metadados geográficos associados ao SKU.
Os valores válidos são:
|
geo_taxonomy.regions |
Matriz de strings | As Google Cloud regiões associadas ao SKU.
Por exemplo, Europe-west2 ou US .
Uma região é um local geográfico específico, como Londres. Uma região múltipla é uma grande área geográfica, como os Estados Unidos, que contém dois ou mais locais geográficos. |
pricing_unit |
String | A abreviatura da unidade de utilização na qual o preço é especificado (como GiBy.mo). |
pricing_unit_description |
String | A descrição legível da unidade de utilização (como gibibyte/mês). |
account_currency_code |
String | A moeda na qual a conta de faturação do Google Cloud está configurada para operar, através de um código de moeda de três letras definido na ISO 4217. Para mais informações, consulte o artigo Moeda local para faturação e pagamentos automáticos. |
currency_conversion_rate |
String | A taxa de câmbio do dólar americano para a
moeda local em que a conta do Cloud Billing está configurada para
funcionar. Se a moeda da conta do Cloud Billing for USD,
a taxa de câmbio é 1,0 por predefinição.
Se os custos da Faturação do Google Cloud
forem faturados numa moeda que não seja o USD, pode converter os
custos de utilização em USD através desta fórmula:
Quando a Google efetua a cobrança na moeda local, converte os preços na moeda local aplicável de acordo com as taxas de conversão publicadas pelas principais instituições financeiras. Isto inclui qualquer sobretaxa
cobrada pela faturação numa moeda que não seja o USD. Usamos as tarifas em vigor a
|
list_price |
Struct | O preço de tabela dos SKUs da Google Cloud ou Google Maps Platform
e dos
níveis de preços, em vigor a partir de
Pode encontrar os preços de tabela em
Os dados do preço de tabela são gerados e exportados para todos os clientes. Se a sua conta do Cloud Billing tiver preços de contrato personalizados, os dados de preços específicos da conta de faturação também são exportados. |
billing_account_price |
Struct | Se tiver preços contratuais, este é o preço do SKU personalizado do contrato associado à sua conta de faturação do Google Cloud, com o preço do modelo de consumo predefinido.
Pode encontrar os preços contratuais (se aplicáveis à sua conta do Cloud Billing) em
|
consumption_model_prices |
Lista de structs | O preço de tabela e os preços da conta de faturação do 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 a apresentar do modelo de consumo. |
consumption_model_prices.list_price |
Struct |
O preço de tabela dos SKUs do Google Cloud ou da Google Maps Platform
e dos
níveis de preços dos SKUs, em vigor a partir de
Este campo é adicionado à estrutura Consulte
|
consumption_model_prices.billing_account_price |
Struct |
Se tiver preços contratuais, este é o preço do SKU personalizado do contrato associado à sua conta de faturação do Google Cloud, com o preço do modelo de consumo especificado.
Este campo é adicionado à estrutura billing_account_price para ver mais detalhes.
|
price_info |
Struct | Informações gerais sobre o preço contratual. |
price_info.price_reason |
String | Informações gerais sobre a origem do preço contratual. Os motivos incluem:
|
price_info.discount_percent |
Numérico | Para preços contratuais que são o resultado de uma percentagem de desconto
(FIXED_DISCOUNT ou FLOATING_DISCOUNT ), esta é a
percentagem do desconto usado.
|
price_info.discount_percent_fixed_date |
Data | Para preços de contacto com um desconto percentual ancorado a uma data específica (FIXED_DISCOUNT ), esta é a data usada.
|
price_info.discount_migrated_from |
String | Para descontos de preços contratuais que foram migrados de outros SKUs
(MIGRATED_PRICE ), este é o SKU de origem do desconto.
Por vezes, quando um SKU é dividido em dois, o desconto é migrado do SKU antigo para os novos SKUs.
|
aggregation_info |
Struct | Representa o nível de agregação e o intervalo dos níveis de preços de um único SKU. |
aggregation_info.aggregation_level |
String | O nível ao qual a utilização é agregada para calcular o custo dos
escalões de preços.
Os níveis incluem:
|
aggregation_info.aggregation_interval |
String | O intervalo no qual a utilização é agregada 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 do SKU em USD e o preço do SKU na
moeda
que a conta de faturação do Google Cloud está configurada para usar.
Alguns SKUs têm apenas um nível de preços. Se um SKU tiver vários níveis de preços,
cada nível de preços aparece como uma linha diferente. Pode identificar SKUs
com vários níveis de preços através do
|
tiered_rates.pricing_unit_quantity |
Flutuante | A quantidade de unidades do nível de preços do SKU. Por exemplo, se o preço do nível for de 1 € por 1 000 000 de bytes, esta coluna apresenta 1 000 000. |
tiered_rates.start_usage_amount |
Flutuante | Valor limite inferior para um determinado nível de preços, em unidades de preços. Por exemplo, um SKU com três níveis de preços, como 0 a 100 unidades, 101 a 1000 unidades e mais de 1001 unidades, apresentaria três linhas de preços, com 0, 101 e 1001 como os valores de [tiered_rates].start_usage_amount. |
tiered_rates.usd_amount |
Numérico | O preço do SKU, em dólares americanos. |
tiered_rates.account_currency_amount |
Numérico | O preço de nível do SKU convertido de USD para a
moeda que a conta de faturação da Google Cloud está configurada para usar,
através da
currency_conversion_rate .
Este preço convertido é calculado através da seguinte fórmula:
Quando a Google efetua a cobrança na moeda local, converte os preços na moeda local aplicável de acordo com as taxas de conversão publicadas pelas principais instituições financeiras. Isto inclui qualquer sobretaxa
cobrada pela faturação numa moeda que não seja o USD. Usamos as tarifas em vigor a
|
Acerca dos níveis de preços
Os preços dos SKUs são oferecidos por níveis de preços. Os níveis de preços oferecem uma estrutura de preços com base em diferentes níveis. Alguns SKUs têm apenas um nível de preços, enquanto outros têm vários níveis de preços. Seguem-se alguns exemplos de SKUs com preços de vários níveis:
- SKUs com um nível de utilização gratuito. Por exemplo: 1 a 1000 unidades são gratuitas. As unidades entre 1001 e 10 000 têm um preço de 1 $cada.
- SKUs em que o preço por unidade diminui após a quantidade de utilização num nível ser excedida. Por exemplo: 1 a 100 unidades têm um preço de 5 € cada, 101 a 1000 unidades têm um preço de 4 € cada e mais de 1001 unidades têm um preço de 3 € cada.
Algumas notas sobre os preços de vários níveis:
O contador de utilização do nível é reposto para zero com base no
aggregation_interval
do SKU: diário ou mensal.- As UFs diárias são repostas todos os dias às 00:00, hora do Pacífico dos EUA e do Canadá (UTC-8 ou UTC-7).
- As referências dos produtos mensais são repostas para zero no primeiro dia de cada mês civil (por exemplo, janeiro, fevereiro, etc.), às 12: 00 (hora do Pacífico dos EUA e do Canadá) (UTC-8 ou UTC-7).
Os níveis funcionam de forma 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 entidade legal.
Os níveis funcionam de forma independente por SKU: a utilização de um SKU só pode afetar o preço desse SKU. Não existem SKUs em que a utilização afete os preços hierárquicos de outro SKU.
É possível que os níveis de preços dos SKUs para preços de tabela não correspondam exatamente aos níveis de preços dos preços contratuais. Esta circunstância é rara.
Se um SKU tiver vários níveis de preços, o preço de cada nível do SKU é apresentado como uma linha separada na tabela de preços. Pode identificar SKUs com vários níveis de preços usando o elemento
tiered_rates.start_usage_amount
.Consoante a forma como escreve a consulta, pode devolver os níveis de preços dos seus SKU como dados aninhados ou não aninhados. Para mais informações sobre dados aninhados e não aninhados, consulte os seguintes exemplos.
Exemplos de consultas de dados de preços
Esta secção fornece exemplos de como consultar os dados de preços da faturação do Google Cloud exportados para o BigQuery.
- Obtenha os preços de tabela de um SKU específico
- Obtenha preços de tabela para um SKU específico e inclua a descrição do serviço
- Use a taxonomia de produtos e a taxonomia geográfica para consultar SKUs
Esta secção apresenta diferentes exemplos de como consultar os dados de preços da Faturação do Google Cloud exportados para o BigQuery.
Valores comuns usados nas consultas de preços de exemplo
Os exemplos de consultas nesta secção usam os seguintes valores:
- Nome da tabela:
project.dataset.cloud_pricing_export
- ID do SKU:
2DA5-55D3-E679
(Cloud Run – Pedidos)
Obtenha preços de tabela para um SKU específico
Este exemplo demonstra uma consulta que devolve o
list_price
para cada
nível de preços
para um SKU especificado.
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 a que os dados pertencem. Em vez de _PARTITIONTIME
,
pode usar um campo que a exportação do Cloud Billing gera explicitamente,
como
pricing_as_of_time
.
Segue-se 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 | Pedidos | COUNT | CONTA | MENSAL | 1000000 | 0 | 0 | 0 |
1000000 | 2000000 | 0,4 | 0,4 |
Obtenha preços de tabela para um SKU específico e inclua a descrição do serviço
Os dois exemplos nesta secção demonstram consultas que devolvem o
list_price
para cada nível de preços
para um SKU especificado e incluem a descrição do SKU e a descrição do serviço.
- O exemplo 1 devolve um SKU por linha, com os níveis de preços apresentados como dados aninhados.
- O exemplo 2 demonstra a anulação da aninhagem dos dados para devolver uma linha por SKU por nível de preços.
Exemplo 1: devolve dados aninhados
Este exemplo consulta um único SKU para devolver os dados de list_price
. Este SKU tem vários níveis de preços.
Os valores dos campos de preço de tabela são apresentados em linhas individuais aninhadas na linha do ID do 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 | Pedidos | 152E-C115-5142 | Cloud Run | CONTA | MENSAL | 1000000 | 0 | 0 | 0 |
1000000 | 2000000 | 0,4 | 0,4 |
Exemplo 2: devolve dados desagrupados combinados com a mesma tabela
Este exemplo consulta um único SKU para devolver o
list price
.
O SKU tem vários níveis de preços.
A consulta demonstra a utilização do operador
UNNEST
para
reduzir a matriz tiered_rates
e juntar os campos com a mesma tabela, o que resulta numa linha por nível de preços.
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 | Pedidos | 152E-C115-5142 | Cloud Run | 1000000,0 | 0.0 | 0.0 | 0.0 |
2 | 2DA5-55D3-E679 | Pedidos | 152E-C115-5142 | Cloud Run | 1000000,0 | 2000000,0 | 0,4 | 0,4 |
Use a taxonomia de produtos e a taxonomia geográfica para consultar SKUs
- A taxonomia de produtos é uma lista de categorias de produtos que se aplicam ao SKU, como Sem servidor, Cloud Run ou VMs a pedido.
- A taxonomia geográfica é o metadados geográficos que se aplicam a um SKU, que consistem em valores de tipo e região.
Obtenha a taxonomia de produtos de um SKU
Este exemplo demonstra uma consulta que devolve a lista de product_taxonomy
para um SKU especificado, em que o ID do SKU = 2DA5-55D3-E679
(Cloud Run - Requests).
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 | Pedidos | 152E-C115-5142 | Cloud Run | GCP |
Sem servidor | |||||
Cloud Run | |||||
Outro |
Obtenha todas as SKUs para uma taxonomia de produtos específica
Este exemplo demonstra uma consulta que devolve todos os SKUs que correspondem a um product_taxonomy
especificado.
Nesta consulta, estamos a especificar Serverless 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 intrarregional de rede do Cloud Tasks | F3A6-D7B7-9BDA | Cloud Tasks | GCP |
Sem servidor | |||||
Cloud Tasks | |||||
Outro | |||||
2 | FE08-0A74-7AFD | Saída GOOGLE-API do Cloud Tasks | F3A6-D7B7-9BDA | Cloud Tasks | GCP |
Sem servidor | |||||
Cloud Tasks | |||||
Outro | |||||
3 | A81A-32A2-B46D | Armazenamento de filas de tarefas em Salt Lake City | F17B-412E-CB64 | App Engine | GCP |
Sem servidor | |||||
GAE | |||||
Outro | |||||
TaskQueue |
Obtenha todas as SKUs para uma taxonomia geográfica e uma taxonomia de produtos específicas
Este exemplo demonstra uma consulta que devolve todos os SKUs que correspondem a uma
geo_taxonomy
região especificada e a um
product_taxonomy
> tipo de produto especificado,
onde region
= us-east4 e product_taxonomy
= VMs On Demand.
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 | Sole Tenancy Premium para RAM de instância de Sole Tenancy em execução na Virgínia | 6F81-5844-456A | Compute Engine | REGIONAL | us-east4 | GCP |
Computação | |||||||
GCE | |||||||
VMs a pedido | |||||||
Memória: por GB | |||||||
2 | C3B9-E891-85ED | Sole Tenancy Instance Ram running in Virginia | 6F81-5844-456A | Compute Engine | REGIONAL | us-east4 | GCP |
Computação | |||||||
GCE | |||||||
VMs a pedido | |||||||
Memória: por GB | |||||||
3 | 6E2A-DCD9-87ED | RAM de instância predefinida N1 em execução na Virgínia | 6F81-5844-456A | Compute Engine | REGIONAL | us-east4 | GCP |
Computação | |||||||
GCE | |||||||
VMs a pedido | |||||||
Memória: por GB |
Devolve os preços de tabela de um SKU com vários níveis de preços
Consulta os seus dados do BigQuery pelo nome da tabela. O nome da tabela usado na cláusula FROM
da consulta é determinado através de três valores:
project.dataset.BQ_table_name
.
Valores comuns usados nestes exemplos:
- Nome da tabela:
project.dataset.cloud_pricing_export
- ID do SKU:
2DA5-55D3-E679
(Cloud Run – Pedidos)
Exemplo 1: devolve dados aninhados
Este exemplo consulta um único SKU para devolver os dados de list_price
. Este SKU tem vários níveis de preços.
Os valores dos campos de preço de tabela são apresentados em linhas individuais aninhadas na linha do ID do 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 | Pedidos | 152E-C115-5142 | Cloud Run | CONTA | MENSAL | 1000000 | 0 | 0 | 0 |
1000000 | 2000000 | 0,4 | 0,4 |
Exemplo 2: devolve dados desagrupados combinados com a mesma tabela
Este exemplo consulta um único SKU para devolver o
list price
.
O SKU tem vários níveis de preços.
A consulta demonstra a utilização do operador
UNNEST
para
reduzir a matriz tiered_rates
e juntar os campos com a mesma tabela, o que resulta numa linha por nível de preços.
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 | Pedidos | 152E-C115-5142 | Cloud Run | 1000000,0 | 0.0 | 0.0 | 0.0 |
2 | 2DA5-55D3-E679 | Pedidos | 152E-C115-5142 | Cloud Run | 1000000,0 | 2000000,0 | 0,4 | 0,4 |
Tópicos relacionados
Tópicos relacionados com os dados de faturação do Google Cloud exportados
- Configure a exportação de dados de faturação do Google Cloud para o BigQuery
- Consultas de exemplo para a exportação de dados de faturação do Google Cloud para o BigQuery
- Visualize os gastos ao longo do tempo com o Looker Studio
Relatórios de custos e preços disponíveis na Google Cloud consola
- Veja os relatórios do Cloud Billing e as tendências de custos
- Veja e transfira os detalhes de custos da sua fatura ou extrato
- Veja e transfira os preços dos serviços na nuvem da Google
- Compreenda as suas poupanças com os relatórios de discriminação de custos
- Analise a eficácia dos seus descontos por utilização garantida
- Veja o histórico de custos e pagamentos