將標籤新增至資源

本頁面說明如何為 BigQuery 資源加上標籤。

事前準備

授予身分與存取權管理 (IAM) 角色，讓使用者擁有執行本文中各項工作所需的權限。執行工作所需的任何權限，都會列在工作「必要 IAM 角色」部分。

為資料集新增標籤

如果是透過 bq 指令列工具的 bq mk 指令或呼叫 datasets.insert API 方法建立 BigQuery 資料集，可以加入標籤。如果資料集是透過 Google Cloud 主控台建立，則無法加入標籤。

本頁面說明如何在建立資料集後加入標籤。如要深入瞭解如何在建立資料集時加入標籤，請參閱建立資料集。

您在資料集中加入標籤時，該資料集內的資源並不會套用這個標籤。資料表或檢視表不會沿用資料集標籤。此外，在資料集中加入標籤後，標籤就會納入儲存空間的帳單資料，不過工作相關的帳單資料並不會顯示資料集標籤。

如要進一步瞭解標籤格式，請參閱標籤相關規定。

必要的 IAM 角色

如要取得為現有資料集新增標籤的權限，請要求管理員授予您 BigQuery 資料擁有者 (roles/bigquery.dataOwner) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 bigquery.datasets.update 權限，這是為現有資料集新增標籤的必要權限。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

如要進一步瞭解 BigQuery 中的 IAM 角色和權限，請參閱預先定義的角色與權限一文。

為資料集加上標籤

如何在建立資料集後加入標籤：

控制台

1. 在 Google Cloud 控制台中選取資料集。

2. 在「Dataset Details」(資料集詳細資料) 頁面中，按一下「Labels」(標籤) 右側的鉛筆圖示。

   

3. 在「Edit labels」(編輯標籤) 對話方塊中：

   • 按一下 [Add label] (新增標籤)。
   • 輸入鍵和值。如要套用其他標籤，請按一下 [Add Label] (新增標籤)。每個資料集中的每個鍵都只能使用一次，但您可以在同一項專案的不同資料集中使用同一個鍵。
   • 如要更新標籤，請修改現有的鍵或值。
   • 如要儲存變更，請按一下「更新」。

SQL

使用 ALTER SCHEMA SET OPTIONS DDL 陳述式，在現有資料集上設定標籤。設定標籤會覆寫資料集上的所有現有標籤。以下範例會在資料集 mydataset 上設定標籤：

1. 前往 Google Cloud 控制台的「BigQuery」頁面。

   前往「BigQuery」

2. 在查詢編輯器中輸入下列陳述式：

   ALTER SCHEMA mydataset
   SET OPTIONS (
     labels = [('sensitivity', 'high')]);

3. 按一下「執行」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。

bq

如要在現有資料集中加入標籤，請發出 bq update 指令並搭配使用 set_label 旗標。重複使用該標記即可加入多個標籤。

如果資料集位於預設專案以外的專案中，請使用下列格式將專案 ID 新增至資料集：PROJECT_ID:DATASET。

bq update --set_label KEY:VALUE PROJECT_ID:DATASET

更改下列內容：

• KEY:VALUE：您要新增的標籤的鍵/值組合。鍵不得重複。鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼，且可使用國際字元。
• PROJECT_ID：您的專案 ID。
• DATASET：您要加入標籤的資料集。

範例：

如要加入標籤以追蹤部門，請輸入 bq update 指令並指定 department 做為標籤鍵。例如，如要在預設專案中為 mydataset 加入 department:shipping 標籤，請輸入：

    bq update --set_label department:shipping mydataset

如要在資料集中加入多個標籤，請重複使用 set_label 旗標並為每個標籤指定專屬鍵。例如，將 department:shipping 標籤和 cost_center:logistics 標籤加入預設專案中的 mydataset，請輸入：

    bq update \
    --set_label department:shipping \
    --set_label cost_center:logistics \
    mydataset

API

如要在現有資料集中加入標籤，請呼叫 datasets.patch 方法，然後填入資料集資源的 labels 屬性。

