このページでは、BigQuery の各テーブルへエクスポートされる Cloud Billing データのスキーマの参考情報を提供します。
課金データテーブル
BigQuery への Cloud Billing のエクスポートを有効にした直後に、課金データテーブルが BigQuery データセットに自動的に作成されます。
- 標準の使用料金テーブル – BigQuery データセットでは、このテーブルには
gcp_billing_export_v1_<BILLING_ACCOUNT_ID>という名前が付けられています。 - 詳細な使用料金テーブル - 標準の使用料金テーブルのすべてのデータ項目に加えて、リソースレベルの費用データを提供する追加の項目（例: サービス使用量を生成する仮想マシンまたは SSD）が含まれます。BigQuery データセットでは、このテーブルの名前は
gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>です。 - 料金テーブル - BigQuery データセットでは、このテーブルには
cloud_pricing_exportという名前が付けられています。
データの読み込み頻度
標準の使用料金と詳細な使用料金のエクスポート:
- BigQuery への標準の使用料金と詳細な使用料金のエクスポートを最初に有効にした際には、Google Cloud の費用データが表示されるまでに数時間を要する場合があります。
- Google Cloud サービスは、Cloud Billing プロセスに使用量データと費用データについてさまざまな間隔で報告します。
- Cloud Billing は、使用量と費用に関するデータを BigQuery データセットに定期的にエクスポートします（BigQuery へのエクスポートに対する配信やレイテンシの保証はありません）。
- 使用状況レポートの頻度は Google Cloud サービスによって異なるため、最近使用した Google Cloud サービスの Cloud Billing の使用状況と費用のデータが表示されない場合があります。
料金のエクスポート:
- BigQuery への料金データのエクスポートを最初に有効にした際には、Google Cloud の料金データが表示されるまでに最大 48 時間を要する場合があります。
- 料金データのエクスポートを有効にすると、Cloud 請求先アカウントに適用される料金データが 1 日に 1 回 BigQuery にエクスポートされます。
データの可用性:
- 標準の使用料金または料金データのエクスポートを有効にしているお客様の場合、BigQuery データセットには、最初にエクスポートを有効にした日以降に発生した Cloud Billing データのみが反映されます。Cloud Billing データは過去にさかのぼって追加されないため、エクスポートを有効にする前に使用した Cloud Billing データは表示されません。
- 詳細な使用料金データのエクスポートを初めて有効にするお客様については、前月の初日からの Cloud Billing データが利用可能になります。たとえば、9 月 23 日に詳細な使用料金データのエクスポートを有効にすると、エクスポートには 8 月 1 日以降のデータが含まれます。
- 詳細な使用料金データのエクスポートを有効、無効、その後に再び有効にした場合、明示的に無効にされた期間の Cloud Billing データを使用できなくなる可能性があります。
- エクスポートされたデータ（BigQuery エクスポート レコードなど）を削除した場合、削除されたレコードをバックフィルすることはできません。
- BigQuery の読み込みは ACID に準拠しているため、データの読み込みが完了する前に BigQuery Cloud Billing のエクスポート データセットにクエリを実行しても、読み込み途中のデータが取得されることはありません。BigQuery の特性については、こちらをご覧ください。
- 顧客管理の暗号鍵（CMEK）が有効になっているデータセットなど、BigQuery への課金データのエクスポートに影響する可能性のある他の制限事項をご覧ください。
標準の使用料金データのスキーマ
以下の情報は、BigQuery にエクスポートされる Google Cloud の標準の使用料金データのスキーマについて説明したものです。これには、アカウント ID、請求書の日付、サービス、SKU、プロジェクト、ラベル、ロケーション、費用、使用量、クレジット、調整、通貨など、標準の Cloud 請求先アカウントの使用料金情報が含まれます。
標準の使用料金データには、サービス使用量を生成する仮想マシンまたは SSD などのリソースレベルの費用データは含まれません。リソースレベルの費用データを BigQuery にエクスポートして分析する場合は、詳細な使用料金データの有効化を検討してください。エクスポートされた詳細な使用料金データには、標準の使用料金データに含まれるすべてのフィールドと情報が含まれます。
顧客管理の暗号鍵（CMEK）が有効になっているデータセットなど、BigQuery への課金データのエクスポートに影響する可能性のある他の制限事項をご覧ください。
BigQuery データセットで、標準の Google Cloud の使用料金データが gcp_billing_export_v1_<BILLING_ACCOUNT_ID> というデータテーブルに読み込まれます。
| 項目 | タイプ | 説明 |
|---|---|---|
billing_account_id |
文字列 | 使用量が関連付けられている Cloud 請求先アカウント ID。 販売パートナー向け: Cloud Billing サブアカウントで生成された使用量の費用の場合、これはサブアカウントの ID になります。親である販売パートナーの Cloud 請求先アカウントの ID ではありません。 |
invoice.month |
文字列 | 費用項目を含む請求書の年と月（YYYYMM）。たとえば、「201901」は 2019 年 1 月に相当します。 このフィールドを使用して、請求書の合計金額を取得できます。BigQuery クエリへの Cloud Billing のエクスポート例をご覧ください。 |
cost_type |
文字列 | この明細が表す費用のタイプ（通常、税、調整、または丸め誤差）。 |
service.id |
文字列 | 使用量が関連付けられているサービスの ID。 |
service.description |
文字列 | Cloud Billing データを報告した Google Cloud サービス。 |
sku.id |
文字列 | サービスが使用するリソースの ID。SKU の詳細な一覧については、Google Cloud SKU をご覧ください。 |
sku.description |
文字列 | サービスで使用されるリソースタイプの説明。たとえば、Cloud Storage のリソースタイプは Standard Storage US です。 |
usage_start_time |
タイムスタンプ | 指定された費用の計算が開始された時間（時間単位）すべてのサービスの使用量とコストは時間単位で表示されます。つまり、長時間実行されるサービスの場合、作業時間が複数の時間単位のウィンドウにまたがります。 詳細については、BigQuery ドキュメントの Timestamp データ型に関する説明をご覧ください。以下のエクスポートされたデータと請求書の相違もご覧ください。 |
usage_end_time |
タイムスタンプ | 指定された費用の計算が終了した時間（時間単位）すべてのサービスの使用量とコストは時間単位で表示されます。つまり、長時間実行されるサービスの場合、作業時間が複数の時間単位のウィンドウにまたがります。 詳細については、BigQuery ドキュメントの Timestamp データ型に関する説明をご覧ください。以下のエクスポートされたデータと請求書の相違もご覧ください。 |
project |
構造体 | project には、ID、番号、名前、祖先の番号、ラベルなど、Cloud Billing プロジェクトを記述するフィールドが含まれます。
|
project.id |
文字列 | Cloud Billing データを生成した Google Cloud プロジェクトの ID。 |
project.number |
文字列 | Cloud Billing データを生成した Google Cloud プロジェクトの一意の識別子（内部で生成されて匿名化される）。サポートケースや他のお客様とのコミュニケーションでは、Google はプロジェクト番号でプロジェクトを参照します。 |
project.name |
文字列 | Cloud Billing データを生成した Google Cloud プロジェクトの名前。 |
project.ancestry_numbers |
文字列 | 指定された project.id（たとえば、my-project-123）で識別されるプロジェクトのリソース階層に含まれる祖先。たとえば、/ParentOrgNumber/ParentFolderNumber/ のようになります。詳細については、リソース階層をご覧ください。 |
project.labels.key |
文字列 | ラベルがある場合、使用量が発生した Google Cloud プロジェクトのラベルを構成する Key-Value ペアの key の部分です。ラベルの使用について詳しくは、ラベルの使用をご覧ください。 |
project.labels.value |
文字列 | ラベルがある場合、使用量が発生した Google Cloud プロジェクトのラベルを構成する Key-Value ペアの value の部分です。ラベルの使用について詳しくは、ラベルの使用をご覧ください。 |
labels.key |
文字列 | ラベルがある場合、使用量が発生した Google Cloud リソースのラベルを構成する Key-Value ペアの key の部分です。ラベルの使用について詳しくは、ラベルの使用をご覧ください。 |
labels.value |
文字列 | ラベルがある場合、使用量が発生した Google Cloud リソースのラベルを構成する Key-Value ペアの value の部分です。ラベルの使用について詳しくは、ラベルの使用をご覧ください。 |
system_labels.key |
文字列 | システムラベルが存在する場合は、使用量が発生したリソースのシステムラベルを構成する Key-Value ペアの key の部分です。使用可能なシステムラベルもご覧ください。 |
system_labels.value |
文字列 | システムラベルが存在する場合は、使用量が発生したリソースのシステムラベルを構成する Key-Value ペアの value の部分です。使用可能なシステムラベルもご覧ください。 |
location.location |
文字列 | 使用が発生した国、リージョンまたはゾーンレベルでのロケーション。特定のロケーションのないリソースは global です。詳しくは、リージョンとゾーンをご覧ください。 |
location.country |
文字列 | location.location が国、リージョンまたはゾーンの場合、このフィールドは国になります（例: US）。詳しくは、リージョンとゾーンをご覧ください。 |
location.region |
文字列 | location.location が国またはリージョンの場合、このフィールドはリージョンになります（例: us-central1）。詳しくは、リージョンとゾーンをご覧ください。 |
location.zone |
文字列 | location.location がゾーンの場合、このフィールドはゾーンになります（例: us-central1-a）。詳しくは、リージョンとゾーンをご覧ください。 |
cost |
浮動小数点数 | クレジットが適用される前の使用料（小数点以下 6 桁の精度で）。クレジットを含む合計費用を算出するには、credits.amount を費用に追加する必要があります。詳しくは、このクエリ例をご覧ください。 |
currency |
文字列 | 費用の請求で使用されている通貨。詳細については、現地通貨での請求と支払いをご覧ください。 |
currency_conversion_rate |
浮動小数点数 | 米ドルから現地通貨への為替レート。つまり、cost÷currency_conversion_rate が米ドルでの金額になります。 |
usage.amount |
浮動小数点数 | 使用された usage.unit の量。 |
usage.unit |
文字列 | リソースの使用状況を測定する基本単位。たとえば、標準ストレージの基本単位はバイト秒です。 |
usage.amount_in_pricing_units
|
浮動小数点数 | 使用された usage.pricing_unit の量。 |
usage.pricing_unit
|
文字列 | Cloud Billing Catalog API によるリソース使用量の測定単位。 |
credits |
構造体 | credits には、Google Cloud と Google Maps Platform の SKU に関連付けられたクレジットの構造と値を記述するフィールドが含まれています。 |
credits.id |
文字列 | 存在する場合は、クレジットがプロダクトの SKU に関連付けられていることを示します。credits.id の値は、英数字からなる一意の識別子（例: 12-b34-c56-d78）、またはクレジット タイプの説明（確約利用割引: CPU など）です。
|
credits.full_name |
文字列 | プロダクトの SKU に関連付けられたクレジットの名前。これは、英数字 credits.id の人が読める形式の説明です。例としては、無料トライアルのクレジット、または費用ベースの確約利用割引をご覧ください。
|
credits.type |
文字列 | このフィールドは、credits.id の目的または送信元を示します。以下のようなクレジット タイプがあります。
|
credits.name |
文字列 | Cloud 請求先アカウントに適用されたクレジットの説明。 |
credits.amount |
浮動小数点数 | 使用量に適用されるクレジットの金額。クレジットは常に負の金額です。 |
adjustment_info |
構造体 | adjustment_info には、Cloud 請求先アカウントに関連付けられた費用項目に対する調整の構造と値を記述するフィールドが含まれています。
|
adjustment_info.id |
文字列 | 表示される場合、費用項目と調整が関連付けられたことを示します。adjustment_info.id は、問題に対して関連付けられたすべての調整の一意の ID です。 |
adjustment_info.description |
文字列 | 調整と原因の説明。 |
adjustment_info.type |
文字列 | 調整のタイプ。 以下のようなタイプがあります。
|
adjustment_info.mode |
文字列 | 調整の方法。 以下のようなモードがあります。
|
export_time |
タイムスタンプ | Cloud Billing データの追加に関連する処理時間。
これは、新しいエクスポートごとに常に増加します。 以下のエクスポートされたデータと請求書の相違もご覧ください。 |
詳細な使用料金データのスキーマ
詳細な使用料金データには、標準の使用料金データに含まれているすべての情報と、リソースレベルの費用データ（サービス使用量を生成する仮想マシンや SSD など）を提供する追加のフィールドが含まれます。
次の情報は、BigQuery にエクスポートされる Google Cloud の詳細な使用料金データのスキーマで提供され、標準の使用料金データのスキーマには含まれていない追加のフィールドについて説明します。
BigQuery データセットで、Google Cloud の詳細な使用料金データが gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID> というデータテーブルに読み込まれます。
BigQuery で詳細な使用料金データを使用する場合は、次の点に注意してください。
- 詳細な使用料金データの BigQuery データセットの選択時または作成時に、米国（US）または欧州連合（EU）に配置されているマルチリージョン データセットを使用する必要があります。
- 詳細な使用料金データのエクスポートを初めて有効にする場合は、前月の初日からの Cloud Billing データが利用可能になります。
- 詳細な使用料金データのエクスポートを有効、無効、その後に再び有効にした場合、明示的に無効にされた期間の Cloud Billing データを使用できなくなる可能性があります。
- 顧客管理の暗号鍵（CMEK）が有効になっているデータセットなど、BigQuery への課金データのエクスポートに影響する可能性のある他の制限事項をご覧ください。
- BigQuery テーブルで必要となる可能性のある追加データ容量と、標準の使用料金データのエクスポートではなく詳細な使用料金データのエクスポートを有効にしている場合は追加のコストを考慮してください。リソースレベルの情報の粒度が上がると、標準の使用料金形式で集計される行数が増加します。BigQuery の費用を管理するためのその他のベスト プラクティスについては、BigQuery で費用を抑えるを確認することをおすすめします。
| 項目 | タイプ | 説明 |
|---|---|---|
resource |
構造体 | サービスの使用量を生成するサービス リソース（仮想マシンや SSD など）に関連する情報の構造と値を記述するフィールド。 |
resource.global_name |
文字列 | 関連する使用量を生成したリソースのグローバルで一意なサービス ID。 |
resource.name |
文字列 | 関連する使用量を生成したリソースのサービス固有の ID。ユーザーが生成した値を入力できます。 |
使用料金の標準的なデータと詳細データを把握
以降のセクションでは、BigQuery にエクスポートされる標準と詳細な使用料金データについて説明します。
ラベルについて
BigQuery データセットにはラベルの列が表示されますが、現在のリリースではラベル値が空になるものがあります。ラベルのエクスポート データが取り込まれる時間はサービスに応じて異なり、各サービスが提供するタイミングによって決まります。
使用可能なシステムラベル
システムラベルは、使用量データを生成したリソースに関する重要なメタデータを含む Key-Value ペアです。以下のシステムラベルが自動的に適用されます。
system_labels.key |
例: system_labels.value |
説明 |
|---|---|---|
compute.googleapis.com/machine_spec |
n1-standard-1、custom-2-2048 | 仮想マシンの構成。詳細については、マシンタイプをご覧ください。 |
compute.googleapis.com/cores |
n1-standard-4 の場合は 4、custom-2-2048 の場合は 2。 | 仮想マシンで使用できる vCPU の数。 |
compute.googleapis.com/memory |
n1-standard-4 の場合は 15360（15 GB×1,024 MB/GB）、custom-2-2048 の場合は 2048。 | 仮想マシンで使用可能なメモリ量（MB 単位）。 |
compute.googleapis.com/is_unused_reservation |
true、false | ゾーンの予約で予約されているものの、使用されていない、予約された使用量を表します。 |
エクスポートされたデータと請求書の相違
Google Cloud サービスが Cloud Billing プロセスに使用量データと費用データを報告する間隔はさまざまです。このため、使用量が報告されるまでに多少の遅延（最大数日間）が生じる場合もあります。遅れて報告された使用量がその月の請求書に含まれず、翌月の請求書に繰り越される場合があります。ただし、使用量のタイムスタンプは、Cloud Billing プロセスに報告された実際の使用日時を表します。
タイムスタンプ フィールドを使用して費用を照会すると、返されたデータに、報告が遅れたために同じ月に生成された請求書に含まれていない使用量が含まれていることがあります。このため、返された Cloud Billing データとその請求書が直接マッピングできないことがあります。
タイムスタンプ フィールドには次のものが含まれます。
usage_start_timeusage_end_timeexport_time
請求書に直接マッピングされた Cloud Billing データを返すには、タイムスタンプ フィールドではなく invoice.month を使用します。
税
2020 年 9 月 1 日以降、使用料金の詳細データには、単一の項目ではなく、プロジェクトごとの納税義務額が表示されます。税金データに依存するクエリや可視化がある場合は、これらの変更に対応するためにクエリの更新が必要になる可能性があります。
たとえば、9 月 1 日より前に記録された費用については、次の例のように、使用料金データで税金の詳細データの納税義務総額が $10 と表示されます。
billing_account_id |
project.id |
cost_type |
cost |
|---|---|---|---|
| 123456-ABCDEF-123456 | example-project | 標準 | $60 |
| 123456-ABCDEF-123456 | test-project | 標準 | $40 |
| 123456-ABCDEF-123456 | [empty] | 税金 | $10 |
9 月 1 日以降に記録された費用については、$10 が example-project の $6 と test-project の $4 に分割されます。
billing_account_id |
project.id |
cost_type |
cost |
|---|---|---|---|
| 123456-ABCDEF-123456 | example-project | 標準 | $60 |
| 123456-ABCDEF-123456 | test-project | 標準 | $40 |
| 123456-ABCDEF-123456 | example-project | 税金 | $6 |
| 123456-ABCDEF-123456 | test-project | 税金 | $4 |
エラーと調整
万が一、Cloud Billing データにエラーが含まれていた場合や調整が必要な場合は、エラーを打ち消すデータが Cloud Billing データに追加されます。次の列以外は変更されません。
costcreditusage.amountexport_time
新しいデータを確認するには、クエリで export_time を取得します。
エクスポート データでは、Cloud Billing の調整とそれに関連する税金の請求月には、調整が発行された月が反映されます。ただし、調整の発行月とは異なる月の請求書に調整が適用される場合があります。調整が適用されるかどうかと、その適用場所については、Google Cloud Console のドキュメント ページの請求書またはクレジットメモ / デビットメモをご覧ください。調整の分析と適用方法について詳しくは、メモと調整についてをご覧ください。
標準的な使用料金データのクエリの例
料金データのスキーマ
BigQuery データセットで、Cloud 請求先アカウントの料金データは cloud_pricing_export というデータテーブルに読み込まれます。
次の情報は、BigQuery にエクスポートされる Cloud 請求先アカウントの料金データのスキーマについて説明しています。
| 項目 | タイプ | 説明 |
|---|---|---|
export_time |
タイムスタンプ | Cloud Billing データの追加に関連する処理時間。
これは、新しいエクスポートごとに常に増加します。 |
pricing_as_of_time |
タイムスタンプ | Cloud Billing アカウントに適用される料金データは、1 日に 1 回生成され、BigQuery にエクスポートできるように準備を行います。これは、料金データが生成されるときの日単位のタイムスタンプです。 |
billing_account_id |
文字列 | 使用量が関連付けられている Cloud 請求先アカウント ID。 |
billing_account_name |
文字列 | 料金が関連付けられている Cloud 請求先アカウントの名前。 |
business_entity_name |
文字列 | SKU を提供するサービスの Google サービス ファミリーの名前。値には、GCP（Google Cloud）またはマップ（Google Maps Platform）などがあります。 |
service.id |
文字列 | Cloud Billing データを報告した Google Cloud サービスまたは Google Maps Platform API の ID。たとえば、6F81-5844-456A。 |
service.description |
文字列 | Cloud Billing データを報告した Google Cloud サービスまたは Google Maps Platform API の説明文。たとえば、Compute Engine。 |
sku.id |
文字列 | サービスで使用されるリソース SKU の一意の識別子。たとえば、2E27-4F75-95CD。SKU の詳細な一覧については、Google Cloud SKU をご覧ください。 |
sku.description |
文字列 | サービスで使用されるリソース SKU の、人が読める形式の説明。たとえば、「南北アメリカで動作している事前定義の N1 インスタンス コア」。 |
sku.destination_migration_mappings |
文字列の配列 | この SKU の移行先の SKU 名。 |
product_taxonomy |
文字列の配列 | サーバーレス、Cloud Run、TaskQueue、オンデマンド VM、Cores: Per Core など、SKU に適用される商品カテゴリのリスト。 |
geo_taxonomy |
構造体 | SKU に適用される地理的メタデータ（us-east4 や EU などのマルチ リージョン）。 |
geo_taxonomy.type |
文字列 | SKU に関連付けられている地理的メタデータの種類。指定できる値は次のとおりです。
|
geo_taxonomy.regions |
文字列の配列 | その SKU に関連付けられている Google Cloud リージョン。たとえば、Europe-west2 や US です。リージョンは、ロンドンなどの特定の地理的な場所です。マルチリージョンは、米国などの、2 つ以上の地理的な場所を含む広い地理的なエリアです。 |
pricing_unit |
文字列 | 料金が設定されている使用量の単位の略語です（GiBy.mo など）。 |
pricing_unit_description |
文字列 | 人が読める形式の使用量の単位の説明（GiB-月など）。 |
account_currency_code |
文字列 | Cloud 請求先アカウントが動作するように構成する通貨。ISO 4217 で定義されている 3 文字の通貨コードを使用します。詳細については、請求と自動支払いの現地通貨をご覧ください。 |
currency_conversion_rate |
文字列 | Cloud 請求先アカウントが動作するように構成されている米ドルから現地通貨への為替レート。Cloud 請求先アカウントの通貨が USD の場合、為替レートのデフォルト値は 1.0 です。 Cloud Billing の費用が米ドル以外の通貨で請求されている場合、使用料金は、 Google が現地通貨で請求する場合、主要な金融機関が発表した換算レートに従って、価格を該当する現地通貨に換算します。これには、米ドル以外の通貨で請求される追加料金が含まれます。Google では、 |
list_price |
構造体 |
正規価格は すべての顧客について、正規価格データが生成され、エクスポートされます。Cloud 請求先アカウントにカスタムの契約料金が設定されている場合は、billing-account-specific 料金データもエクスポートされます。 |
billing_account_price |
構造体 | 契約料金が設定されている場合は、これは Cloud 請求先アカウントにリンクされている契約による、交渉済みの SKU 価格です。
契約料金（Cloud 請求先アカウントに適用される場合）は |
price_info |
構造体 | 契約料金に関する背景情報。 |
price_info.price_reason |
文字列 | 契約価格の根拠に関する背景情報。 理由は次のとおりです。
|
price_info.discount_percent |
数値 | 契約料金が割引率（FIXED_DISCOUNT または FLOATING_DISCOUNT）の結果に基づく場合、これが使用される割引率です。 |
price_info.discount_percent_fixed_date |
日付 | 特定の日付（FIXED_DISCOUNT）に関連付けられている割引率が適用された契約料金の場合は、この日付が使用されます。 |
price_info.discount_migrated_from |
文字列 | 他の SKU から移行された契約料金の割引（MIGRATED_PRICE）の場合、これが割引のソース SKU です。SKU が 2 つに分割されている場合がありますが、その場合、割引は古い SKU から新しい SKU に移行されます。 |
aggregation_info |
構造体 | 1 つの SKU の料金階層の集計レベルと間隔を表します。 |
aggregation_info.aggregation_level |
文字列 | 料金階層の費用を計算するために使用量が集計されるレベル。
以下のレベルがあります。
|
aggregation_info.aggregation_interval |
文字列 | 料金階層の費用を計算するために使用量が集計される間隔。
間隔は以下のとおりです。
|
tiered_rates |
文字列の配列 | SKU の価格（米ドル）と Cloud 請求先アカウントが使用するように構成されている通貨で表した SKU の料金などの料金階層に関する情報。 一部の SKU には 1 つの料金階層のみが存在します。SKU に複数の料金階層がある場合、各料金階層は異なる行として表示されます。 |
tiered_rates.pricing_unit_quantity |
浮動小数点数 | SKU の料金階層の単位数量。たとえば、1000000 バイトあたり $1 の料金階層の場合、この列には 1000000 が表示されます。 |
tiered_rates.start_usage_amount |
浮動小数点数 | この料金階層の最低料金（単価）。たとえば、1～100 ユニット、101～1000 ユニット、1001 以上のユニットなど、3 つの料金階層がある SKU では、[tiered_rates].start_usage_amount の値として、0、101、1001 の 3 つの価格の行が表示されます。 |
tiered_rates.usd_amount |
数値 | SKU の料金（米ドル）。 |
tiered_rates.account_currency_amount |
数値 | 米ドルから currency_conversion_rate を使用して Cloud 請求先アカウントが使用するように構成された通貨に変換された SKU の階層価格。この変換後の価格は、次の 現地通貨で請求される場合、料金の換算には大手金融機関の換算レートが使用されます。これには、米ドル以外の通貨で請求される追加料金が含まれます。Google では、 |
料金階層について
SKU の料金は、料金階層で指定されます。料金階層は、さまざまな階層レベルに基づく料金体系を示しています。一部の SKU は 1 つの料金階層のみを持ち、その他の SKU は複数の料金階層を持ちます。複数の料金階層で構成される SKU の例には次のものがあります。
- 無料使用枠付きの SKU。たとえば、1～1,000 ユニットは無料です。1,001 以上のユニットは、それぞれ $1 の料金となります。
- 階層内の使用量が超過すると、単価が引き下げられる SKU。たとえば、1～100 ユニットの単価は $5、101～1,000 ユニットの単価が $4、1,001 以上のユニットの単価は $3 に設定されます。
複数階層の料金に関する注意事項:
階層の使用カウンタは、SKU の
aggregation_interval（日単位または月単位）に基づいてゼロにリセットされます。- 米国とカナダの太平洋時間（UTC-8 または UTC-7）の毎日午前 12 時にリセットされる日単位の SKU。
- カレンダー月（1 月、2 月など）の毎月 1 日に、米国とカナダの太平洋時間（UTC-8 または UTC-7）の午前 12 時にゼロにリセットされる月単位の SKU。
階層は Cloud 請求先アカウントごとに独立して動作し、プロジェクトが同じ組織に属している場合や同じ法人に属している場合でも、複数の Cloud 請求先アカウントにまたがって集計されることはありません。
階層は SKU ごとに独立して動作します。1 つの SKU の使用量は、その SKU の価格にのみ影響します。現在、使用量が別の SKU の段階的料金に影響する SKU はありません。
正規価格の SKU 料金階層と交渉による価格の料金階層が必ずしも一致するとは限らないのでご注意ください。このような状況が発生するのはまれです。
SKU に複数の段階的料金がある場合、各 SKU 階層の価格は、料金表で個別の行として表示されます。
tiered_rates.start_usage_amountを使用して、複数の料金階層を持つ SKU を識別できます。クエリの作成方法によって、ネストしたデータまたはネストされていないデータとして SKU の料金階層を返すことができます。ネストされたデータとネストされていないデータの詳細については、以下の例をご覧ください。
料金クエリの例: 複数の料金階層を持つ SKU の正規価格を返す
BigQuery データは、テーブル名別にクエリします。クエリの FROM 句で使用されるテーブル名は、project.dataset.BQ_table_name の 3 つの値を使用して決定されます。
以下の例で使用している共通の値:
- テーブル名:
project.dataset.cloud_pricing_export - SKU ID:
2DA5-55D3-E679（Cloud Run - リクエスト）
例 1: ネストされたデータを返す
この例では、単一の SKU にクエリを実行して list_price データを返します。この SKU には複数の料金階層があります。正規価格フィールドの値は、SKU ID 行の下にネストされた個々の行に表示されます。
標準 SQL
SELECT sku.id AS sku_id,
sku.description AS sku_description,
service.id AS service_id,
service.description as service_description,
list_price.*
FROM my-billing-admin-project.my_billing_dataset.cloud_pricing_export
WHERE DATE(_PARTITIONTIME) = "2020-07-20"
AND sku.id = "2DA5-55D3-E679"
;
クエリ結果:
| Row | sku_id | sku_description | service_id | service_description | aggregation_info. aggregation_level |
aggregation_info. aggregation_interval |
tiered_rates. pricing_unit_quantity |
tiered_rates. start_usage_amount |
tiered_rates. usd_amount |
tiered_rates. account_currency_amount |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 2DA5-55D3-E679 | Requests | 152E-C115-5142 | Cloud Run | ACCOUNT | MONTHLY | 1000000 | 0 | 0 | 0 |
| 1000000 | 2000000 | 0.4 | 0.4 |
例 2: 同じテーブルに結合されたネストされていないデータを返す
この例では、単一の SKU にクエリを実行して list price を返します。SKU には、複数の料金階層があります。このクエリでは、UNNEST 演算子を使用して tiered_rates 配列をフラット化し、フィールドを同じテーブルに結合して、料金階層のそれぞれを 1 行にします。
標準 SQL
SELECT sku.id AS sku_id,
sku.description AS sku_description,
service.id AS service_id,
service.description as service_description,
tier.*
FROM `my-billing-admin-project.my_billing_dataset.cloud_pricing_export` as sku_pricing, UNNEST (sku_pricing.list_price.tiered_rates) as tier
WHERE DATE(_PARTITIONTIME) = "2020-07-20"
AND sku.id = "2DA5-55D3-E679"
;
クエリ結果:
| Row | sku_id | sku_description | service_id | service_description | pricing_unit_quantity | start_usage_amount | usd_amount | account_currency_amount |
|---|---|---|---|---|---|---|---|---|
| 1 | 2DA5-55D3-E679 | Requests | 152E-C115-5142 | Cloud Run | 1000000.0 | 0.0 | 0.0 | 0.0 |
| 2 | 2DA5-55D3-E679 | Requests | 152E-C115-5142 | Cloud Run | 1000000.0 | 2000000.0 | 0.4 | 40% |
料金データのすべてのクエリ例
制限事項
Cloud Billing データを BigQuery にエクスポートする場合、次の制限があります。
- 標準使用料金と価格データを含むお客様の BigQuery データセットには、Cloud Billing のエクスポートを設定した日以降に生成された Google Cloud Billing データのみが反映されます。すなわち、Google Cloud の課金データが過去にさかのぼって追加されることはありません。エクスポートを有効にする前の Cloud Billing データは表示されません。詳細については、データの可用性をご覧ください。
- 詳細な使用料データを含むお客様の BigQuery データセットには、再有効化を実施しない限り、エクスポートを最初に有効にした時点を含む月の開始時点以降に生成された Google Cloud Billing データが反映されます。つまり、Google Cloud の課金データは、当月と前月についてのみ遡及的に追加されます。詳細については、データの可用性をご覧ください。
- 詳細な使用状況データをエクスポートする場合は、米国（US）や欧州連合（EU）などのマルチリージョン ロケーションで構成されたデータセットにエクスポートする必要があります。マルチリージョン ロケーションではないデータセットを選択すると、Cloud Billing で詳細な課金データがそのデータセット内の適切なテーブルに書き込まれなくなります。
- BigQuery に請求データをエクスポートする場合、顧客管理の暗号鍵（CMEK）はサポートされません。請求データのデータセットに対して CMEK を有効にすると、Cloud Billing はデータセット内の適切なテーブルに請求データを書き込むことができなくなります。代わりに、データセットを構成して、Google が管理する鍵の暗号化を使用する必要があります。
関連トピック
エクスポートされた Cloud Billing データに関連するトピック
- BigQuery への Cloud Billing データのエクスポートを設定する
- BigQuery への Cloud Billing エクスポート データに対するクエリの例
- データポータルでの一定期間の利用額情報の可視化
Google Cloud Console で利用可能な費用と料金のレポート
- Cloud Billing レポートと費用傾向の表示
- 請求書または明細書の費用詳細の表示とダウンロード
- Google のクラウド サービスの料金を表示し、ダウンロードする
- 費用の内訳レポートでコスト削減を把握する
- 確約利用割引の効果の分析
- 費用とお支払い履歴の表示