Referência da tabela do sistema de preços
Este artigo fornece uma visão geral da tabela do sistema de preços, incluindo o esquema e consultas de exemplo. A tabela de preços dá acesso a um registro histórico de preços de SKU. Um registro é adicionado cada vez que há uma alteração no preço de uma SKU. Esses logs podem ajudá-lo a realizar análises de custos e monitorar alterações de preços.
Caminho da tabela: Esta tabela do sistema está localizada em system.billing.list_prices
.
Esquema da tabela de preços
A tabela do sistema de preços usa o seguinte esquema:
Nome da coluna | Tipo de dados | Description | Exemplo |
---|---|---|---|
price_start_time |
carimbo de data/hora | O momento em que este preço entrou em vigor em UTC | 2023-01-01T09:59:59.999Z |
price_end_time |
carimbo de data/hora | O tempo em que este preço deixou de ser efetivo em UTC | 2023-01-01T09:59:59.999Z |
account_id |
string | ID da conta para a qual este relatório foi gerado | 1234567890123456 |
sku_name |
string | Nome do SKU | STANDARD_ALL_PURPOSE_COMPUTE |
cloud |
string | Nome da nuvem a que este preço é aplicável. Os valores possíveis são AWS , AZURE e GCP . |
AWS , AZURE ou GCP |
currency_code |
string | A moeda em que este preço é expresso | USD |
usage_unit |
string | A unidade de medida que é monetizada. | DBU |
pricing |
estruturar | Um campo de dados estruturados que inclui informações de preços à taxa de preço de tabela publicada. A chave default sempre retornará um único preço que pode ser usado para estimativas simples de longo prazo. A chave promotional representa um preço promocional temporário que todos os clientes recebem, que pode ser usado para estimativa de custos durante o período temporário. A chave effective_list resolve o preço de tabela e promocional e contém o preço de tabela efetivo usado para calcular o custo. Alguns modelos de preços também podem incluir chaves adicionais que fornecem mais detalhes. |
{ "default": "0.10", "promotional": {"default": "0.07"}, "effective_list": {"default": "0.07"} } |
Consultas de amostra
Você pode usar as seguintes consultas de exemplo para responder a perguntas comuns sobre preços de SKU:
- Encontrar o preço de lista de um determinado SKU numa data específica
- Ver o custo total de tudo o que utilizou uma etiqueta personalizada específica durante o mês de calendário anterior
- Ver preços que mudaram entre meses
- Estimar os custos adicionais de utilização no mês de calendário anterior
Para obter exemplos de consultas sobre a observabilidade do custo do trabalho, consulte Monitorar os custos do trabalho com tabelas do sistema.
Encontre o preço de tabela de um determinado SKU em uma data específica
Como a tabela contém apenas registros para os momentos em que o preço da SKU muda, você precisa procurar a alteração de preço mais recente na data ou antes dela.
SELECT sku_name, price_start_time, pricing.default
FROM system.billing.list_prices
WHERE sku_name = 'STANDARD_ALL_PURPOSE_COMPUTE'
AND price_start_time <= "2023-01-01"
ORDER BY price_start_time DESC
LIMIT 1
Exibir o custo total de tudo o que usou uma tag personalizada específica durante o mês do calendário anterior
Nota
Certifique-se de substituir a chave e o valor da tag personalizada.
SELECT
SUM(usage.usage_quantity * list_prices.pricing.effective_list.default)
as `Total Dollar Cost`
FROM system.billing.usage
JOIN system.billing.list_prices ON list_prices.sku_name = usage.sku_name
WHERE usage.custom_tags.{{ tag_key }} = {{ tag_value }}
AND usage.usage_end_time >= list_prices.price_start_time
AND (list_prices.price_end_time IS NULL OR usage.usage_end_time < list_prices.price_end_time)
AND usage.usage_date BETWEEN "2023-05-01" AND "2023-05-31"
Ver preços que mudaram entre meses
SELECT sku_name, price_start_time, pricing.default
FROM system.billing.list_prices
WHERE price_start_time BETWEEN "2023-05-01" AND "2023-07-01"
Estimar os custos adicionais para uso no mês do calendário anterior
Esta consulta aplica uma percentagem simples a toda a utilização no período. Observe que isso pode diferir ligeiramente da monetização real devido à forma como os direitos de alguns complementos são gerenciados. Substitua a taxa de complementos pela taxa da sua conta.
SELECT SUM(usage.usage_quantity * list_prices.pricing.effective_list.default) * {{ add_on_rate }} as `Total Add-On Dollar Cost`
FROM system.billing.usage
JOIN system.billing.list_prices ON list_prices.sku_name = usage.sku_name
WHERE usage.usage_end_time >= list_prices.price_start_time
AND (list_prices.price_end_time IS NULL OR usage.usage_end_time < list_prices.price_end_time)
AND usage.usage_date BETWEEN "2024-02-01" AND "2024-02-29"