由於 datasets.update 方法會取代整個資料集資源，因此建議使用 datasets.patch 方法。

Go

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Go 設定操作說明進行操作。詳情請參閱 BigQuery Go API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// addDatasetLabel demonstrates adding label metadata to an existing dataset.
func addDatasetLabel(projectID, datasetID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %v", err)
	}
	defer client.Close()

	ds := client.Dataset(datasetID)
	meta, err := ds.Metadata(ctx)
	if err != nil {
		return err
	}

	update := bigquery.DatasetMetadataToUpdate{}
	update.SetLabel("color", "green")
	if _, err := ds.Update(ctx, update, meta.ETag); err != nil {
		return err
	}
	return nil
}

Java

這個範例使用 Java 專用 Google HTTP 用戶端程式庫，將要求傳送至 BigQuery API。

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Java 設定操作說明進行操作。詳情請參閱 BigQuery Java API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Dataset;
import java.util.HashMap;
import java.util.Map;

// Sample to updates a label on dataset
public class LabelDataset {

  public static void main(String[] args) {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    labelDataset(datasetName);
  }

  public static void labelDataset(String datasetName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      // This example dataset starts with existing label { color: 'green' }
      Dataset dataset = bigquery.getDataset(datasetName);
      // Add label to dataset
      Map<String, String> labels = new HashMap<>();
      labels.put("color", "green");

      dataset.toBuilder().setLabels(labels).build().update();
      System.out.println("Label added successfully");
    } catch (BigQueryException e) {
      System.out.println("Label was not added. \n" + e.toString());
    }
  }
}

Node.js

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Node.js 設定操作說明進行操作。詳情請參閱 BigQuery Node.js API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function labelDataset() {
  // Updates a label on a dataset.

  /**
   * TODO(developer): Uncomment the following lines before running the sample
   */
  // const datasetId = "my_dataset";

  // Retrieve current dataset metadata.
  const dataset = bigquery.dataset(datasetId);
  const [metadata] = await dataset.getMetadata();

  // Add label to dataset metadata
  metadata.labels = {color: 'green'};
  const [apiResponse] = await dataset.setMetadata(metadata);

  console.log(`${datasetId} labels:`);
  console.log(apiResponse.labels);
}

Python

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Python 設定操作說明進行操作。詳情請參閱 BigQuery Python API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

from google.cloud import bigquery

# Construct a BigQuery client object.
client = bigquery.Client()

# TODO(developer): Set dataset_id to the ID of the dataset to fetch.
# dataset_id = "your-project.your_dataset"

dataset = client.get_dataset(dataset_id)  # Make an API request.
dataset.labels = {"color": "green"}
dataset = client.update_dataset(dataset, ["labels"])  # Make an API request.

print("Labels added to {}".format(dataset_id))

為資料表和檢視表新增標籤

本頁面說明如何在現有資料表或視圖中加入標籤。如要進一步瞭解如何在建立資料表或檢視表時加入標籤，請參閱建立資料表或建立檢視表。

由於系統會將檢視表當做資料表資源處理，因此可以使用 tables.patch 方法來修改檢視表和資料表。

附註：資料表和檢視表標籤不會納入帳單資料。

必要的 IAM 角色

