価格設定システム テーブル リファレンス
重要
この機能はパブリック プレビュー段階にあります。
この記事では、スキーマとクエリーの例を含む、価格設定システム テーブルの概要について説明します。 価格設定テーブルを使用すると、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 |
struct | 公開された表示価格レートでの価格情報を含む構造化データ フィールド。 キー default は常に、単純な長期的見積もりに使用できる価格を 1 つ返します。 キー 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
前の暦月に特定のカスタム タグが使用されたすべてのものの合計コストを表示する
Note
カスタム タグのキーと値は、必ず置き換えてください。
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"