列出資料檢視

本文件說明如何在 BigQuery 中列出資料檢視。

您可以透過以下方式列出資料集中的資料檢視:

  • 使用 GCP 主控台或傳統 BigQuery 網頁版 UI
  • 使用 bq ls CLI 指令
  • 呼叫 tables.list API 方法

所需權限

如要列出資料集裡的資料檢視,您必須取得資料集的 READER 角色,或者取得具備 bigquery.tables.list 權限的專案層級身分與存取權管理 (IAM) 角色。取得專案層級的 bigquery.tables.list 權限後,您就可以列出專案中所有資料集的資料檢視。所有預先定義的 BigQuery IAM 角色都具備 bigquery.tables.list 權限,但 bigquery.jobUser 除外

如要深入瞭解 BigQuery 中的 IAM 角色和權限,請參閱存取權控制。如要深入瞭解資料集層級角色,請參閱資料集的原始角色

列出資料檢視

列出資料檢視的方法和列出資料表相同。

如要列出資料集裡的資料檢視:

主控台

  1. 在導覽面板的「Resources」(資源) 區段中,展開您的專案並按一下資料集,畫面上即會顯示資料集裡的資料表和資料檢視。

  2. 捲動清單,直到看到資料裡的資料表為止。資料表和資料檢視會分別以不同的圖示呈現。

    資料表和資料檢視圖示

傳統版 UI

  1. 在 BigQuery 網頁版 UI 的導覽窗格中,按一下資料集左側的藍色箭號展開選單,或在資料集名稱上按兩下。畫面上會顯示資料集中的資料表和資料檢視。

  2. 捲動清單,直到看到資料集中的資料表為止。資料表和資料檢視會分別以不同的圖示呈現。

    查看資料表

指令列

發出 bq ls 指令。--format 標記可用來控管輸出內容。如果您要列出的資料檢視位於預設專案以外的專案中,請使用下列格式將專案 ID 新增至資料集:[PROJECT_ID]:[DATASET]

bq ls --format=pretty [PROJECT_ID]:[DATASET]

其中:

  • [PROJECT_ID] 是您的專案 ID。
  • [DATASET] 是資料集名稱。

執行指令時,Type 欄位會顯示 TABLEVIEW。例如:

+-------------------------+-------+----------------------+-------------------+
|         tableId         | Type  |        Labels        | Time Partitioning |
+-------------------------+-------+----------------------+-------------------+
| mytable                 | TABLE | department:shipping  |                   |
| myview                  | VIEW  |                      |                   |
+-------------------------+-------+----------------------+-------------------+

範例:

輸入下列指令,即可列出預設專案中 mydataset 資料集的的資料檢視。

bq ls --format=pretty mydataset

輸入下列指令,即可列出 myotherprojectmydataset 資料集的資料檢視。

bq ls --format=pretty myotherproject:mydataset

API

如要使用 API 列出資料檢視,請呼叫 tables.list 方法。

Go

在試行此示例之前,請至 BigQuery 快速入門導覽課程:使用用戶端程式庫,按照 Go 設定說明進行操作。詳情請參閱 BigQuery Go API 參考說明文件

// 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")
ts := client.Dataset(datasetID).Tables(ctx)
for {
	t, err := ts.Next()
	if err == iterator.Done {
		break
	}
	if err != nil {
		return err
	}
	fmt.Fprintf(w, "Table: %q\n", t.TableID)
}

Python

在試行此示例之前,請至 BigQuery 快速入門導覽課程:使用用戶端程式庫,按照 Python 設定說明進行操作。詳情請參閱 BigQuery Python API 參考說明文件

from google.cloud import bigquery

# TODO(developer): Construct a BigQuery client object.
# client = bigquery.Client()

# TODO(developer): Set dataset_id to the ID of the dataset that contains
#                  the tables you are listing.
# dataset_id = 'your-project.your_dataset'

tables = client.list_tables(dataset_id)

print("Tables contained in '{}':".format(dataset_id))
for table in tables:
    print("{}.{}.{}".format(table.project, table.dataset_id, table.table_id))

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