詳細なデータ エクスポートの構造

このドキュメントでは、BigQuery の各テーブルにエクスポートされる Cloud Billing の詳細な使用料金データのスキーマのリファレンス情報について説明します。

詳細な使用料金データには、標準の使用料金データに含まれているすべての情報と、詳細なリソースレベルの費用データ（使用量を生成する仮想マシンや SSD など）を提供する追加のフィールドが含まれます。詳細なエクスポートには、以下のサービスの詳しい費用情報が含まれます。

サービスごとの詳細な費用データを特定する

詳細なエクスポートで詳しい費用情報を分析するには、次の表を使用して、特定のリソースに関する情報を含む列を特定します。

リソースに対して詳細なデータのクエリを実行する例をご覧ください。

詳細な使用料金データのスキーマ

BigQuery データセットで、Google Cloud の詳細な使用料金データが gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID> というデータテーブルに読み込まれます。

BigQuery で詳細な使用料金データを使用する場合は、次の点に注意してください。

• 詳細な使用料金データに BigQuery データセットを選択または作成するときに、Cloud Billing データの使用がサポートされているデータセットのロケーションを選択できます。
• Cloud Billing で詳細な使用料金データのエクスポートを初めて有効にする場合、マルチリージョン ロケーション（EU または米国）が構成されたデータセットを選択すると、前月初日からさかのぼって Cloud Billing データを利用できるようになります。データは時系列でエクスポートされます。エクスポートされたデータの最初のバックフィルでは、Cloud Billing データの遡及的なエクスポートが完了して最新の使用状況データが表示されるまでに最大で 5 日ほどかかる場合があります。
• 詳細な使用料金データのエクスポートを有効にして、サポートされているリージョン ロケーションを使用するように構成されたデータセットを選択すると、エクスポートを有効にした日付から Cloud Billing データを利用できるようになります。
• 詳細な使用料金データのエクスポートを有効、無効にして、その後に再び有効にした場合、明示的に無効にされた期間の Cloud Billing データを使用できなくなる可能性があります。
• BigQuery テーブルへのデータの読み込み頻度をご覧ください。
• 顧客管理の暗号鍵（CMEK）が有効になっているデータセットなど、BigQuery への課金データのエクスポートに影響する可能性のある他の制限事項をご覧ください。
• BigQuery テーブルで必要となる可能性のある追加データ容量と、標準の使用料金データのエクスポートではなく詳細な使用料金データのエクスポートを有効にしている場合は追加のコストを考慮してください。リソースレベルの情報の粒度が上がると、標準の使用料金形式で集計される行数が増加します。BigQuery の費用を管理するためのその他のベスト プラクティスについては、BigQuery で費用を抑えるを確認することをおすすめします。

使用料金の標準的なデータと詳細データを把握する

以下のセクションでは、BigQuery にエクスポートされる標準と詳細な使用料金データについて説明します。

ラベルについて

特定のラベルの費用データには、ラベルがリソースに適用されてからの使用量のみが表示されます。たとえば、2024 年 1 月 15 日に Compute Engine VM に environment:dev というラベルを追加した場合、environment:dev の分析には 1 月 15 日以降の VM の使用量のみが含まれます。

また、各サービスで提供されるタイミングに応じて、サービスごとに異なる時刻のラベルデータが表示されることもあります。

使用可能なシステムラベル

システムラベルは、使用量データを生成したリソースに関する重要なメタデータを含む Key-Value ペアです。以下のシステムラベルが自動的に適用されます。

エクスポートされたデータと請求書の相違

Google Cloud プロダクトが、Cloud Billing プロセスに使用量データと費用データを報告する間隔はさまざまです。その結果、Google Cloud サービスの使用と、Cloud Billing に表示される使用量との間に遅延が生じる場合があります。通常、費用は 1 日以内に利用可能になりますが、24 時間以上かかる場合もあります。

遅れて報告された使用量がその月の請求書に含まれず、翌月の請求書に繰り越される場合があります。

タイムスタンプ フィールドを使用して費用を照会すると、返されたデータに、報告が遅れたために同じ月に生成された請求書に含まれていない使用量が含まれていることがあります。このため、返された Cloud Billing データとその請求書が直接マッピングできないことがあります。

タイムスタンプ フィールドには次のものが含まれます。

