TABLE_STORAGE_BY_FOLDER ビュー

INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER ビューには、現在のプロジェクトの親フォルダ（サブフォルダを含む）のテーブルまたはマテリアライズド ビューごとに 1 行が含まれます。

このテーブルにはリアルタイムのデータは保持されず、数秒から数分遅れることがあります。パーティションまたはテーブルの有効期限のみに起因するストレージの変更、またはデータセットのタイムトラベル期間への変更に起因するストレージの変更が INFORMATION_SCHEMA.TABLE_STORAGE ビューに反映されるまでに、最大 1 日かかる場合があります。1,000 を超えるテーブルを含むデータセットが削除された場合、削除されたデータセットのタイムトラベル期間が経過するまで、このビューに変更は反映されません。

テーブル ストレージ ビューでは、現在のストレージの消費を簡単にモニタリングできます。また、ストレージで論理非圧縮バイト、物理圧縮バイト、タイムトラベル バイトのいずれを使用しているかの詳細も確認できます。この情報は、今後の拡張に向けた計画や、テーブルの更新パターンの把握に役立ちます。

*_BYTES 列に含まれるデータ

テーブル ストレージ ビューの *_BYTES 列には、ストレージの使用量（バイト）に関する情報が含まれています。この情報は、マテリアライズド ビューと次のタイプのテーブルのストレージ使用量を調べることで確認できます。

• テーブルの作成と使用で説明されている方法のいずれかを使用して作成された永続テーブル。
• セッションで作成された一時テーブル。これらのテーブルは、生成された名前（「_c018003e063d09570001ef33ae401fad6ab92a6a」など）でデータセットに配置されます。
• 複数ステートメント クエリ（「スクリプト」）で作成された一時テーブル。これらのテーブルは、生成された名前（「_script72280c173c88442c3a7200183a50eeeaa4073719」など）でデータセットに配置されます。

クエリ結果キャッシュに保存されているデータは課金されないため、*_BYTES 列の値には含まれません。

クローンとスナップショットは、ベーステーブルが使用しているストレージとの差分を表示するのではなく、あたかも完全なテーブルであるかのように *_BYTES 列の値を表示するため、過大評価になります。請求では、ストレージ使用量のこの差分が正しく反映されます。クローンとスナップショットの作成によって保存され、課金されるデルタバイトについて詳しくは、TABLE_STORAGE_USAGE_TIMELINE ビューをご覧ください。

ストレージ課金を予測する

データセットの毎月のストレージ請求額を予測するには、データセットによって使用されるデータセット ストレージ課金モデルに応じて、このビュー内の logical 列または physical *_BYTES 列を使用できます。これはおおよその予測であり、正確な請求額は、BigQuery のストレージ課金インフラストラクチャによる使用量に基づいて計算され、Cloud Billing に表示されることに注意してください。

論理課金モデルを使用するデータセットの場合、月間ストレージ費用は、次のように予測できます。

((ACTIVE_LOGICAL_BYTES value / POW(1024, 3)) * アクティブな論理バイト料金) + ((LONG_TERM_LOGICAL_BYTES value / POW(1024, 3)) * 長期論理バイトの料金)

テーブルの ACTIVE_LOGICAL_BYTES 値には、そのテーブルで現在使用されているアクティブなバイト数が反映されます。

物理課金モデルを使用するデータセットの場合は、ストレージ費用を次のように予測できます。

((ACTIVE_PHYSICAL_BYTES + FAIL_SAFE_PHYSICAL_BYTES value / POW(1024, 3)) * アクティブな物理バイト料金) + ((LONG_TERM_PHYSICAL_BYTES value / POW(1024, 3)) * 長期物理バイトの料金)

テーブルの ACTIVE_PHYSICAL_BYTES 値には、そのテーブルで現在使用されているアクティブなバイト数と、そのテーブルのタイムトラベルに使用されたバイト数が反映されます。

テーブルのアクティブなバイト数のみを表示するには、ACTIVE_PHYSICAL_BYTES 値から TIME_TRAVEL_PHYSICAL_BYTES 値を減算します。

詳細については、ストレージの料金をご覧ください。

必要な権限

INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER ビューをクエリするには、プロジェクトの親フォルダに対する次の Identity and Access Management（IAM）権限が必要です。

• bigquery.tables.get
• bigquery.tables.list

次の各 IAM 事前定義ロールには、上の権限が含まれています。

• roles/bigquery.admin
• roles/bigquery.dataViewer
• roles/bigquery.dataEditor
• roles/bigquery.metadataViewer

BigQuery の権限の詳細については、BigQuery の IAM ロールと権限をご覧ください。

スキーマ

INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER ビューのスキーマは次のとおりです。

スコープと構文

このビューに対するクエリでは、リージョン修飾子を指定する必要があります。次の表に、このビューのリージョン スコープを示します。

• 省略可: PROJECT_ID: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
• REGION: 任意のデータセット リージョン名。例: `region-us`

指定したプロジェクトの親フォルダにあるテーブルのストレージ情報を取得するには、次のクエリを実行します。

SELECT * FROM `myProject`.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER;

例

次のクエリは、フォルダ内のどのプロジェクトが最もストレージを使用しているかを示します。

SELECT
  project_id,
  SUM(total_logical_bytes) AS total_logical_bytes
FROM
  `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER
GROUP BY
  project_id
ORDER BY
  total_logical_bytes DESC;

次のような結果になります。

+---------------------+---------------------+
|     project_id      | total_logical_bytes |
+---------------------+---------------------+
| projecta            |     971329178274633 |
+---------------------+---------------------+
| projectb            |     834638211024843 |
+---------------------+---------------------+
| projectc            |     562910385625126 |
+---------------------+---------------------+