如要取得為現有資料表或檢視區塊新增標籤所需的權限，請要求管理員授予您 BigQuery 資料編輯者 (roles/bigquery.dataEditor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備在現有資料表或檢視區塊中加入標籤所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要在現有資料表或檢視表中加入標籤，您必須具備下列權限：

• bigquery.tables.update
• bigquery.tables.get

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

如要進一步瞭解 BigQuery 中的 IAM 角色和權限，請參閱預先定義的角色與權限一文。

在資料表或檢視表中加入標籤

如何在現有資料表或視圖中加入標籤：

控制台

1. 在 Google Cloud 控制台中選取資料表或檢視表。

2. 按一下 [Details] (詳細資料) 分頁標籤。

   

3. 按一下「Labels」(標籤) 右側的鉛筆圖示。

   

4. 在「Edit labels」(編輯標籤) 對話方塊中：

   • 按一下 [Add label] (新增標籤)。
   • 輸入鍵/值以加入標籤。如要套用其他標籤，請按一下 [Add Label] (新增標籤)。每個資料集中的每個鍵都只能使用一次，但您可以在同一項專案的不同資料集中使用同一個鍵。
   • 修改現有的鍵/值以更新標籤。
   • 按一下 [Update] (更新)，儲存您所做的變更。

SQL

使用 ALTER TABLE SET OPTIONS DDL 陳述式在現有資料表上設定標籤，或使用 ALTER VIEW SET OPTIONS DDL 陳述式在現有檢視區塊上設定標籤。設定標籤會覆寫資料表或檢視表上的所有現有標籤。以下範例會在 mytable 資料表上設定兩個標籤：

1. 前往 Google Cloud 控制台的「BigQuery」頁面。

   前往「BigQuery」

2. 在查詢編輯器中輸入下列陳述式：

   ALTER TABLE mydataset.mytable
   SET OPTIONS (
     labels = [('department', 'shipping'), ('cost_center', 'logistics')]);

3. 按一下「執行」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。

bq

如要在現有資料表或檢視表中加入標籤，請發出 bq update 指令並搭配使用 set_label 旗標。如要新增多個標籤，請重複使用該標記。

如果資料表或檢視表位於預設專案以外的專案中，請使用下列格式將專案 ID 新增至資料集：project_id:dataset。

bq update \
--set_label KEY:VALUE \
PROJECT_ID:DATASET.TABLE_OR_VIEW

更改下列內容：

• KEY:VALUE：您要新增的標籤的鍵/值組合。鍵不得重複。鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼，且可使用國際字元。
• PROJECT_ID：您的專案 ID。
• DATASET：包含您要加入標籤的資料表或檢視區塊的資料集。
• TABLE_OR_VIEW：要加入標籤的資料表或檢視表名稱。

範例：

如要加入可追蹤部門的資料表標籤，請輸入 bq update 指令並指定 department 做為標籤鍵。例如，如要在預設專案中為 mytable 加入 department:shipping 標籤，請輸入：

    bq update --set_label department:shipping mydataset.mytable

如要加入可追蹤部門的檢視表標籤，請輸入 bq update 指令並指定 department 做為標籤鍵。例如，如要在預設專案中為 myview 加入 department:shipping 標籤，請輸入：

    bq update --set_label department:shipping mydataset.myview

如要在資料表或檢視表中加入多個標籤，請重複使用 set_label 旗標並為每個標籤指定專屬鍵。例如，如要在預設專案中為 mytable 加入 department:shipping 標籤和 cost_center:logistics 標籤，請輸入：

    bq update \
    --set_label department:shipping \
    --set_label cost_center:logistics \
    mydataset.mytable

API

如要在現有資料表或檢視表中加入標籤，請呼叫 tables.patch 方法，然後填入資料集資源的 labels 屬性。

由於系統會將檢視表當做資料表資源處理，因此可以使用 tables.patch 方法來修改檢視表和資料表。

由於 tables.update 方法會取代整個資料集資源，因此建議使用 tables.patch 方法。

Go

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Go 設定操作說明進行操作。詳情請參閱 BigQuery Go API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// addTableLabel demonstrates adding Label metadata to a BigQuery table.
func addTableLabel(projectID, datasetID, tableID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	// tableID := "mytable"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %v", err)
	}
	defer client.Close()

	tbl := client.Dataset(datasetID).Table(tableID)
	meta, err := tbl.Metadata(ctx)
	if err != nil {
		return err
	}

	update := bigquery.TableMetadataToUpdate{}
	update.SetLabel("color", "green")
	if _, err := tbl.Update(ctx, update, meta.ETag); err != nil {
		return err
	}
	return nil
}

Java

