定價系統數據表參考

發行項
12/15/2024

本文提供定價系統數據表的概觀，包括架構和範例查詢。定價數據表可讓您存取 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`	字串	產生此報告之帳戶的標識碼	`1234567890123456`
`sku_name`	字串	SKU 的名稱	`STANDARD_ALL_PURPOSE_COMPUTE`
`cloud`	字串	此價格適用的雲端名稱。可能的值是 `AWS`、`AZURE`、`GCP`。	`AWS`、 `AZURE`或 `GCP`
`currency_code`	字串	這個價格的貨幣以表示	`USD`
`usage_unit`	字串	獲利的度量單位。	`DBU`
`pricing`	struct	結構化數據欄位，其中包含以已發佈的清單價格費率提供定價資訊。索引鍵 `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"

共用方式為