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 ステートメントでは使用できません。