• usage_start_time
• usage_end_time
• export_time

請求書に直接マッピングされた Cloud Billing データを返すには、タイムスタンプ フィールドではなく invoice.month を使用します。

税

2020 年 9 月 1 日以降、使用料金の詳細データには、単一の項目ではなく、プロジェクトごとの納税義務額が表示されます。税金データに依存するクエリや可視化がある場合は、これらの変更に対応するためにクエリの更新が必要になることがあります。

たとえば、9 月 1 日より前に記録された費用については、次の例のように、使用料金データで税金の詳細データの納税義務総額が $10 と表示されます。

9 月 1 日以降に記録された費用については、$10 が example-project の $6 と test-project の $4 に分割されます。

エラーと調整

まれに、Cloud Billing データにエラーが含まれている場合や調整が必要な場合は、修正データが追加されます。これらの調整は、請求の変更または修正という 2 つのカテゴリのいずれかに分類されます。

お支払い情報の変更

請求の変更は、個別の項目として表示されます。請求の変更を受け取った場合は、BigQuery への Cloud Billing のエクスポートに新しい項目が表示され、変更内容を確認できます。表示される調整は、Google Cloud コンソールの [お支払い] セクションの [ドキュメント] 領域で入手可能な請求書、クレジットメモ、デビットメモのドキュメントに対応しています。

課金の変更とその適用方法について詳しくは、メモと調整についてをご覧ください。

修正

修正は、ソース SKU の誤ったデータを打ち消す新しいデータとして表示されます。場合によっては、誤った請求を置き換える新しいデータが表示されることがあります。課金データのエクスポートの列は、次の列を除き、元のデータと一致します。

• cost
• credit
• usage.amount
• export_time

たとえば、1 月 1 日に SKU A の使用に対して 10 ドルが請求されたとします。1 月分の請求書（2 月上旬に発行）には、SKU A に対する 10 米ドルの請求が表示されます。ただし、2 月 2 日に Google Cloud は SKU A に対する修正を発表し、使用料金を 5 ドルに引き下げました。2 月の請求書（3 月上旬に発行）に、次の 2 つの項目が追加されます。

• -1 月 1 日の使用料金 $10（元の請求額を相殺）
• 1 月 1 日の使用料金 $5（請求予定額を明記）

これらの新しいアイテムには、課金データのエクスポートに adjustment_info 列があります。過払いが表示されている 1 月の元の請求書は調整されません。請求データのエクスポートで請求額を確認するには、usage_start_time で費用を表示し、Day でグループ化します。これらのビューでは、収益化が遅れた使用量に対する修正や請求はすべて累積されます。一時的に誤ったデータが表示されていても、心配する必要はありません。

修正に関する詳細情報を確認するには、請求月のすべての請求を表示し、使用日が請求月より前の請求を探します。これらの請求は、修正が行われた場合や、収益化が遅れた使用量がある場合に発生します。

次のコードサンプルは、修正または遅延収益化の使用量の合計費用を返す基本的なクエリを作成する方法を示しています。

SELECT
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
      FROM   UNNEST(credits) c), 0))
    AS total
