ビューに関する情報の取得

このドキュメントでは、BigQuery ビューの情報やメタデータを取得する方法について説明します。

ビューのメタデータは、次の方法で取得できます。

GCP Console または従来の BigQuery ウェブ UI
bq show CLI コマンド
tables.get API メソッドの呼び出し
INFORMATION_SCHEMA ビューへのクエリ（ベータ版）

必要な権限

ビューに関する情報を取得するユーザーには、データセットに対する READER 役割が割り当てられているか、bigquery.tables.get 権限を含むプロジェクトレベルの IAM 役割が割り当てられている必要があります。プロジェクトレベルで bigquery.tables.get 権限が付与されているユーザーは、そのプロジェクト内のすべてのビューに関する情報を取得できます。事前定義されているプロジェクトレベルの IAM 役割のうち、bigquery.jobUser と bigquery.user 以外の役割には、bigquery.tables.get 権限が含まれています。

また、bigquery.user 役割が割り当てられているユーザーには bigquery.datasets.create 権限もあります。そのため、bigquery.user 役割が割り当てられているユーザーは、自分が作成した任意のデータセット内のビューに関する情報を取得できます。bigquery.user 役割に割り当てられているユーザーがデータセットを作成すると、そのユーザーには、作成したデータセットへの OWNER アクセス権が付与されます。データセットへの OWNER アクセス権が付与されたユーザーは、そのデータセットと、そこに含まれるすべてのビューを完全に制御できます。

BigQuery での IAM 役割と権限の詳細については、アクセス制御をご覧ください。データセットレベルの役割の詳細については、データセットに対する基本の役割をご覧ください。

ビューの情報の取得

ビューに関する情報を取得するプロセスは、テーブルに関する情報を取得するプロセスと同じです。

ビューに関する情報を取得するには:

Console

データセットを展開します。
ビュー名をクリックします。
[詳細] をクリックします。[詳細] タブには、ビューの説明、ビューの情報、ビューを定義する SQL クエリが表示されます。

従来の UI

データセットを展開します。
ビュー名をクリックします。
[Details] をクリックします。[View Details] ページには、ビューの説明、ビューの情報、およびビューを定義する SQL クエリが表示されます。

コマンドライン

bq show コマンドを発行します。--format フラグを使用して出力を制御できます。デフォルトプロジェクト以外のプロジェクトにあるビューの情報を取得する場合は、[PROJECT_ID]:[DATASET] の形式でプロジェクト ID をデータセットに追加します。

bq show --format=prettyjson [PROJECT_ID]:[DATASET].[VIEW]

ここで

[PROJECT_ID] はプロジェクト ID です。
[DATASET] はデータセットの名前です。
[VIEW] はビューの名前です。

例:

デフォルトプロジェクトにある mydataset データセット内の myview に関する情報を表示するには、次のコマンドを入力します。

bq show --format=prettyjson mydataset.myview

myotherproject にある mydataset データセット内の myview に関する情報を表示するには、次のコマンドを入力します。

bq show --format=prettyjson myotherproject:mydataset.myview

API

tables.get メソッドを呼び出して、関連するパラメータを指定します。

Go

このサンプルを試す前に、BigQuery クイックスタート: クライアントライブラリの使用の Go の設定手順を実施してください。詳細については、BigQuery Go API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

// To run this sample, you will need to create (or reuse) a context and
// an instance of the bigquery client.  For example:
// import "cloud.google.com/go/bigquery"
// ctx := context.Background()
// client, err := bigquery.NewClient(ctx, "your-project-id")
view := client.Dataset(datasetID).Table(viewID)
meta, err := view.Metadata(ctx)
if err != nil {
	return err
}
fmt.Printf("View %s, query: %s\n", view.FullyQualifiedName(), meta.ViewQuery)

Python

このサンプルを試す前に、BigQuery クイックスタート: クライアントライブラリの使用にある Python 向けの手順に従って設定を行ってください。詳細については、BigQuery Python API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

# from google.cloud import bigquery
# client = bigquery.Client()
# shared_dataset_id = 'my_shared_dataset'

view_ref = client.dataset(shared_dataset_id).table("my_shared_view")
view = client.get_table(view_ref)  # API Request

# Display view properties
print("View at {}".format(view.full_table_id))
print("View Query:\n{}".format(view.view_query))

`INFORMATION_SCHEMA`（ベータ版）

INFORMATION_SCHEMA は、データセット、テーブル、ビューに関するメタデータへのアクセスを提供する一連のビューです。

`VIEWS` ビュー

INFORMATION_SCHEMA.VIEWS ビューにクエリを実行すると、データセット内の各ビューが 1 行で返されます。

INFORMATION_SCHEMA.VIEWS ビューにクエリを実行する場合は、データセット修飾子を使用する必要があります。クエリを送信するユーザーには、ビューを含むデータセットへのアクセス権が必要です。

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

