查看標籤
本頁面說明如何查看在 BigQuery 資源上的標籤。
您可以透過下列方式查看標籤:
- 使用 Google Cloud 控制台
- 查詢
INFORMATION_SCHEMA個檢視表 - 使用 bq 指令列工具的
bq show指令 - 呼叫
datasets.get或tables.getAPI 方法 - 使用用戶端程式庫
由於系統會將檢視表當做資料表資源處理,因此可以使用 tables.get 方法來取得檢視表和資料表的標籤資訊。
事前準備
授予 Identity and Access Management (IAM) 角色,讓使用者具備必要權限,可執行本文件中的各項工作。
所需權限
查看標籤所需的權限,取決於您可存取的資源類型。如要執行本文件中的工作,您必須具備下列權限。
查看資料集詳細資料的權限
如要查看資料集詳細資料,您必須具備 bigquery.datasets.get IAM 權限。
下列各項預先定義的 IAM 角色,都具備查看資料集詳細資料所需的權限:
roles/bigquery.userroles/bigquery.metadataViewerroles/bigquery.dataViewerroles/bigquery.dataOwnerroles/bigquery.dataEditorroles/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 角色和權限,請參閱「預先定義的角色和權限」。
查看資料集、資料表和檢視表標籤
如要查看資源的標籤,請選取下列其中一個選項:
控制台
在 Google Cloud 控制台中,選取資料集、資料表或檢視表。
按一下「Details」(詳細資料) 分頁標籤。標籤資訊會顯示在「Labels」(標籤) 列中。
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 方法。回應包含與這項資源相關聯的所有標籤。
查看預留項目標籤
如要查看預留項目的標籤,請選取下列其中一個選項:
控制台
前往 Google Cloud 控制台的「BigQuery」頁面。
在導覽選單中,按一下「Workload management」(工作負載管理)。
點選「Slot reservations」(運算單元預留項目) 分頁標籤。
每個預訂的標籤都會列在「標籤」欄中。
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"
}