このドキュメントでは、BigQuery でビューを一覧表示する方法について説明します。
データセット内のビューは、次の方法で一覧表示できます。
- Cloud Console を使用する
bq
コマンドライン ツールでbq ls
コマンドを使用するtables.list
API メソッドを呼び出す- クライアント ライブラリを使用する
必要な権限
データセットに含まれるビューを一覧表示するには、少なくとも bigquery.tables.list
権限が付与されている必要があります。次の IAM 事前定義ロールには bigquery.tables.list
権限が含まれています。
bigquery.user
bigquery.metadataViewer
bigquery.dataViewer
bigquery.dataOwner
bigquery.dataEditor
bigquery.admin
BigQuery での IAM のロールと権限については、事前定義ロールと権限をご覧ください。
ビューの一覧表示
ビューを一覧表示するプロセスは、テーブルを一覧表示するプロセスと同じです。
データセット内のビューを一覧表示するには、次の手順に従います。
Console
[エクスプローラ] パネルでプロジェクトを展開し、データセットを選択します。
リストをスクロールして、データセット内のテーブルを表示します。テーブルとビューはアイコンで区別できます。
bq
bq ls
コマンドを発行します。--format
フラグを使用して出力を制御できます。デフォルト プロジェクト以外のプロジェクトにあるビューを一覧表示する場合は、project_id:dataset
の形式でプロジェクト ID をデータセットに追加します。
bq ls --format=pretty project_id:dataset
ここで
- project_id は、プロジェクト ID です。
- dataset は、データセットの名前です。
このコマンドを実行すると、Type
フィールドに TABLE
または VIEW
が表示されます。例:
+-------------------------+-------+----------------------+-------------------+ | tableId | Type | Labels | Time Partitioning | +-------------------------+-------+----------------------+-------------------+ | mytable | TABLE | department:shipping | | | myview | VIEW | | | +-------------------------+-------+----------------------+-------------------+
例:
次のコマンドを入力すると、デフォルト プロジェクトにある mydataset
データセット内のビューが一覧表示されます。
bq ls --format=pretty mydataset
次のコマンドを入力すると、myotherproject
にある mydataset
データセット内のビューが一覧表示されます。
bq ls --format=pretty myotherproject:mydataset
API
API を使用してビューを一覧表示するには、tables.list
メソッドを呼び出します。
Go
このサンプルを試す前に、BigQuery クイックスタート: クライアント ライブラリの使用の Go の手順に従って設定を行ってください。詳細については、BigQuery Go API のリファレンス ドキュメントをご覧ください。
Python
このサンプルを試す前に、BigQuery クイックスタート: クライアント ライブラリの使用の Python の手順に従って設定を行ってください。詳細については、BigQuery Python API のリファレンス ドキュメントをご覧ください。
次のステップ
- ビューの作成方法については、ビューの作成をご覧ください。
- 承認済みビューの作成方法については、承認済みビューの作成をご覧ください。
- ビューのメタデータを取得する方法については、ビューの情報の取得をご覧ください。
- ビューを更新する方法については、ビューの更新をご覧ください。
- ビューの管理の詳細については、ビューの管理をご覧ください。