BigQuery INFORMATION_SCHEMA の概要

INFORMATION_SCHEMA は、以下に関する情報を提供する一連のビューです。

リソースの種類 INFORMATION_SCHEMA ビュー
アクセス制御 INFORMATION_SCHEMA.OBJECT_PRIVILEGES
データセット INFORMATION_SCHEMA.SCHEMATA
データセット オプション INFORMATION_SCHEMA.SCHEMATA_OPTIONS
仕事 INFORMATION_SCHEMA.JOBS_BY_*
ジョブのタイムライン INFORMATION_SCHEMA.JOBS_TIMELINE_BY_*
予約 INFORMATION_SCHEMA.RESERVATION*
予約の割り当て INFORMATION_SCHEMA.ASSIGNMENT*
予約容量のコミットメント INFORMATION_SCHEMA.CAPACITY_COMMITMENT*
ルーティン INFORMATION_SCHEMA.ROUTINES
ルーティンのオプション INFORMATION_SCHEMA.ROUTINE_OPTIONS
ルーティンのパラメータ INFORMATION_SCHEMA.PARAMETERS
セッション INFORMATION_SCHEMA.SESSIONS_BY_*
ストリーミング データ INFORMATION_SCHEMA.STREAMING_TIMELINE_BY_*
テーブル INFORMATION_SCHEMA.TABLE*
テーブル列 INFORMATION_SCHEMA.COLUMN*
テーブル パーティション INFORMATION_SCHEMA.PARTITIONS
Table Snapshots TABLE_SNAPSHOTS
テーブルのストレージ使用量（現在） INFORMATION_SCHEMA.TABLE_STORAGE
テーブル ストレージ使用量の推移 INFORMATION_SCHEMA.TABLE_STORAGE_TIMELINE_BY_*
ビュー INFORMATION_SCHEMA.VIEWS

料金

オンデマンド料金を使用するプロジェクトの場合、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
  • ROUTINES
  • ROUTINE_OPTIONS
  • TABLES
  • TABLE_OPTIONS
  • VIEWS

リージョン修飾子

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

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

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

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

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

  • データセット修飾子をサポートするすべてのビュー
  • ASSIGNMENT_CHANGES_BY_PROJECT
  • ASSIGNMENTS_BY_PROJECT
  • CAPACITY_COMMITMENT_CHANGES_BY_PROJECT
  • CAPACITY_COMMITMENTS_BY_PROJECT
  • JOBS_BY_ORGANIZATION
  • JOBS_BY_FOLDER
  • JOBS_BY_PROJECT
  • JOBS_BY_USER
  • JOBS_TIMELINE_BY_ORGANIZATION
  • JOBS_TIMELINE_BY_FOLDER
  • JOBS_TIMELINE_BY_PROJECT
  • JOBS_TIMELINE_BY_USER
  • OBJECT_PRIVILEGES
  • RESERVATION_CHANGES_BY_PROJECT
  • RESERVATIONS_PROJECT
  • STREAMING_TIMELINE_BY_ORGANIZATION
  • STREAMING_TIMELINE_BY_FOLDER
  • STREAMING_TIMELINE_BY_PROJECT
  • SCHEMATA
  • SCHEMATA_OPTIONS
  • TABLE_STORAGE
  • TABLE_STORAGE_TIMELINE_BY_ORGANIZATION
  • TABLE_STORAGE_TIMELINE_BY_PROJECT

プロジェクト修飾子

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

-- Returns metadata for the specified project in a 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 ビューは、プロジェクト ID 修飾子をサポートしています。

  • データセット修飾子をサポートするすべてのビュー
  • リージョン修飾子をサポートするすべてのビュー

制限事項

BigQuery INFORMATION_SCHEMA には次の制限があります。

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