次の方法で共有

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

  • [アーティクル]

この記事では、スキーマとクエリーの例を含む、価格設定システム テーブルの概要について説明します。 価格設定テーブルを使用すると、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 価格が変更された時刻のレコードのみが含まれるため、その日付以前の最新の価格変更を検索する必要があります。

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"