Genieのコストを監視し、理解する

Genie の使用状況は Databricks の課金システムテーブルに表示されます。そこで Genie のコストをクエリーおよび分析し、プロモーション価格が使用状況データにどのように反映されているかを確認できます。Service Principal を除く各ユーザーには、毎月 150 Databricks ユニット（DBU）が無料で提供されます。この記事では、その無料枠の消費量を追跡する方法を説明します。

注記

2027年1月31日まで、ユーザーによるGenie OneおよびGenie Agentsの使用は無料です。Service Principalは除外され、その使用量は課金されます。Genie Codeは、ユーザーごとの月間150 DBUの無料枠を超えると課金されます。

Genieの予算とコスト管理の設定に関する情報については、Genieの予算とコスト管理を参照してください。

システムテーブルから Genie の使用状況をクエリーする

Genieの使用状況とコストを分析するには、system.billing.usageテーブルをクエリし、system.billing.list_pricesと結合します。system.billing.usageテーブルは数時間ごとに更新され、各使用状況レコードの行が含まれています。

以下の列は Genie のコストを理解する上で最も関連性が高いです：

列	説明
`billing_origin_product`	すべての Genie 使用量に対して `GENIE` に設定します。
`sku_name`	請求 SKU。利用状況が無料か課金対象かによって異なります。Genieの利用状況がSKUにどのようにマッピングされるかを参照してください。
`usage_quantity`	消費されたDBUの数。
`usage_metadata.genie.surface`	どの Genie 製品が使用量を生成したか (`GENIE_CODE`、`GENIE_ONE`、または `GENIE_AGENTS`) を識別します。
`usage_metadata.genie.channel`	アクセスチャンネル (例: `UI`)。
`identity_metadata.run_as`	クエリーの実行に使用されたIDを持つユーザー。
`product_features.genie.offering_type`	提供タイプ、たとえば `PAYGO`。
`custom_tags`	Genie の使用量に対して `{"databricks-product": "genie"}` を含みます。

列	説明
`billing_origin_product`	すべての Genie 使用量に対して `GENIE` に設定します。
`sku_name`	請求 SKU。利用状況が無料か課金対象かによって異なります。Genieの利用状況がSKUにどのようにマッピングされるかを参照してください。
`usage_quantity`	消費されたDBUの数。
`usage_metadata.genie.surface`	どの Genie 製品が使用量を生成したか (`GENIE_CODE`、`GENIE_ONE`、または `GENIE_AGENTS`) を識別します。
`usage_metadata.genie.channel`	アクセスチャンネル (例: `UI`)。
`identity_metadata.run_as`	クエリーの実行に使用されたIDを持つユーザー。
`product_features.genie.offering_type`	提供タイプ、たとえば `PAYGO`。
`custom_tags`	Genie の使用量に対して `{"databricks-product": "genie"}` を含みます。

Genie 使用量が SKU にどのようにマッピングされるか

Genie の使用量は、Genie 製品に基づいてではなく、使用量が無料か請求済みかに基づいて 2 つの SKU に分割されます。

SKU	内容	課金されますか？	`list_prices`に記載されていますか？
Serverlessリアルタイム推論（例えば、`ENTERPRISE_SERVERLESS_REAL_TIME_INFERENCE_<REGION>`）	すべての請求済み Genie 使用量	はい	はい
`GENIE_FREE_USAGE`	すべての無料Genie利用。無料で利用できるものについては、プロモーション価格を参照してください。	No	No

SKU	内容	課金されますか？	`list_prices`に記載されていますか？
Serverlessリアルタイム推論（例えば、`ENTERPRISE_SERVERLESS_REAL_TIME_INFERENCE_<REGION>`）	すべての請求済み Genie 使用量	はい	はい
`GENIE_FREE_USAGE`	すべての無料Genie利用。無料で利用できるものについては、プロモーション価格を参照してください。	No	No