這個範例使用 Java 專用 Google HTTP 用戶端程式庫，將要求傳送至 BigQuery API。

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Java 設定操作說明進行操作。詳情請參閱 BigQuery Java API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Table;
import com.google.cloud.bigquery.TableId;
import java.util.HashMap;
import java.util.Map;

// Sample to adds a label to an existing table
public class LabelTable {

  public static void main(String[] args) {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    String tableName = "MY_TABLE_NAME";
    labelTable(datasetName, tableName);
  }

  public static void labelTable(String datasetName, String tableName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      // This example table starts with existing label { color: 'green' }
      Table table = bigquery.getTable(TableId.of(datasetName, tableName));
      // Add label to table
      Map<String, String> labels = new HashMap<>();
      labels.put("color", "green");

      table.toBuilder().setLabels(labels).build().update();
      System.out.println("Label added successfully");
    } catch (BigQueryException e) {
      System.out.println("Label was not added. \n" + e.toString());
    }
  }
}

Node.js

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Node.js 設定操作說明進行操作。詳情請參閱 BigQuery Node.js API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function labelTable() {
  // Adds a label to an existing table.

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const datasetId = 'my_dataset';
  // const tableId = 'my_table';

  const dataset = bigquery.dataset(datasetId);
  const [table] = await dataset.table(tableId).get();

  // Retrieve current table metadata
  const [metadata] = await table.getMetadata();

  // Add label to table metadata
  metadata.labels = {color: 'green'};
  const [apiResponse] = await table.setMetadata(metadata);

  console.log(`${tableId} labels:`);
  console.log(apiResponse.labels);
}

Python

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Python 設定操作說明進行操作。詳情請參閱 BigQuery Python API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

from google.cloud import bigquery

client = bigquery.Client()

# TODO(dev): Change table_id to the full name of the table you want to create.
table_id = "your-project.your_dataset.your_table_name"

table = client.get_table(table_id)  # API request

labels = {"color": "green"}
table.labels = labels

table = client.update_table(table, ["labels"])  # API request

print(f"Added {table.labels} to {table_id}.")

為工作新增標籤

您可以使用 bq 指令列工具的 --label 旗標，透過指令列為查詢工作加入標籤。bq 工具僅支援在查詢工作中加入標籤。

如果某個工作是透過 API 提交，您也可以在其中加入標籤，方法是當您呼叫 jobs.insert 方法時，在工作設定中指定 labels 屬性。API 可用於在任何工作類型中加入標籤。

您無法在待處理、執行中或已完成的工作中加入或更新標籤。

在工作中加入標籤後，標籤就會納入您的帳單資料中。

必要的 IAM 角色

如要取得為作業新增標籤所需的權限，請要求管理員授予您 BigQuery 使用者 (roles/bigquery.user) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 bigquery.jobs.create 權限，這是為工作新增標籤的必要權限。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

如要進一步瞭解 BigQuery 中的 IAM 角色和權限，請參閱預先定義的角色與權限一文。

在工作中加入標籤

如何在工作中加入標籤：

bq

如要在查詢工作中加入標籤，請發出 bq query 指令並搭配使用 --label 旗標。如要新增多個標籤，請重複使用該標記。旗標表示您的查詢採用 GoogleSQL 語法。

bq query --label KEY:VALUE  'QUERY'

更改下列內容：

• KEY:VALUE：您要在查詢工作中加入的標籤鍵/值組合，鍵不得重複。鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼，且可使用國際字元。如要在查詢工作中加入多個標籤，請重複使用 --label 旗標並為每個標籤指定專屬鍵。
• QUERY：有效的 GoogleSQL 查詢。

範例：

如要在查詢工作中加入標籤，請輸入：

    bq query \
    --label department:shipping \
     \
    'SELECT
       column1, column2
     FROM
       `mydataset.mytable`'

