列出資料集
本文說明如何在 BigQuery 中列出資料集並取得相關資訊。
事前準備
授予身分與存取權管理 (IAM) 角色,讓使用者擁有執行本文件各項工作所需的權限。
必要角色
如要取得列出資料集或取得資料集資訊所需的權限,請要求管理員在您的專案中授予您 BigQuery 中繼資料檢視者 (roles/bigquery.metadataViewer
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色包含 bigquery.datasets.get
權限,這是列出資料集或取得資料集資訊的必要權限。
在專案或機構層級套用 roles/bigquery.metadataViewer
角色時,您可以列出專案中的所有資料集。在資料集層級套用 roles/bigquery.metadataViewer
角色時,您可以列出您已獲授該角色的所有資料集。
列出資料集
選取下列選項之一:
主控台
在導覽選單中,按一下「Studio」。
在「Explorer」面板中展開專案名稱,即可查看該專案中的資料集,或使用搜尋方塊依資料集名稱搜尋。
SQL
查詢 INFORMATION_SCHEMA.SCHEMATA
檢視區塊:
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式:
SELECT schema_name FROM PROJECT_ID.`region-REGION`.INFORMATION_SCHEMA.SCHEMATA;
更改下列內容:
PROJECT_ID
:您的Google Cloud 專案 ID。如未指定,系統會使用預設專案。REGION
:任何資料集區域名稱。例如:us
。
按一下「執行」
。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」。
bq
發出 bq ls
指令,依資料集 ID 列出資料集。--format
標記可用來控管輸出。如果您要列出預設專案以外的專案資料集,請將 --project_id
標記新增至該指令。
如要列出專案中包括隱藏資料集在內的所有資料集,請使用 --all
標記或 -a
捷徑。
如要列出專案中除了隱藏資料集以外的所有資料集,請使用 --datasets
標記或 -d
捷徑。這個標記是選用的,隱藏資料集預設為不列出。
其他標記包括:
--filter
:列出符合篩選器運算式的資料集。以空格分隔的方式列出標籤鍵和值,格式為labels.key:value
。如要進一步瞭解如何使用標籤篩選資料集,請參閱新增及使用標籤相關說明。--max_results
或-n
:用來表示結果數量上限的整數。預設值為50
。
bq ls --filter labels.key:value \ --max_results integer \ --format=prettyjson \ --project_id project_id
更改下列內容:
- key:value:標籤鍵和值
- integer:代表要列出資料集數量的整數
- project_id:專案名稱
範例:
輸入下列指令,列出預設專案中的資料集。--
format
已設為「pretty」,藉此傳回基本格式的資料表。
bq ls --format=pretty
輸入下列指令,列出 myotherproject
中的資料集。--format
已設為 prettyjson
,藉此傳回 JSON 格式的詳細結果。
bq ls --format=prettyjson --project_id myotherproject
輸入下列指令,列出預設專案中的所有資料集 (包括隱藏資料集)。在輸出內容中,隱藏資料集的名稱會以底線開頭。
bq ls -a
輸入下列指令,從預設專案傳回超過 50 個 (預設值) 輸出資料集。
bq ls --max_results 60
輸入下列指令,列出預設專案中附有 org:dev
標籤的資料集。
bq ls --filter labels.org:dev
API
如要使用 API 列出資料集,請呼叫 datasets.list
API 方法。
C#
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 C# 設定說明進行操作。詳情請參閱 BigQuery C# API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Go
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Go 設定說明進行操作。詳情請參閱 BigQuery Go API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Java
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Java 設定說明進行操作。詳情請參閱 BigQuery Java API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Node.js
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Node.js 設定說明進行操作。詳情請參閱 BigQuery Node.js API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
PHP
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 PHP 設定說明進行操作。詳情請參閱 BigQuery PHP API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Python
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Python 設定說明進行操作。詳情請參閱 BigQuery Python API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Ruby
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Ruby 設定說明進行操作。詳情請參閱 BigQuery Ruby API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
取得資料集相關資訊
選取下列選項之一:
主控台
在「Explorer」面板中展開專案並選取資料集。
展開「動作」選項,然後按一下「開啟」。
說明和詳細資料會顯示在詳細資料面板中。在「Explorer」(探索) 面板中,資料集名稱下方會列出其資料表。
根據預設,隱藏資料集不會顯示在 Google Cloud 控制台中。如要顯示隱藏資料集的相關資訊,請使用 bq 指令列工具或 API。
SQL
查詢 INFORMATION_SCHEMA.SCHEMATA
檢視區塊:
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式:
SELECT * EXCEPT (schema_owner) FROM PROJECT_ID.`region-REGION`.INFORMATION_SCHEMA.SCHEMATA;
取代下列項目:
-
PROJECT_ID
:您的 Google Cloud 專案 ID。如未指定,系統會使用預設專案。 -
REGION
:任何資料集區域名稱。例如:us
。
-
按一下「執行」
。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」。
您也可以查詢 INFORMATION_SCHEMA.SCHEMATA_OPTIONS
檢視畫面。
SELECT * FROM PROJECT_ID.`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS;
bq
請發出 bq show
指令。--format
旗標可用來控制輸出內容。如要取得預設專案以外的資料集相關資訊,請使用下列格式將專案 ID 新增至資料集名稱:project_id:dataset
。
輸出內容會顯示資料集的資訊,例如存取權控管、標籤和位置。這項指令不會顯示資料集的繼承權限,但您可以在 Google Cloud 控制台中查看。
如要顯示隱藏資料集的相關資訊,請使用 bq ls --all
指令列出所有資料集,然後在 bq show
指令中使用隱藏資料集的名稱。
bq show --format=prettyjson project_id:dataset
更改下列內容:
- project_id 是您的專案名稱。
- dataset 是資料集名稱。
範例:
輸入下列指令,顯示預設專案中的 mydataset
相關資訊。
bq show --format=prettyjson mydataset
輸入下列指令,顯示 myotherproject
中的 mydataset
相關資訊。
bq show --format=prettyjson myotherproject:mydataset
輸入下列指令,顯示預設專案中隱藏資料集 _1234abcd56efgh78ijkl1234
的相關資訊。
bq show --format=prettyjson _1234abcd56efgh78ijkl1234
API
呼叫 datasets.get
API 方法,並提供所有相關參數。
Go
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Go 設定說明進行操作。詳情請參閱 BigQuery Go API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Java
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Java 設定說明進行操作。詳情請參閱 BigQuery Java API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Node.js
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Node.js 設定說明進行操作。詳情請參閱 BigQuery Node.js API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Python
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Python 設定說明進行操作。詳情請參閱 BigQuery Python API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
確認資料集名稱
下列範例說明如何檢查資料集是否存在:
Java
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Java 設定說明進行操作。詳情請參閱 BigQuery Java API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
Python
在試行這個範例之前,請先按照 BigQuery 快速入門導覽課程:使用用戶端程式庫中的 Python 設定說明進行操作。詳情請參閱 BigQuery Python API 參考說明文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
後續步驟
- 參閱建立資料集一文,進一步瞭解如何建立資料集。
- 如要進一步瞭解如何指派存取權控管權限給資料集,請參閱控管資料集存取權。
- 如要進一步瞭解如何變更資料集屬性,請參閱更新資料集屬性。
- 要進一步瞭解如何建立及管理標籤,請參閱建立及管理標籤相關頁面。
- 如要查看
INFORMATION_SCHEMA
的總覽,請前往 BigQueryINFORMATION_SCHEMA
簡介頁面。