usage_metadata.genie.surface を使用して、どの製品が使用量を生み出したかを特定します: GENIE_CODE、GENIE_ONE、または GENIE_AGENTS。

課金利用：Serverless リアルタイム推論 SKU

無料使用枠を超える Genie 使用量は、 Serverlessリアルタイム推論 SKU の下で課金されます。正確な SKU 名には、クラウドとリージョンが含まれます。たとえば、AWS 上の ENTERPRISE_SERVERLESS_REAL_TIME_INFERENCE_US_WEST_OREGON です。この SKU はすべてのクラウドで利用可能です。

Serverless リアルタイム Inference SKU は他の製品ラインと共有されているため、Genie の使用を分離するには、常に billing_origin_product = 'GENIE' でフィルタリングしてください。

無料利用状況: GENIE_FREE_USAGE SKU

注記

GENIE_FREE_USAGE SKUは2026年7月20日以降にのみ表示されます。この日付以前に消費された無料利用分はシステムテーブルには表示されません。

すべての無料Genie利用状況はsku_name = 'GENIE_FREE_USAGE'の下に表示されます。これには、以下が含まれます。

無料利用枠内の使用 : Service Principalを除く各ユーザーには、毎月1日にResetされる150 DBUの無料利用枠があります。
Genie One および Genie Agents のプロモーション利用 : 2027 年 1 月 31 日まで、ユーザーによる Genie One および Genie Agents の利用は無料であり、GENIE_FREE_USAGE SKU として記録されます。Service Principalは除外され、その利用料金は請求されます。

これは無料の利用状況SKUです。消費量を追跡しますが、定価はありません。そのため、system.billing.list_pricesに対応するエントリはありません。system.billing.usageとsystem.billing.list_pricesを結合すると、このSKUを持つ行は一致するものを返しません。これは想定通りです。利用状況が無料であるためです。

無料利用 SKU 内の製品を区別するには、usage_metadata.genie.surface でフィルタリングします：

GENIE_CODE: Genie Codeの無料利用状況
GENIE_ONE: Genie One
GENIE_AGENTS：Genieエージェント

Genieの利用状況をクエリー

請求対象となるGenieの使用量とコストをクエリー

以下のクエリーは、ユーザーごと、日ごとのすべての課金対象Genie利用状況を返します。これにはGenie Codeおよび有料SKUで計測されるその他のGenie利用状況が含まれます。無料利用SKU（GENIE_FREE_USAGE）の行は除外されます。

SQL
SELECT
  u.account_id,
  u.workspace_id,
  u.usage_date,
  u.identity_metadata.run_as AS run_as_user,
  u.usage_metadata.genie.surface AS genie_surface,
  u.usage_metadata.genie.channel AS genie_channel,
  u.sku_name,
  SUM(u.usage_quantity) AS dbus,
  SUM(u.usage_quantity * lp.pricing.effective_list.default) AS list_cost
FROM system.billing.usage u
JOIN system.billing.list_prices lp
  ON  u.sku_name = lp.sku_name
  AND u.usage_end_time >= lp.price_start_time
  AND (lp.price_end_time IS NULL OR u.usage_end_time < lp.price_end_time)
WHERE u.billing_origin_product = 'GENIE'
  AND u.sku_name != 'GENIE_FREE_USAGE'
GROUP BY
  u.account_id,
  u.workspace_id,
  u.usage_date,
  u.identity_metadata.run_as,
  u.usage_metadata.genie.surface,
  u.usage_metadata.genie.channel,
  u.sku_name
ORDER BY u.usage_date DESC

ユーザーごとの無料および請求対象のGenieの使用量をクエリー

ユーザーごとの無料と請求対象のGenie DBU消費量の月間累計を確認するには、以下のクエリーを使用してください。

注記

GENIE_FREE_USAGE SKUでの無料利用分は2026年7月20日以降にのみ表示されます。この日付以前に消費された無料利用分はシステムテーブルには表示されません。

