BigQueryのINFORMATION_SCHEMAの使い方

INFORMATION_SCHEMA とは

NFORMATION_SCHEMA は BigQuery における様々なメタデータを検索するために提供された一連のビュー群です。取得できるメタデータの一覧ははBigQuery のドキュメントで確認することができます。

本記事は、データセット、テーブル及びビューの取得方法について記述します。

始める前に

このドキュメントの各タスクを実行するために必要な Identity and Access Management（IAM）権限が必要です。 BigQuery の細かい権限の詳細については、役割と権限で確認できます。

INFORMATION_SCHEMA を使用したメタデータの取得

ここからは、INFORMATION_SCHEMA を使って、データセット、テーブル、ビューの情報をそれぞれ取得してみたいと思います。

データセットのメタデータの取得

下記の構文をクエリで実行すると

SELECT *  FROM プロジェクト名.INFORMATION_SCHEMA.SCHEMATA;

データセットに関する表に示したメタデータが返されます。

上記記述した構文をクエリで実際に実行してみると以下の結果が出力され、データセットに関するメータデータが返されたことが分かります。

テーブルのメタデータの取得

下記の構文をクエリで実行すると

SELECT * FROM データセット名.INFORMATION_SCHEMA.TABLES;

テーブルに関する表に示したメタデータが返されます。

| 列名 | データ型 | 値 | | ------------------ | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------------------ | --------- | -------------------------- | | table_catalog | STRING | データセットを含むプロジェクトのプロジェクト ID | | table_schema | STRING | テーブルやビューを含むデータセットの名前 | | table_name | STRING | テーブルまたはビューの名前 | | table_type | STRING | テーブルタイプ | | is_insertable_into | STRING | YES または NO( DML INSERT ステートメントに対応しているかどうか) | | is_typed | STRING | 常に NO | | creation_time | TIMESTAMP | テーブルの作成時間 | | DDL | STRING | テーブルの作成に使用できる CREATE SCHEMA DDL ステートメント | | LAST_MODIFIED_TIME | TIMESTAMP | データセットの最終更新日時 | | clone_time | TIMESTAMP | このテーブルを作成するためにベーステーブルがクローンされた時間 | | base_table_catalog | STRING | ベーステーブルのプロジェクト | | base_table_schema | STRING | ベーステーブルのデータセット | | base_table_name | STRING | ベーステーブルの名前 | | base_table_name | STRING | デフォルトの照合仕様の名前 |

上記記述した構文をクエリで実際に実行してみると以下の結果が出力され、テーブルに関するメータデータが返されたことを確認できました。

ビューのメタデータの取得

下記の構文をクエリで実行すると

SELECT * FROM データセット名.INFORMATION_SCHEMA.VIEWS;

ビューに関する表に示したメタデータが返されます。

今回は、INFORMATION_SCHEMA を使ってデータセット、テーブル、ビューの情報を取得しました。INFORMATION_SCHEMA を使うことで、このほかにも実行されたクエリやユーザーごとの料金なども調べることができますので、機会があればやってみたいと思います。

参考

• BigQuery INFORMATION_SCHEMA の概要
• INFORMATION_SCHEMA で BigQuery の利用状況を確認
• BigQuery の INFORMATION_SCHEMA を利用してクエリコストを集計する
• BigQuery で INFORMATION_SCHEMA から CREATE TABLE 文が取得できるようになりました！
• BigQuery の INFORMATION_SCHEMA からどんな情報が取得できるのか、全ての VIEW を確認してみた