FROM `project.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE
  invoice.month = '202311' AND
  DATE(TIMESTAMP_TRUNC(usage_start_time, Day, 'US/Pacific')) < '2023-11-01';

請求書の請求で、使用日が請求月より前である場合のサービス別の費用の内訳を返すクエリの例については、「Cloud Billing データのエクスポートのクエリ例」の費用の詳細をクエリして、指定した請求月のサービスの修正または遅延収益化の使用状況を表示するをご覧ください。

カスタム料金契約のプロモーション クレジットについて

カスタム料金契約を結んでいる場合は、契約の一環として Google Cloud で使用するプロモーション クレジットが提供されます。たとえば、Compute Engine リソースで使用するための 1,000 ドルを受け取ることができます。通常、プロモーション クレジットは支払い方法とみなされます。プロモーション クレジットが利用可能な場合は、合計請求額の削減に自動的に適用されます。

契約条件により、プロモーション クレジットが SKU の正規価格で計算された費用に適用されるか、正味価格（割引適用後）に適用されるかが指定されます。

プロモーション クレジットが正規価格での計算対象になっている場合、料金明細レポートには、Contract billing adjustment という SKU の Invoice というサービスが含まれます。この SKU は、正規価格の費用に適用されるようにクレジットを調整します。調整の対象となる使用状況を確認するには、system.labels 列をクエリします。system.labels.key のキーは cloud-invoice.googleapis.com/sku_id で、system.labels.value の値にはクレジットと調整が適用された SKU ID が含まれています。

タグについて

タグは、Key-Value ペアの形式のリソースで、リソースに直接または継承によって関連付けることができます。タグは、チャージバック、監査、その他の費用の割り当て分析に使用できます。また、タグとポリシーの条件付き適用により、リソース階層全体にわたり、きめ細かい管理が可能です。

タグには堅牢な権限モデルがあり、継承、一元管理、命名規則の標準化、ポリシー エンジンの統合をサポートできます。一方、 ラベルはリソースにアノテーションを付けることができる別のツールです。

タグのデータは、リソース、プロジェクト、フォルダ、組織の BigQuery Export に表示されます。

利用可能なタグ

リソース、プロジェクト、フォルダ、組織の標準費用と詳細費用のエクスポートには、タグデータのタグキー、タグ値、タグ継承、タグ名前空間の各フィールドが含まれます。

Cloud Billing データ エクスポートのリソースレベルのタグは、次のリソースに使用できます。

• AlloyDB for PostgreSQL のクラスタ、インスタンス、バックアップ
• Artifact Registry リポジトリ
• Cloud Run のサービスとジョブ
• Cloud Storage バケット
• Compute Engine インスタンス
• Memorystore for Redis インスタンス
• Secret Manager シークレット
• Spanner インスタンス

タグの制限事項

• BigQuery のエクスポートにタグが反映されるまでに 1 時間ほどかかることがあります。1 時間以内にタグが追加または削除された場合、あるいはリソースの存在時間が 1 時間未満の場合は、エクスポートに表示されないことがあります。

詳細な使用料金のクエリ例

このセクションでは、BigQuery にエクスポートされた Cloud Billing 詳細な使用料金データをクエリする方法の例を示します。

• 請求書のリソースレベルの費用を返す
  • 請求書ごとの各リソースに対する合計費用
  • 請求月ごとの各リソースの費用タイプ別の詳細を返す

• Google Kubernetes Engine（GKE）クラスタの費用の内訳を確認する
  • GKE の費用内訳をフィルタ

詳細な使用料金のスキーマには、標準の使用料金のスキーマのすべてのフィールドが含まれるため、BigQuery にエクスポートされた標準データに対して提供されるクエリの例は、エクスポートされた詳細なデータでも機能します。標準的なクエリの例は、詳細な使用料金のエクスポート オプションで提供されるリソースレベルの情報を取得するためのものではありません。詳細なデータ用のクエリを作成する場合、標準的なクエリの例をテンプレートとして使用し、テーブル名を更新して、詳細な使用料金のスキーマで使用可能な任意のフィールドを追加できます。

詳細な使用料金のクエリ例で使用される一般的な値

このセクションのクエリの例では、[テーブル名] に値 project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX を使用する

請求書のリソースレベルの費用を返す

次のクエリで、エクスポートされた課金データを使用してリソースレベルの料金と請求書のクレジット額を表示する 2 つの方法を説明します。

• total フィールドは、浮動小数点数の料金とクレジット額をそのまま合計します。そのため、浮動小数点の丸め誤差が生じる可能性があります。
• total_exact フィールドは、料金とクレジット額をマイクロに変換してから合計します。その合計金額をドルに戻すことで、浮動小数点の丸め誤差を回避します。

請求書ごとの各リソースに対する合計費用

次のクエリでは、各月の resource.name ごとの請求総額が、通常料金、税金、調整額、および丸め誤差の合計として表示されます。リソースレベルの項目に関連付けられていない費用は、その月の名前 null で集計されます。

標準 SQL

SELECT
  invoice.month,
  resource.name,
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
                  FROM UNNEST(credits) c), 0))
    AS total,
  (SUM(CAST(cost * 1000000 AS int64))
    + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64))
                  FROM UNNEST(credits) c), 0))) / 1000000
    AS total_exact
FROM `project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY 1, 2
ORDER BY 1 ASC, 2 ASC
;

たとえば、前のクエリの結果は次のようになります。

