刪除標籤
您可以透過以下方式從資料集、資料表或檢視表刪除標籤:
- 使用 Google Cloud 控制台
- 使用 SQL DDL 陳述式
- 使用 bq 指令列工具的
bq update
指令 - 呼叫
datasets.patch
或tables.patch
API 方法 - 使用用戶端程式庫
事前準備
授予身分與存取權管理 (IAM) 角色,讓使用者擁有執行本文件各項工作所需的權限。執行工作所需的權限 (如有) 會列在工作的「必要權限」部分。
刪除資料集標籤
下列各節將說明刪除資料集標籤的權限和步驟。
所需權限
如要刪除資料集標籤,您必須具備下列 IAM 權限:
bigquery.datasets.get
bigquery.datasets.update
下列預先定義的 IAM 角色都具備刪除資料集標籤所需的權限:
roles/bigquery.dataOwner
roles/bigquery.admin
此外,如果您具備 bigquery.datasets.create
權限,可以刪除您建立的資料集標籤。
如要進一步瞭解 BigQuery 中的 IAM 角色和權限,請參閱預先定義的角色與權限一文。
刪除資料集標籤
如要從資料集中刪除標籤,請選擇下列其中一個選項:
主控台
在 Google Cloud 控制台中選取資料集。
在「Dataset Details」(資料集詳細資料) 頁面中,按一下「Labels」(標籤) 右側的鉛筆圖示。
在「Edit labels」(編輯標籤) 對話方塊中:
- 針對要刪除的每個標籤,按一下刪除圖示 (X)。
- 如要儲存變更,請按一下「更新」。
SQL
使用 ALTER SCHEMA SET OPTIONS
DDL 陳述式,在現有資料集上設定標籤。設定標籤會覆寫資料集上的所有現有標籤。以下範例會刪除資料集 mydataset
的所有標籤:
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式:
ALTER SCHEMA mydataset SET OPTIONS (labels = []);
按一下「執行」
。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」。
bq
如要刪除資料集標籤,請發出 bq update
指令並搭配使用 clear_label
旗標。重複該標記即可刪除多個標籤。
如果資料集位於預設專案以外的專案中,請使用下列格式將專案 ID 新增至資料集:project_id:dataset
。
bq update \ --clear_label key \ project_id:dataset
其中:
- key 是您要刪除的標籤的鍵。
- project_id 是您的專案 ID。
- dataset 是您要更新的資料集。
範例:
如要從 mydataset
刪除 department:shipping
標籤,請輸入帶有 --clear_label
標記的 bq update
指令。mydataset
在您的預設專案中。
bq update --clear_label department mydataset
如要從 myotherproject
的 mydataset
刪除 department:shipping
標籤,請輸入帶有 --clear_label
標記的 bq update
指令。
bq update --clear_label department myotherproject:mydataset
如要從資料集刪除多個標籤,請重複執行 clear_label
標記並指定每個標籤的鍵。舉例來說,如要從預設專案中的 mydataset
刪除 department:shipping
標籤和 cost_center:logistics
標籤,請輸入:
bq update \
--clear_label department \
--clear_label cost_center \
mydataset
各範例的輸出內容如下:
Dataset 'myproject:mydataset' successfully updated.
API
如要刪除現有資料集的特定標籤,請呼叫 datasets.patch
方法,然後將標籤的鍵值設為 null
,藉此更新資料集資源的 labels
屬性。
如要從資料集中刪除所有標籤,請呼叫 datasets.patch
方法並刪除 labels
屬性。
由於 datasets.update
方法會取代整個資料集資源,因此建議使用 datasets.patch
方法。
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 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
刪除資料表或檢視表標籤
您可以透過下列方式刪除資料表或檢視表標籤:
- 使用 Google Cloud 控制台
- 使用 SQL DDL 陳述式
- 使用 bq 指令列工具的
bq update
指令 - 呼叫
tables.patch
API 方法- 由於系統會將檢視表當做資料表資源處理,因此可以使用
tables.patch
方法來修改檢視表和資料表。
- 由於系統會將檢視表當做資料表資源處理,因此可以使用
- 使用用戶端程式庫
所需權限
如要刪除資料表或檢視表標籤,您必須具備下列 IAM 權限:
bigquery.tables.get
bigquery.tables.update
下列每個預先定義的 IAM 角色都包含刪除表格或查看標籤所需的權限:
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.admin
此外,如果您具備 bigquery.datasets.create
權限,可以刪除所建立資料集中資料表和檢視區塊的標籤。
如要進一步瞭解 BigQuery 中的 IAM 角色和權限,請參閱預先定義的角色與權限一文。
刪除資料表或檢視表標籤
如要從資料表或檢視表中刪除標籤,請選擇下列其中一個選項:
主控台
在 Google Cloud 控制台中選取資料集。
按一下 [Details] (詳細資料) 分頁標籤,然後按一下「Labels」(標籤) 右側的鉛筆圖示。
在「Edit labels」(編輯標籤) 對話方塊中:
針對要刪除的每個標籤,按一下刪除圖示 (X)。
如要儲存變更,請按一下「更新」。
SQL
如要在現有資料表上設定標籤,請使用 ALTER TABLE SET OPTIONS
DDL 陳述式;如要在現有檢視區塊上設定標籤,請使用 ALTER VIEW SET OPTIONS
DDL 陳述式。設定標籤會覆寫資料表或檢視表上的所有現有標籤。以下範例會從 mytable
資料表刪除所有標籤:
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式:
ALTER TABLE mydataset.mytable SET OPTIONS (labels = []);
按一下「執行」
。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」。
bq
如要從資料表或檢視表中刪除標籤,請發出 bq update
指令並搭配使用 clear_label
標記。重複該標記即可刪除多個標籤。
如果資料表或檢視表位於預設專案以外的專案中,請使用下列格式將專案 ID 新增至資料集:project_id:dataset
。
bq update \ --clear_label key \ project_id:dataset.table_or_view
其中:
- key 是您要刪除的標籤的鍵。
- project_id 是您的專案 ID。
- dataset 是您要更新的資料集。
- table_or_view 是您要更新之資料表或視圖的名稱。
範例:
如要從 mydataset.mytable
刪除 department:shipping
標籤,請輸入帶有 --clear_label
標記的 bq update
指令。mydataset
在您的預設專案中。
bq update --clear_label department mydataset.mytable
如要從 myotherproject
的 mydataset.myview
刪除 department:shipping
標籤,請輸入帶有 --clear_label
標記的 bq update
指令。
bq update --clear_label department myotherproject:mydataset.myview
如要從資料表或檢視表刪除多個標籤,請重複執行 clear_label
標記並指定每個標籤的鍵。舉例來說,如要從預設專案中的 mydataset.mytable
刪除 department:shipping
標籤和 cost_center:logistics
標籤,請輸入:
bq update \
--clear_label department \
--clear_label cost_center \
mydataset.mytable
各範例的輸出內容如下:
Table 'myproject:mydataset.mytable' successfully updated.
API
如要刪除現有資料表或檢視表的特定標籤,請呼叫 tables.patch
方法,然後將標籤的鍵值設為 null
,藉此更新資料表資源的 labels
屬性。
如要從資料表或檢視表刪除所有標籤,請呼叫 tables.patch
方法並刪除 labels
屬性。
由於系統會將檢視表當做資料表資源處理,因此可以使用 tables.patch
方法來修改檢視表和資料表。此外,因為 tables.update
方法會取代整個資料集資源,因此建議使用 tables.patch
方法。
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 進行驗證,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
刪除預訂標籤
你可以刪除預訂標籤。
必要 IAM 角色
如要取得刪除預訂標籤所需的權限,請要求管理員授予您管理專案的 BigQuery 資源編輯者 (roles/bigquery.resourceEditor
) 身分與存取權管理角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色具備 bigquery.reservations.delete
權限,這是刪除預訂標籤的必要權限。
刪除預訂標籤
如要從預訂項目刪除標籤,請選擇下列其中一個選項:
SQL
如要刪除預訂標籤,請使用 ALTER RESERVATION SET OPTIONS
DDL 陳述式。
如要刪除預訂項目的標籤,請將標籤設為空陣列。以下範例會刪除預訂 myreservation
的標籤:
前往 Google Cloud 控制台的「BigQuery」頁面。
在查詢編輯器中輸入下列陳述式:
ALTER RESERVATION myreservation SET OPTIONS ( labels = []);
按一下「執行」
。
如要進一步瞭解如何執行查詢,請參閱「執行互動式查詢」。
bq
如要刪除預訂標籤,請發出 bq update
指令並搭配使用 clear_label
和 --reservation
標記。如要刪除多個標籤,請重複執行該標記。
bq update --clear_label KEY --reservation RESERVATION_NAME
更改下列內容:
KEY
:要從預訂項目刪除的標籤鍵。鍵不得重複。鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼,且可使用國際字元。如要刪除預訂項目的多個標籤,請重複使用--clear_label
旗標並為每個標籤指定專屬鍵。RESERVATION_NAME
:預訂名稱。
刪除工作標籤
目前尚不支援從現有工作中刪除標籤。
後續步驟
- 瞭解如何為 BigQuery 資源加上標籤。
- 瞭解如何在 BigQuery 資源中查看標籤。
- 瞭解如何在 BigQuery 資源中更新標籤。
- 瞭解如何使用標籤篩選資源。
- 請參閱 Resource Manager 說明文件中的使用標籤。