查看標籤
本頁面說明如何查看在 BigQuery 資源上的標籤。
您可以透過下列方式查看標籤:
- 使用 Google Cloud 控制台
- 查詢
INFORMATION_SCHEMA
檢視畫面 - 使用 bq 指令列工具的
bq show
指令 - 呼叫
datasets.get
或tables.get
API 方法 - 使用用戶端程式庫
由於系統會將檢視表當做資料表資源處理,因此可以使用 tables.get
方法來取得檢視表和資料表的標籤資訊。
事前準備
授予身分與存取權管理 (IAM) 角色,讓使用者取得執行本文各項工作所需的權限。
所需權限
查看標籤所需的權限取決於可存取的資源類型。如要執行本文中的工作,您需要下列權限。
查看資料集詳細資料的權限
如要查看資料集詳細資料,您需要 bigquery.datasets.get
IAM 權限。
下列預先定義的 IAM 角色都包含查看資料集詳細資料所需的權限:
roles/bigquery.user
roles/bigquery.metadataViewer
roles/bigquery.dataViewer
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
此外,如果您具備 bigquery.datasets.create
權限,可以查看您建立的資料集詳細資料。
如要進一步瞭解 BigQuery 中的 IAM 角色和權限,請參閱預先定義的角色與權限一文。
查看資料表或檢視表詳細資料的權限
如要查看資料表或檢視表詳細資料,您需要 bigquery.tables.get
IAM 權限。
所有預先定義的 IAM 角色都具備查看表格或詳細資料所需的權限,但 roles/bigquery.user
和 roles/bigquery.jobUser
除外。
此外,如果您具備 bigquery.datasets.create
權限,可以查看所建立資料集中的資料表和檢視表詳細資料。
如要進一步瞭解 BigQuery 中的 IAM 角色和權限,請參閱預先定義的角色與權限一文。
查看工作詳細資料的權限
如要查看工作詳細資料,您需要 bigquery.jobs.get
IAM 權限。
下列每個預先定義的 IAM 角色都包含查看工作詳細資料所需的權限:
roles/bigquery.admin
(可查看專案中所有工作的詳細資料)roles/bigquery.user
(可查看工作詳細資料)roles/bigquery.jobUser
(可查看工作詳細資料)
如要進一步瞭解 BigQuery 中的 IAM 角色和權限,請參閱預先定義的角色與權限一文。
查看資料集、資料表和檢視表標籤
如要查看資源的標籤,請選取下列其中一個選項:
主控台
如果是資料集,「Dataset Details」(資料集詳細資料) 頁面會自動開啟;如果是資料表和檢視表,請按一下 [Details] (詳細資料) 以開啟詳細資料頁面。標籤資訊會顯示在資源的資訊資料表中。
SQL
查詢INFORMATION_SCHEMA.SCHEMATA_OPTIONS
檢視區塊,即可查看資料集標籤;查詢INFORMATION_SCHEMA.TABLE_OPTIONS
檢視區塊,即可查看資料表標籤。舉例來說,下列 SQL 查詢會傳回名為 mydataset
的資料集標籤:
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式:
SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_OPTIONS WHERE schema_name = 'mydataset' AND option_name = 'labels';
按一下「執行」
。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」。
bq
使用 bq show
指令並加入資源 ID。--format
旗標可用來控制輸出格式。如果資源位於預設專案以外的專案中,請使用下列格式加入專案 ID:[PROJECT_ID]:[DATASET]
。為了便於閱讀,可以透過將 --format
旗標設為 pretty
來控制輸出格式。
bq show --format=pretty [RESOURCE_ID]
其中 [RESOURCE_ID]
是有效的資料集、資料表、檢視表或工作 ID。
範例:
輸入下列指令來顯示預設專案中 mydataset
的標籤。
bq show --format=pretty mydataset
輸出內容如下:
+-----------------+--------------------------------------------------------+---------------------+ | Last modified | ACLs | Labels | +-----------------+--------------------------------------------------------+---------------------+ | 11 Jul 19:34:34 | Owners: | department:shipping | | | projectOwners, | | | | Writers: | | | | projectWriters | | | | Readers: | | | | projectReaders | | +-----------------+--------------------------------------------------------+---------------------+
輸入下列指令來顯示 mydataset.mytable
的標籤。mydataset
在 myotherproject
中,而不是您的預設專案中。
bq show --format=pretty myotherproject:mydataset.mytable
叢集資料表的輸出內容如下:
+-----------------+------------------------------+------------+-------------+-----------------+------------------------------------------------+------------------+---------+ | Last modified | Schema | Total Rows | Total Bytes | Expiration | Time Partitioning | Clustered Fields | Labels | +-----------------+------------------------------+------------+-------------+-----------------+------------------------------------------------+------------------+---------+ | 25 Jun 19:28:14 | |- timestamp: timestamp | 0 | 0 | 25 Jul 19:28:14 | DAY (field: timestamp, expirationMs: 86400000) | customer_id | org:dev | | | |- customer_id: string | | | | | | | | | |- transaction_amount: float | | | | | | | +-----------------+------------------------------+------------+-------------+-----------------+------------------------------------------------+------------------+---------+
API
呼叫 datasets.get
方法或 tables.get
方法。回應包含與這項資源相關聯的所有標籤。
或者,您也可以使用 datasets.list
來查看多個資料集的標籤,或使用 tables.list
來查看多個資料表和檢視表的標籤。
由於系統會將檢視表當做資料表資源處理,因此可以使用 tables.get
和 tables.list
方法來查看檢視表和資料表的標籤資訊。
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 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
查看資料表標籤
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 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
查看工作標籤
如要查看工作上的標籤,請選取下列其中一個選項:
SQL
查詢INFORMATION_SCHEMA.JOB_BY_*
檢視畫面,即可查看工作上的標籤。舉例來說,下列 SQL 查詢會傳回目前專案中,目前使用者提交的工作的查詢文字和標籤:
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式:
SELECT query, labels FROM INFORMATION_SCHEMA.JOBS_BY_USER;
按一下「執行」
。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」。
bq
如要使用 bq 指令列工具查看查詢工作的標籤,請輸入 bq show -j
指令並加入查詢工作的工作 ID。--format
旗標可用來控制輸出格式。例如,如果查詢工作的工作 ID 為 bqjob_r1234d57f78901_000023746d4q12_1
,請輸入下列指令:
bq show -j --format=pretty bqjob_r1234d57f78901_000023746d4q12_1
輸出內容應如下所示:
+----------+---------+-----------------+----------+-------------------+-----------------+--------------+----------------------+ | Job Type | State | Start Time | Duration | User Email | Bytes Processed | Bytes Billed | Labels | +----------+---------+-----------------+----------+-------------------+-----------------+--------------+----------------------+ | query | SUCCESS | 03 Dec 15:00:41 | 0:00:00 | email@example.com | 255 | 10485760 | department:shipping | | | | | | | | | costcenter:logistics | +----------+---------+-----------------+----------+-------------------+-----------------+--------------+----------------------+
API
呼叫 jobs.get
方法。回應包含與這項資源相關聯的所有標籤。
查看預訂標籤
如要查看預訂的標籤,請選取下列任一選項:
SQL
查詢INFORMATION_SCHEMA.RESERVATIONS
檢視畫面,即可查看預訂項目的標籤。舉例來說,下列 SQL 查詢會傳回預訂名稱和標籤:
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式:
SELECT reservation_name, labels FROM INFORMATION_SCHEMA.RESERVATIONS WHERE reservation_name = RESERVATION_NAME;
取代下列項目:
RESERVATION_NAME
:預訂名稱。
按一下「執行」
。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」。
bq
使用 bq show
指令查看預訂標籤。
bq show --format=prettyjson --reservation=true --location=LOCATION RESERVATION_NAME
更改下列內容:
LOCATION
:預訂地點。RESERVATION_NAME
:預訂名稱。
輸出看起來類似以下內容:
{ "autoscale": { "maxSlots": "100" }, "creationTime": "2023-10-26T15:16:28.196940Z", "edition": "ENTERPRISE", "labels": { "department": "shipping" }, "name": "projects/myproject/locations/US/reservations/myreservation", "updateTime": "2025-06-05T19:37:28.125914Z" }
後續步驟
- 瞭解如何為 BigQuery 資源加上標籤。
- 瞭解如何在 BigQuery 資源中更新標籤。
- 瞭解如何使用標籤篩選資源。
- 瞭解如何在 BigQuery 資源中刪除標籤。
- 請參閱 Resource Manager 說明文件中的使用標籤。