ビューの一覧表示
このドキュメントでは、BigQuery でビューを一覧表示する方法について説明します。
データセット内のビューは、次の方法で一覧表示できます。
- Cloud Console の使用
bq
コマンドライン ツールでbq ls
コマンドを使用するtables.list
API メソッドを呼び出す- クライアント ライブラリの使用
始める前に
このドキュメントの各タスクを実行するために必要な権限をユーザーに与える Identity and Access Management(IAM)のロールを付与します。
必要な権限
データセット内のビューを一覧表示するには、bigquery.tables.list
IAM 権限が必要です。
次の IAM 事前定義ロールには、データセット内のビューを一覧表示するために必要な権限が含まれています。
roles/bigquery.user
roles/bigquery.metadataViewer
roles/bigquery.dataViewer
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/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 のリファレンス ドキュメントをご覧ください。
セキュリティの表示
BigQuery でビューへのアクセスを制御するには、ビューへのアクセスの制御をご覧ください。
次のステップ
- ビューの作成方法については、ビューの作成をご覧ください。
- 承認済みビューの作成方法については、承認済みビューの作成をご覧ください。
- ビューのメタデータを取得する方法については、ビューの情報の取得をご覧ください。
- ビューを更新する方法については、ビューの更新をご覧ください。
- ビューの管理の詳細については、ビューの管理をご覧ください。