価格設定システムテーブルのリファレンス

この記事では、スキーマやサンプルクエリなど、価格システムテーブルの概要を説明します。価格表では、SKU 価格の履歴ログにアクセスできます。 SKU 価格が変更されるたびにレコードが追加されます。これらのログは、コスト分析を実行し、価格の変更を監視するのに役立ちます。

テーブルパス:このシステムテーブルは system.billing.list_pricesにあります。

価格表スキーマ

価格システムテーブルは次のスキーマを使用します。

列名	データ型	説明	例
`price_start_time`	timestamp	この価格が発効した時刻(UTC)	`2023-01-01T09:59:59.999Z`
`price_end_time`	timestamp	この価格がUTCで有効でなくなった時間	`2023-01-01T09:59:59.999Z`
`account_id`	string	このレポートが生成されたアカウントのID	`1234567890123456`
`sku_name`	string	SKU名	`STANDARD_ALL_PURPOSE_COMPUTE`
`cloud`	string	この価格が適用されるクラウドの名前。可能な値は、 `AWS`、 `AZURE`、 `GCP`です。	`AWS`、[ `AZURE`]、または `GCP`
`currency_code`	string	この価格が表される通貨	`USD`
`usage_unit`	string	収益化される測定単位。	`DBU`
`pricing`	構造体	公開された定価での価格情報を含む構造化データフィールド。キー `default` は、単純な長期見積もりに使用できる単一の価格を常に返します。キー`promotional`は、すべての顧客が取得する一時的なプロモーション価格を表し、一時的な期間中のコスト見積もりに使用できます。キー `effective_list` は、希望小売価格とプロモーション価格を解決し、コストの計算に使用される有効な希望小売価格を含みます。一部の価格モデルには、より詳細な情報を提供する追加のキーが含まれる場合もあります。	`{` `"default": "0.10",` `"promotional": {"default": "0.07"},` `"effective_list": {"default": "0.07"}` `}`

サンプルクエリ

次のサンプルクエリを使用して、SKU の価格設定に関する一般的な質問に回答できます。

特定の日付の特定の SKU の定価を検索する
前暦月に特定のカスタムタグを使用したすべてのものの合計コストを表示します
月間で変更された価格を表示する
前暦月の使用に対するアドオンコストを見積もる

ジョブコストの可観測性に関するクエリの例については、「システムテーブルを使用したジョブコストの監視」を参照してください。

特定の日付の特定の SKU の定価を検索する

テーブルには SKU 価格が変更された時点のレコードのみが含まれているため、その日付以前の最新の価格変更を検索する必要があります。

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

前暦月に特定のカスタムタグを使用したすべてのものの合計コストを表示します

注：

カスタムタグのキーと値を必ず置き換えてください。

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"

月間で変更された価格を表示する

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"

前暦月の使用に対するアドオンコストを見積もる

このクエリは、期間内のすべての使用量に単純な割合を適用します。これは、一部のアドオンのエンタイトルメントの管理方法により、実際の収益化とは若干異なる場合があることに注意してください。アドオン料金をアカウントの料金に置き換えます。

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"

価格設定システム テーブルのリファレンス