SQL
SELECT
  u.identity_metadata.run_as AS user,
  u.usage_metadata.genie.surface AS genie_surface,
  SUM(CASE WHEN u.sku_name = 'GENIE_FREE_USAGE' THEN u.usage_quantity ELSE 0 END) AS free_dbus,
  SUM(CASE WHEN u.sku_name != 'GENIE_FREE_USAGE' THEN u.usage_quantity ELSE 0 END) AS paid_dbus
FROM system.billing.usage u
WHERE u.billing_origin_product = 'GENIE'
  AND u.usage_date >= DATE_TRUNC('MONTH', CURRENT_DATE)
GROUP BY
  u.identity_metadata.run_as,
  u.usage_metadata.genie.surface
ORDER BY user, genie_surface

これにより、どのユーザーが無料使用量 (Genie Code 無料利用枠、Genie One、および Genie Agents) を消費しているか、または請求済み Genie Code 使用量を消費しているかを把握できます。

Genie のプロモーション価格を理解する

プロモーション期間中（2027年1月31日まで）、請求対象となるすべてのGenieの使用量に25％の割引が適用されます。割引はDBUの測定に自動的に組み込まれます。定価を正確に計算するには、請求対象となる使用量に、system.billing.list_prices からの pricing.effective_list.default を掛けます。割引が請求データにどのように表示されるかは、Genie製品によって異なります。

Genie Codeのプロモーション価格

Genie Codeのプロモーション価格は次のとおりです。

無料利用枠 : 各ユーザーは月間150の無料DBUを受け取ります。この利用状況はsystem.billing.usageに表示されますが、課金対象ではありません。
無料枠を超えた請求対象の使用量 ：25％のプロモーション割引がDBUメータリングに直接適用されるため、usage_quantityには割引後の消費量がすでに反映されています。定価に直接掛けることで定価ベースのコストを算出できますが、交渉による割引が適用される場合があります。

Serverless Real-Time Inference SKU は複数の製品ラインで共有されているため、割引は個別の割引 SKU としてではなく DBU メータリングに適用されます。Genie には個別の割引 SKU はありません。

プロモーション割引は、Serverlessリアルタイム推論SKUに適用される割引と組み合わされます。

Genie OneおよびGenieエージェントのプロモーション価格

2027 年 1 月 31 日まで、ユーザーによる Genie One および Genie Agents の利用は無料ですが、Service Principal の利用は課金されます。これらの製品の無料利用分は無料利用 SKU (GENIE_FREE_USAGE) を使用するため、請求データには割引や DBU の調整は表示されません。この無料利用分が課金対象の使用量でどの程度に相当するかを見積もるには、Estimate equivalent cost for free Genie usage のクエリーを使用してください。これには estimated_list_cost 列の 25% 割引が含まれています。

Genieの無料利用の相当コストを見積もる

無料使用量 (Genie One、Genie Agents、または Genie Code の無料利用枠) が Genie Code の料金で請求された場合にどのくらいの費用がかかるかを見積もりたい場合は、ワークスペースの既存の請求済み Genie Code 使用量からプロキシ SKU を解決し、その価格を適用できます。

仕組み：

無料利用の行を抽出 : sku_name = 'GENIE_FREE_USAGE'が該当するsystem.billing.usageをフィルタリングします。
ワークスペースごとのプロキシリージョンSKUを解決 : 各workspace_idについて、完全な履歴スキャンを避けるため、過去30日間に限定し、billing_origin_product = 'GENIE'とsku_name != 'GENIE_FREE_USAGE'が該当するsystem.billing.usageの最新レコードを見つけます。そのレコードのsku_nameをプロキシとして使用します。
プロキシSKUをアタッチする : 無料利用状況の行を、workspace_idのワークスペースごとのプロキシSKUルックアップに結合します。
価格検索 ：解決済みのsku_nameに対してsystem.billing.list_pricesを、価格の有効期間を考慮して結合します。

