TABLE_STORAGE_BY_ORGANIZATION ビュー

INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION ビューには、現在のプロジェクトに関連付けられた組織全体のテーブルまたはマテリアライズド・ビューごとに 1 行が表示されます。このテーブルのデータはリアルタイムで保持されるのではなく、数秒から数分遅れることがあります。

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

`*_BYTES` 列に含まれるデータ

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

テーブルの作成と使用で説明されている方法のいずれかを使用して作成された永続テーブル。
セッションと複数ステートメントクエリ（スクリプト）で生成された一時テーブル。

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

クローンとスナップショットによるストレージ使用量は課金されますが、クローンとスナップショットに関する情報はテーブルストレージビューに含まれません。

ストレージの請求を予測する

データセットの毎月のストレージ請求額を予測するには、データセットによって使用されるデータセットストレージ課金モデルに応じて、このビュー内の 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 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_ORGANIZATION ビューにクエリを実行するには、組織の次の Identity and Access Management（IAM）権限が必要です。

bigquery.tables.get
bigquery.tables.list

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

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

このスキーマビューは、Google Cloud 組織が定義されているユーザーのみが使用できます。

BigQuery の権限の詳細については、IAM でのアクセス制御をご覧ください。

スキーマ

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

列名	データ型	値
`PROJECT_ID`	`STRING`	データセットを含むプロジェクトのプロジェクト ID
`PROJECT_NUMBER`	`INT64`	データセットを含むプロジェクトのプロジェクト番号
`TABLE_SCHEMA`	`STRING`	テーブルやマテリアライズドビューを含むデータセットの名前（`datasetId` とも呼ばれる）
`TABLE_NAME`	`STRING`	テーブルまたはマテリアライズドビューの名前（`tableId` とも呼ばれる）
`CREATION_TIME`	`TIMESTAMP`	テーブルの作成時間
`TOTAL_ROWS`	`INT64`	テーブルまたはマテリアライズドビューの行の総数
`TOTAL_PARTITIONS`	`INT64`	テーブルまたはマテリアライズドビューに存在するパーティションの数。パーティション分割されていないテーブルは 0 を返します。
`TOTAL_LOGICAL_BYTES`	`INT64`	テーブルまたはマテリアライズドビューの論理（非圧縮）バイトの合計数
`ACTIVE_LOGICAL_BYTES`	`INT64`	作成後 90 日未満の論理（非圧縮）バイト数
`LONG_TERM_LOGICAL_BYTES`	`INT64`	作成後 90 日以上経過した論理（非圧縮）バイト数
`TOTAL_PHYSICAL_BYTES`	`INT64`	ストレージに使用される物理（圧縮）バイトの合計数（アクティブ、長期、タイムトラベル（削除または変更されたデータ）バイトを含む）
`ACTIVE_PHYSICAL_BYTES`	`INT64`	90 日未満の物理（圧縮）バイト数（タイムトラベル（削除または変更されたデータ）バイトを含む）
`LONG_TERM_PHYSICAL_BYTES`	`INT64`	作成後 90 日以上経過した物理（圧縮）バイト数
`TIME_TRAVEL_PHYSICAL_BYTES`	`INT64`	タイムトラベルストレージ（削除または変更されたデータ）で使用される物理（圧縮）バイト数

スコープと構文

このビューに対するクエリでは、リージョン修飾子を指定する必要があります。リージョン修飾子を指定しない場合、メタデータはすべてのリージョンで取得されます。次の表で、このビューのリージョンスコープを説明します。

ビュー名	リソーススコープ	リージョンスコープ
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION	指定されたプロジェクトを含む組織	`REGION`

以下を置き換えます。

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

SELECT
  CONCAT(v1.table_catalog, ":", v1.table_schema, ".", v1.table_name) AS unmodified_table_name,
FROM
  `region-REGION`.INFORMATION_SCHEMA.TABLES v1
LEFT JOIN `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION v2 ON v1.table_name = v2.table_name
WHERE v2.table_name IS NULL;

次の例は、組織内の指定プロジェクトのテーブルのストレージ情報を返す方法を示しています。

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

次の例は、組織内のテーブルのストレージ情報をプロジェクト別に返す方法を示しています。

SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION;

例

次の例では、現在組織で最もストレージを使用しているプロジェクトを示します。

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

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

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