如要在查詢工作中加入多個標籤，請重複使用 --label 旗標並為每個標籤指定專屬鍵。例如，如要在查詢工作中加入 department:shipping 標籤和 cost_center:logistics 標籤，請輸入：

    bq query \
    --label department:shipping \
    --label cost_center:logistics \
     \
    'SELECT
       column1, column2
     FROM
       `mydataset.mytable`'

API

如要在工作中加入標籤，請呼叫 jobs.insert 方法，然後填入工作設定的 labels 屬性。您可以使用 API 在任何類型的工作中加入標籤。

Python

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Python 設定操作說明進行操作。詳情請參閱 BigQuery Python API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

from google.cloud import bigquery

client = bigquery.Client()

sql = """
    SELECT corpus
    FROM `bigquery-public-data.samples.shakespeare`
    GROUP BY corpus;
"""
labels = {"color": "green"}

config = bigquery.QueryJobConfig()
config.labels = labels
location = "us"
job = client.query(sql, location=location, job_config=config)
job_id = job.job_id

print(f"Added {job.labels} to {job_id}.")

將工作階段中的工作與標籤建立關聯

如果您在工作階段中執行查詢，可以使用 BigQuery 多重陳述式查詢，為工作階段中所有日後的查詢工作指派標籤。

SQL

執行下列查詢，在工作階段中設定 @@query_label 系統變數：

  SET @@query_label = "KEY:VALUE";
  

• KEY:VALUE：鍵/值組合，用於為工作階段中所有未來的查詢指派標籤。您也可以新增多個鍵/值組合，並以半形逗號分隔 (例如 SET @@query_label = "key1:value1,key2:value2")。鍵不得重複。鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼，且可使用國際字元。

範例：

  SET @@query_label = "cost_center:logistics";
  

API

如要在使用 API 呼叫執行查詢時，在工作階段中為查詢工作新增標籤，請呼叫 jobs.insert 方法，然後填入 connectionProperties 工作設定的 query_label 屬性。

將查詢標籤與工作階段建立關聯，並在工作階段中執行查詢後，即可收集具有該查詢標籤的查詢稽核記錄。詳情請參閱 BigQuery 稽核記錄參考資料。

為預留項目加上標籤

在預訂項目中加入標籤後，標籤就會納入您的帳單資料中。您可以使用標籤，在 Cloud Billing 資料中篩選 Analysis Slots Attribution SKU。

分析時段歸因 SKU 只會記錄時段用量。不會記錄 BigQuery Reservation API SKU 的費用。BigQuery Reservation API SKU 不支援預留項目標籤做為篩選條件。

如要進一步瞭解如何在帳單資料中使用標籤，請參閱「使用篩選器來精簡資料」。

必要的 IAM 角色