以下のクエリーは、当月分のユーザーごとの無料使用量の推定コストを返します。

SQL
-- Estimate the equivalent billed cost of GENIE_FREE_USAGE rows,
-- per user and workspace, with the 25% promotional discount applied.

WITH

-- Step 1: Isolate the free-usage rows for the current month
free_usage AS (
  SELECT
    account_id,
    workspace_id,
    identity_metadata.run_as AS run_as,
    usage_metadata.genie.surface AS genie_surface,
    usage_quantity,
    usage_end_time
  FROM system.billing.usage
  WHERE billing_origin_product = 'GENIE'
    AND sku_name = 'GENIE_FREE_USAGE'
    AND usage_date >= DATE_TRUNC('MONTH', CURRENT_DATE)
),

-- Step 2: Find the latest billed GENIE SKU per workspace, scoped to the last 30 days
latest_real_sku AS (
  SELECT
    workspace_id,
    max_by(sku_name, usage_start_time) AS proxy_sku_name
  FROM system.billing.usage
  WHERE billing_origin_product = 'GENIE'
    AND sku_name != 'GENIE_FREE_USAGE'
    AND usage_date >= CURRENT_DATE - 30
  GROUP BY workspace_id
),

-- Step 3: Attach the proxy SKU to each free-usage row
resolved AS (
  SELECT
    f.account_id,
    f.workspace_id,
    f.run_as,
    f.genie_surface,
    f.usage_quantity,
    f.usage_end_time,
    r.proxy_sku_name AS pricing_sku_name
  FROM free_usage f
  LEFT JOIN latest_real_sku r
    ON f.workspace_id = r.workspace_id
),

-- Step 4: Join to list prices on the resolved SKU + validity window, applying the 25% promotion
priced AS (
  SELECT
    r.account_id,
    r.workspace_id,
    r.run_as AS user,
    r.genie_surface,
    r.usage_quantity,
    lp.pricing.effective_list.default AS list_price_per_unit,
    r.usage_quantity * lp.pricing.effective_list.default * 0.75 AS estimated_list_cost
  FROM resolved r
  LEFT JOIN system.billing.list_prices lp
    ON  r.pricing_sku_name  = lp.sku_name
    AND r.usage_end_time    >= lp.price_start_time
    AND (lp.price_end_time IS NULL OR r.usage_end_time < lp.price_end_time)
)

-- Step 5: Aggregate per user, per workspace
SELECT
  account_id,
  workspace_id,
  user,
  genie_surface,
  SUM(usage_quantity) AS total_dbus,
  list_price_per_unit,
  SUM(estimated_list_cost) AS total_estimated_list_cost
FROM priced
GROUP BY account_id, workspace_id, user, genie_surface, list_price_per_unit
ORDER BY workspace_id, user, genie_surface

estimated_list_cost列は25%のプロモーション割引を適用し、この無料利用がプロモーション期間中（2027年1月31日まで）の課金対象利用としてどのくらいの費用になるかを反映しています。Genieのプロモーション価格についてを参照してください。

注記

このクエリーは、ワークスペースに少なくとも1つの課金された Genie Code 使用記録が存在する必要があります。ワークスペースに無料使用のみがあり、Genie Code 使用量がない場合、プロキシ SKU は NULL であり、価格は解決されません。

システムテーブルから Genie の使用状況をクエリーする​

Genie 使用量が SKU にどのようにマッピングされるか​

課金利用：Serverless リアルタイム推論 SKU​

無料利用状況: GENIE_FREE_USAGE SKU​

Genieの利用状況をクエリー​

請求対象となるGenieの使用量とコストをクエリー​

ユーザーごとの無料および請求対象のGenieの使用量をクエリー​

Genie のプロモーション価格を理解する​

Genie Codeのプロモーション価格​

Genie OneおよびGenieエージェントのプロモーション価格​

Genieの無料利用の相当コストを見積もる​

その他のリソース​