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

この記事では、スキーマやサンプルクエリなど、価格システムテーブルの概要を説明します。 価格表では、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

この価格が適用されるクラウドの名前。 可能な値は、 AWSAZUREGCPです。

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 価格が変更された時点のレコードのみが含まれているため、その日付以前の最新の価格変更を検索する必要があります。

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"