如要取得為預留項目新增標籤所需的權限，請要求管理員授予您管理專案的 BigQuery 資源編輯者 (roles/bigquery.resourceEditor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 bigquery.reservations.update 權限，這是為預訂項目新增標籤的必要權限。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

為預留項目加上標籤

如要為預訂項目加上標籤，請按照下列步驟操作：

控制台

1. 前往 Google Cloud 控制台的「BigQuery」頁面。

   前往「BigQuery」

2. 在導覽選單中，按一下「容量管理」。

3. 按一下「運算單元預留項目」分頁標籤。

4. 找出要更新的預訂。

5. 展開「動作」選項。

6. 按一下 [編輯]。

7. 如要展開「進階設定」部分，請按一下展開箭頭。

8. 按一下「新增標籤」。

9. 輸入鍵/值組合。如要套用其他標籤，請按一下「新增標籤」。

10. 按一下 [儲存]。

SQL

如要為預訂項目新增標籤，請使用 ALTER RESERVATION SET OPTIONS DDL 陳述式。設定標籤會覆寫預留項目上的所有現有標籤。以下範例會在預訂項目 myreservation 上設定標籤：

1. 前往 Google Cloud 控制台的「BigQuery」頁面。

   前往「BigQuery」

2. 在查詢編輯器中輸入下列陳述式：

   ALTER RESERVATION myreservation
   SET OPTIONS (
     labels = [('sensitivity', 'high')]);

3. 按一下「執行」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。

bq

如要在預訂中加入標籤，請發出 bq update 指令並搭配使用 set_label 旗標和 --reservation 旗標。如要新增多個標籤，請重複使用 set_label 標記。

bq update --set_label KEY:VALUE --location LOCATION --reservation RESERVATION_NAME

更改下列內容：

• KEY:VALUE：您要新增至預訂的標籤的鍵/值組合。鍵不得重複。鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼，且可使用國際字元。如要在預訂中加入多個標籤，請重複使用 --set_label 旗標並為每個標籤指定專屬鍵。
• LOCATION：預訂地點。 location 標記不得為指令中的最後一個標記，否則系統會傳回 FATAL Flags positioning 錯誤。
• RESERVATION_NAME：預訂名稱。

新增沒有值的標籤

包含具有空白值的鍵的標籤有時稱為標記。請勿與標記資源混淆。詳情請參閱「標籤和標記」。您可以建立不含任何值的新標籤，或是從現有標籤鍵移除值。

如果想幫資源加上標籤，但不需要鍵/值格式，沒有值的標籤就很實用。舉例來說，如果資料表包含多個群組 (例如支援或開發) 使用的測試資料，您可以在該資料表中加入 test_data 標籤以供識別。

如要新增沒有值的標籤，請按照下列步驟操作：

控制台

1. 在 Google Cloud 控制台中，選取適當的資源 (資料集、資料表或檢視表)。

2. 如果是資料集，「Dataset Details」(資料集詳細資料) 頁面會自動開啟；如果是資料表和資料檢視，請按一下 [Details] (詳細資料) 以開啟詳細資料頁面。

   

3. 在「Details」(詳細資料) 頁面中，按一下「Labels」(標籤) 右側的鉛筆圖示。

   

4. 在「Edit labels」(編輯標籤) 對話方塊中：

   • 按一下 [Add label] (新增標籤)。
   • 輸入新的鍵並將值留空。如要套用其他標籤，請按一下「新增標籤」並重複執行相同步驟。
   • 如要儲存變更，請按一下「更新」。

SQL

如要新增沒有值的標籤，請使用 ALTER TABLE SET OPTIONS DDL 陳述式：

1. 前往 Google Cloud 控制台的「BigQuery」頁面。

   前往「BigQuery」

2. 在查詢編輯器中輸入下列陳述式：

   ALTER TABLE mydataset.mytable
   SET OPTIONS (
     labels=[("key1", ""), ("key2", "")]);

3. 按一下「執行」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。

bq

如要為現有資源新增沒有值的標籤，請使用 bq update 指令並加上 set_label 旗標。請指定鍵並在後面加入冒號，但不要指定值。

bq update --set_label KEY: RESOURCE_ID

更改下列內容：

• KEY:：您要使用的標籤鍵。
• RESOURCE_ID：有效的資料集、資料表或檢視表名稱。如果資源位於預設專案以外的專案中，請使用下列格式加入專案 ID：PROJECT_ID:DATASET。

範例：

輸入下列指令，為 mydataset.mytable 建立 test_data 標籤。mydataset 在您的預設專案中。

bq update --set_label test_data: mydataset

API

呼叫 datasets.patch 方法或 tables.patch 方法，並在資料集資源或資料表資源中加入值設為空字串 ("") 的標籤。如要從現有標籤移除值，請將值替換為空字串。

由於系統會將檢視表當做資料表資源處理，因此可以使用 tables.patch 方法來修改檢視表和資料表。此外，因為 tables.update 方法會取代整個資料集資源，因此建議使用 tables.patch 方法。

後續步驟

• 瞭解如何在 BigQuery 資源中查看標籤。
• 瞭解如何在 BigQuery 資源中更新標籤。
• 瞭解如何使用標籤篩選資源。
• 瞭解如何在 BigQuery 資源中刪除標籤。
• 閱讀 Resource Manager 說明文件中的使用標籤相關說明。