列出資料集
本文件說明如何在 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
。
按一下
「Run」。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」一文。
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
。
-
按一下
「Run」。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」一文。
您也可以查詢 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
簡介頁面。