BigQuery INFORMATION_SCHEMA の概要

BigQuery INFORMATION_SCHEMA ビューは、BigQuery オブジェクトに関するメタデータ情報を提供するシステム定義の読み取り専用ビューです。次の表は、メタデータ情報を取得するためにクエリできるすべての INFORMATION_SCHEMA ビューを示しています。

リソースの種類	INFORMATION_SCHEMA ビュー
アクセス制御	OBJECT_PRIVILEGES
BI 予約	BI_CAPACITIES BI_CAPACITY_CHANGES
設定オプション	EFFECTIVE_PROJECT_OPTIONS ORGANIZATION_OPTIONS PROJECT_OPTIONS
データセット	SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS
インデックス メタデータ	SEARCH_INDEXES SEARCH_INDEXES_COLUMNS
ジョブ メタデータ	JOBS_BY_PROJECT^† JOBS_BY_USER JOBS_BY_FOLDER JOBS_BY_ORGANIZATION
タイムスライスごとのジョブ メタデータ	JOBS_TIMELINE_BY_PROJECT^† JOBS_TIMELINE_BY_USER JOBS_TIMELINE_BY_FOLDER JOBS_TIMELINE_BY_ORGANIZATION
予約のメタデータ	RESERVATIONS_BY_PROJECT^† RESERVATION_CHANGES_BY_PROJECT^† RESERVATIONS_TIMELINE_BY_PROJECT^† ASSIGNMENTS_BY_PROJECT^† ASSIGNMENT_CHANGES_BY_PROJECT^† CAPACITY_COMMITMENTS_BY_PROJECT^† CAPACITY_COMMITMENT_CHANGES_BY_PROJECT^†
ルーティン	ROUTINES
ルーティン オプション	ROUTINE_OPTIONS
ルーティン パラメータ	PARAMETERS
セッション メタデータ	SESSIONS_BY_PROJECT^† SESSIONS_BY_USER
ストリーミング データ	STREAMING_TIMELINE_BY_PROJECT^† STREAMING_TIMELINE_BY_FOLDER STREAMING_TIMELINE_BY_ORGANIZATION
テーブル メタデータ	TABLES TABLE_OPTIONS
テーブル列	COLUMNS COLUMN_FIELD_PATHS
テーブル パーティション	PARTITIONS
Table Snapshots	TABLE_SNAPSHOT
テーブルのストレージ使用量（現在）	TABLE_STORAGE_BY_PROJECT^† TABLE_STORAGE_BY_ORGANIZATION
テーブルのストレージ使用量の推移	TABLE_STORAGE_TIMELINE_BY_PROJECT^† TABLE_STORAGE_TIMELINE_BY_ORGANIZATION
ビュー	VIEWS

^† *BY_PROJECT ビューの場合、BY_PROJECT 接尾辞はオプションです。たとえば、INFORMATION_SCHEMA.JOBS_BY_PROJECT と INFORMATION_SCHEMA.JOBS をクエリすると、同じ結果が返されます。

注: すべてのINFORMATION_SCHEMAビューがBigQuery Omni システム テーブルをサポートしているわけではありません。Amazon S3 と Azure Storage のリソース メタデータを INFORMATION_SCHEMA で表示できます。

料金

オンデマンド料金を使用するプロジェクトの場合、INFORMATION_SCHEMA ビューに対するクエリでは、クエリによって処理されたバイト数が 10 MB 未満であっても最低 10 MB のデータ処理料金が発生します。オンデマンド クエリの最小課金額は 10 MB です。詳しくは、オンデマンド料金をご覧ください。

定額料金を使用するプロジェクトの場合、INFORMATION_SCHEMA ビューおよびテーブルにクエリすると、購入した BigQuery スロットが消費されます。詳細については、定額料金をご覧ください。

INFORMATION_SCHEMA クエリはキャッシュに保存されません。INFORMATION_SCHEMA クエリを実行するたびに同じクエリテキストを使用しても、クエリを実行するたびに課金されます。

INFORMATION_SCHEMA ビューの保存料金はかかりません。

構文

INFORMATION_SCHEMA ビューは、データセットまたはリージョンで限定される必要があります。

データセット修飾子

データセット修飾子が存在すると、データセット修飾子で指定されたデータセットに結果が制限されます。 次に例を示します。

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

次の INFORMATION_SCHEMA ビューは、データセット修飾子をサポートしています。

• COLUMNS
• COLUMN_FIELD_PATHS
• PARAMETERS
• PARTITIONS
• ROUTINES
• ROUTINE_OPTIONS
• TABLES
• TABLE_OPTIONS
• VIEWS

リージョン修飾子

リージョン修飾子は region-REGION 構文を使用して表されます。REGION には任意のデータセットのロケーション名を使用できます。たとえば、次のリージョン修飾子は有効です。

• region-us
• region-asia-east2
• region-europe-north1

リージョン修飾子が存在すると、リージョン修飾子で指定されたロケーションに結果が制限されます。たとえば、次のクエリは US マルチリージョンのプロジェクト内のすべてのデータセットのメタデータを返します。

-- Returns metadata for all datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;

次の INFORMATION_SCHEMA ビューは、リージョン修飾子をサポートしていません。

• INFORMATION_SCHEMA.PARTITIONS
• INFORMATION_SCHEMA.SEARCH_INDEXES
• INFORMATION_SCHEMA.SEARCH_INDEX_COLUMNS

リージョン修飾子とデータセット修飾子のどちらも指定されていない場合、エラーが発生します。

プロジェクト修飾子

プロジェクト修飾子がある場合、プロジェクト修飾子で指定されたプロジェクトに結果が制限されます。例:

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

すべての INFORMATION_SCHEMA ビューは、プロジェクト修飾子をサポートしています。プロジェクト修飾子が指定されていない場合は、デフォルトで、クエリが実行されているプロジェクトに表示されます。

組織レベルのビューのプロジェクト修飾子（例: STREAMING_TIMELINE_BY_ORGANIZATION、TABLE_STORAGE_TIMELINE_BY_ORGANIZATION）を指定しても、結果には影響しません。

制限事項

• BigQuery INFORMATION_SCHEMA クエリでは、Google 標準の SQL 構文を使用する必要があります。INFORMATION_SCHEMA はレガシー SQL をサポートしません。
• INFORMATION_SCHEMA クエリの結果はキャッシュに保存されません。
• INFORMATION_SCHEMA ビューは DDL ステートメントでは使用できません。