請求月ごとの各リソースの費用タイプ別の詳細を返す

次のクエリでは、各月の resource.name ごとの cost_type あたりの合計が表示されます。料金タイプには、通常料金、税金、調整額、丸め誤差があります。リソースレベルの項目に関連付けられていない費用は、その月の名前 null で集計されます。

標準 SQL

SELECT
  invoice.month,
  cost_type,
  resource.name,
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
                  FROM   UNNEST(credits) c), 0))
    AS total,
  (SUM(CAST(cost * 1000000 AS int64))
    + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64))
                  FROM UNNEST(credits) c), 0))) / 1000000
    AS total_exact
FROM `project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY 1, 2, 3
ORDER BY 1 ASC, 2 ASC, 3 ASC
;

たとえば、前のクエリの結果は次のようになります。

Google Kubernetes Engine（GKE）クラスタの費用の内訳を確認する

このセクションでは、BigQuery エクスポート レポートで GKE クラスタの費用のフィルタリングを行う例を示します。GKE クラスタの費用の詳細については、クラスタの費用の内訳をご覧ください。

GKE の費用をフィルタする

次のサンプルクエリは、サポートされているリソースタイプの GKE の費用を、クラスタ名、名前空間、ラベルでフィルタしてグループ化する方法を示しています。

クレジット適用前の GKE クラスタの費用

SELECT
  SUM(cost) AS cost_before_credits,
  labels.value AS cluster_name
FROM  `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "goog-k8s-cluster-name"
GROUP BY labels.value
;

名前空間別のクレジット適用後の GKE の費用

SELECT
  labels.value as namespace,
  SUM(cost) + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0)) AS cost_after_credits,
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "k8s-namespace"
GROUP BY namespace
;

SKU 別の GKE 費用

SELECT
  project.id AS project_id,
  labels.value AS cluster_name,
  sku.id AS sku_id,
  sku.description AS sku_description,
  SUM(cost) AS cost
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
JOIN UNNEST(labels) AS labels
  ON labels.key = "goog-k8s-cluster-name"
GROUP BY
  cluster_name, project_id, sku_description, sku_id
;

タグを使用したクエリの例

以下の例は、タグを使用してデータをクエリする方法を示しています。

タグを使用して請求月ごとの費用を計算する

次のクエリは、cost_center タグの請求書月ごとの返品手数料を使用する方法を示しています。

SELECT
  invoice.month AS invoice_month,
  tag.value AS cost_center,
  ROUND((SUM(CAST(cost AS NUMERIC))
    + SUM(IFNULL((SELECT SUM (CAST(c.amount AS NUMERIC))
                  FROM UNNEST(credits) AS c), 0))), 2)
    AS net_cost
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`, UNNEST(tags) AS tag
WHERE tag.key = "cost_center" AND tag.namespace = "821092389413"
GROUP BY invoice.month, tag.value
ORDER BY invoice.month, tag.value;

たとえば、前のクエリの結果は次のようになります。

タグのないリソースの費用を表示する

次のクエリは、タグのないリソースの請求書の合計を請求月ごとにグループ化して表示します。

SELECT
 invoice.month AS invoice_month,
 ROUND((SUM(CAST(cost AS NUMERIC))
   + SUM(IFNULL((SELECT SUM(CAST(c.amount AS NUMERIC))
                 FROM UNNEST(credits) AS c), 0))), 2)
   AS net_cost
FROM
 `project-ID.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE "color" NOT IN (SELECT key FROM UNNEST(tags))
GROUP BY invoice_month
ORDER BY invoice_month;

たとえば、前のクエリの結果は次のようになります。

関連トピック

エクスポートされた Cloud Billing データに関連するトピック

• BigQuery への Cloud Billing データのエクスポートを設定する
• BigQuery への Cloud Billing エクスポート データに対するクエリの例
• Looker Studio で一定期間の利用額を可視化する

Google Cloud コンソールで利用可能な費用と料金のレポート

• Cloud Billing レポートと費用傾向の表示
• 請求書または明細書の費用詳細の表示とダウンロード
• Google のクラウド サービスの料金を表示し、ダウンロードする
• 費用の内訳レポートでコスト削減を把握する
• 確約利用割引の効果の分析
• 費用とお支払い履歴の表示