列名	データ型	値
`TABLE_CATALOG`	`STRING`	データセットを含むプロジェクトの名前
`TABLE_SCHEMA`	`STRING`	ビューを含むデータセットの名前（データセット `id` と呼ぶこともある）
`TABLE_NAME`	`STRING`	ビューの名前（テーブル `id` と呼ぶこともある）
`VIEW_DEFINITION`	`STRING`	ビューを定義する SQL クエリ
`CHECK_OPTION`	`STRING`	常に `NULL` が返されます。
`USE_STANDARD_SQL`	`STRING`	標準 SQL クエリでビューが作成された場合は `YES`。`useLegacySql` が `true` に設定されている場合は `NO`。

テーブルとビューのプロパティの詳細については、REST API ドキュメントのテーブルリソースのページをご覧ください。

例

例 1:

次の例では、将来用に予約されている check_option を除き、すべての列を INFORMATION_SCHEMA.VIEWS ビューから取得します。デフォルトプロジェクト（myproject）にある mydataset のすべてのビューに対するメタデータが返されます。

デフォルトプロジェクト以外のプロジェクトに対してクエリを実行する場合は、次の形式でプロジェクト ID をデータセットに追加します。 `[PROJECT_ID]`.[DATASET].INFORMATION_SCHEMA.[VIEW] （例: `myproject`.mydataset.INFORMATION_SCHEMA.VIEWS）

クエリを実行するには:

Console

GCP Console で BigQuery ウェブ UI を開きます。

BigQuery ウェブ UI に移動
[クエリエディタ] ボックスに、次の標準 SQL クエリを入力します。 INFORMATION_SCHEMA では標準 SQL 構文が必要です。標準 SQL は GCP Console のデフォルトの構文です。
```
SELECT
 * EXCEPT(check_option)
FROM
 mydataset.INFORMATION_SCHEMA.VIEWS
```
注: INFORMATION_SCHEMA ビュー名では大文字と小文字が区別されます。
[実行] をクリックします。

コマンドライン

query コマンドラインで、--nouse_legacy_sql または --use_legacy_sql=false フラグを使用して標準 SQL 構文を指定します。INFORMATION_SCHEMA クエリには標準 SQL 構文が必要です。

クエリを実行するには、次のように入力します。

bq query --nouse_legacy_sql \
'SELECT * EXCEPT(check_option) FROM mydataset.INFORMATION_SCHEMA.VIEWS'

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

  +----------------+---------------+---------------+---------------------------------------------------------------------+------------------+
  | table_catalog  | table_schema  |  table_name   |                        view_definition                              | use_standard_sql |
  +----------------+---------------+---------------+---------------------------------------------------------------------+------------------+
  | myproject      | mydataset     | myview        | SELECT column1, column2 FROM [myproject:mydataset.mytable] LIMIT 10 | NO               |
  +----------------+---------------+---------------+---------------------------------------------------------------------+------------------+

結果から、このビューはレガシー SQL クエリを使用して作成されたことがわかります。

例 2:

次の例では、デフォルトプロジェクト（myproject）の mydataset に myview を定義するときに使用する SQL クエリとクエリ構文を取得します。

クエリを実行するには:

Console

GCP Console で BigQuery ウェブ UI を開きます。

BigQuery ウェブ UI に移動
[クエリエディタ] ボックスに、次の標準 SQL クエリを入力します。 INFORMATION_SCHEMA では標準 SQL 構文が必要です。標準 SQL は GCP Console のデフォルトの構文です。
```
SELECT
 table_name, view_definition, use_standard_sql
FROM
 mydataset.INFORMATION_SCHEMA.VIEWS
WHERE
 table_name="myview"
```
注: INFORMATION_SCHEMA ビュー名では大文字と小文字が区別されます。
[実行] をクリックします。

コマンドライン

クエリを実行するには、次のように入力します。

bq query --nouse_legacy_sql \
'SELECT table_name, view_definition, use_standard_sql FROM mydataset.INFORMATION_SCHEMA.VIEWS WHERE table_name="myview"'

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

  +---------------+---------------------------------------------------------------+------------------+
  |  table_name   |                        view_definition                        | use_standard_sql |
  +---------------+---------------------------------------------------------------+------------------+
  | myview        | SELECT column1, column2, column3 FROM mydataset.mytable       | YES              |
  +---------------+---------------------------------------------------------------+------------------+

結果から、このビューは標準の SQL クエリで作成されたことがわかります。

次のステップ

ビューの作成方法については、ビューの作成をご覧ください。
承認済みビューの作成方法については、承認済みビューの作成をご覧ください。
ビューの一覧表示の詳細については、ビューの一覧表示をご覧ください。
ビューの更新の詳細については、ビューの更新をご覧ください。
ビューの管理の詳細については、ビューの管理をご覧ください。
INFORMATION_SCHEMA の概要については、BigQuery INFORMATION_SCHEMA の概要をご覧ください。

このページは役立ちましたか？評価をお願いいたします。

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

最終更新日: 7月 10, 2019

ビューに関する情報の取得

必要な権限

ビューの情報の取得

Console

従来の UI

コマンドライン

API

Go

Python

INFORMATION_SCHEMA（ベータ版）

VIEWS ビュー

例

例 1:

Console

コマンドライン

例 2:

Console

コマンドライン

次のステップ

フィードバックを送信...

`INFORMATION_SCHEMA`（ベータ版）

`VIEWS` ビュー