為資料表、檢視表和資料集加上標籤

主控台

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

   前往「BigQuery」

2. 在「Explorer」窗格中，選取要建立資料集的專案。

3. 依序點按 more_vert 「View actions」(查看動作) >「Create dataset」(建立資料集)。

4. 輸入新資料集的資訊。詳情請參閱「建立資料集」。

5. 展開「代碼」部分。

   1. 如要套用現有標籤，請按照下列步驟操作：

      1. 按一下「選取範圍」旁的下拉式箭頭，然後選擇「目前範圍」，並選取「目前的機構」或「目前的專案」。

         或者，按一下「選取範圍」搜尋資源，或查看目前的資源清單。

      2. 針對「Key 1」和「Value 1」，請從清單中選擇適當的值。

   2. 如要手動輸入新標籤，請按照下列步驟操作：

      1. 按一下「選取範圍」旁的下拉式箭頭，然後依序選擇「手動輸入 ID」>「機構」、「專案」或「標記」。

      2. 如要為專案或機構建立標記，請在對話方塊中輸入 PROJECT_ID 或 ORGANIZATION_ID，然後按一下「儲存」。

      3. 針對「Key 1」和「Value 1」，請從清單中選擇適當的值。

   3. 選用：如要在表格中新增其他標記，請按一下「新增標記」，然後按照先前的步驟操作。

6. 點選「建立資料集」。

SQL

使用 CREATE SCHEMA 陳述式。

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

   前往「BigQuery」

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

   CREATE SCHEMA PROJECT_ID.DATASET_ID
   OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   取代下列項目：

   • PROJECT_ID：您的專案 ID。
   • DATASET_ID：您要建立的資料集 ID。
   • TAG_KEY_1：您要設為資料集第一個標記的命名空間金鑰名稱，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：標記值的簡稱，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二個標記的命名空間鍵名。
   • TAG_VALUE_2：第二個標記值的簡短名稱。

3. 按一下「執行」play_circle。

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

bq

使用 bq mk --dataset 指令並加上 --add_tags 旗標：

bq mk --dataset \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID

更改下列內容：

• TAG：要附加至新資料集的標記。多個標記之間以半形逗號分隔。例如：556741164180/env:prod,myProject/department:sales。每個標記都必須有命名空間限定鍵名和值簡稱。
• PROJECT_ID：您要建立資料集的專案 ID。
• DATASET_ID：新資料集的 ID。

Terraform

使用 google_bigquery_dataset 資源。

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

下列範例會建立名為 my_dataset 的資料集，然後填入 resource_tags 欄位，將標記附加至該資料集：

# Create tag keys and values
data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env2"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department2"
}

resource "google_tags_tag_value" "env_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.env_tag_key.name}"
  short_name = "prod"
}

resource "google_tags_tag_value" "department_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.department_tag_key.name}"
  short_name = "sales"
}

# Create a dataset
resource "google_bigquery_dataset" "default" {
  dataset_id                      = "my_dataset"
  default_partition_expiration_ms = 2592000000  # 30 days
  default_table_expiration_ms     = 31536000000 # 365 days
  description                     = "dataset description"
  location                        = "US"
  max_time_travel_hours           = 96 # 4 days

  # Attach tags to the dataset
  resource_tags = {
    (google_tags_tag_key.env_tag_key.namespaced_name) : google_tags_tag_value.env_tag_value.short_name,
    (google_tags_tag_key.department_tag_key.namespaced_name) : google_tags_tag_value.department_tag_value.short_name
  }
}

如要在 Trusted Cloud 專案中套用 Terraform 設定，請完成下列各節的步驟。

準備 Cloud Shell

1. 啟動 Cloud Shell。

2. 設定要套用 Terraform 設定的預設 Trusted Cloud 專案。

   每項專案只需要執行一次這個指令，且可以在任何目錄中執行。

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   如果您在 Terraform 設定檔中設定明確值，環境變數就會遭到覆寫。

準備目錄

每個 Terraform 設定檔都必須有自己的目錄 (也稱為根模組)。

1. 在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱的副檔名必須是 .tf，例如 main.tf。在本教學課程中，這個檔案稱為 main.tf。

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. 如果您正在學習教學課程，可以複製每個章節或步驟中的範例程式碼。

   將範例程式碼複製到新建立的 main.tf。

   視需要從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議您使用這個方法。

3. 查看並修改範例參數，套用至您的環境。
4. 儲存變更。
5. 初始化 Terraform。每個目錄只需執行一次這項操作。

   terraform init

   如要使用最新版 Google 供應商，請加入 -upgrade 選項：

   terraform init -upgrade

套用變更

1. 檢查設定，確認 Terraform 即將建立或更新的資源符合您的預期：

   terraform plan

   視需要修正設定。

2. 執行下列指令，並在提示中輸入 yes，即可套用 Terraform 設定：

   terraform apply

   等待 Terraform 顯示「Apply complete!」訊息。

3. 開啟 Trusted Cloud 專案即可查看結果。在 Trusted Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。

API

呼叫 datasets.insert 方法，並將標記新增至 resource_tags 欄位。

主控台

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

   前往「BigQuery」

2. 在「Explorer」窗格中展開專案並選取資料集。

3. 在「資料集資訊」部分中，按一下 mode_edit「編輯詳細資料」。

4. 展開「代碼」部分。

   1. 如要套用現有標籤，請按照下列步驟操作：

      1. 按一下「選取範圍」旁的下拉式箭頭，然後選擇「目前範圍」，並選取「目前的機構」或「目前的專案」。

         或者，按一下「選取範圍」搜尋資源，或查看目前的資源清單。

      2. 針對「Key 1」和「Value 1」，請從清單中選擇適當的值。

   2. 如要手動輸入新標籤，請按照下列步驟操作：

      1. 按一下「選取範圍」旁的下拉式箭頭，然後依序選擇「手動輸入 ID」>「機構」、「專案」或「標記」。

      2. 如要為專案或機構建立標記，請在對話方塊中輸入 PROJECT_ID 或 ORGANIZATION_ID，然後按一下「儲存」。

      3. 針對「Key 1」和「Value 1」，請從清單中選擇適當的值。

   3. 選用：如要在表格中新增其他標記，請按一下「新增標記」，然後按照先前的步驟操作。

5. 按一下 [儲存]。

SQL

使用 ALTER SCHEMA SET OPTIONS 陳述式。

以下範例會覆寫現有資料集的所有標記。

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

   前往「BigQuery」

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

   ALTER SCHEMA PROJECT_ID.DATASET_ID
   SET OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   取代下列項目：

   • PROJECT_ID：您的專案 ID。
   • DATASET_ID：包含資料表的資料集 ID。
   • TABLE_ID：您要標記的資料表名稱。
   • TAG_KEY_1：您要設為資料表第一個標記的命名空間鍵名，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：標記值的簡稱，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二個標記的命名空間鍵名。
   • TAG_VALUE_2：第二個標記值的簡短名稱。

3. 按一下「執行」play_circle。

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

以下範例使用 += 運算子，將標記附加至資料集，而不覆寫現有標記。如果現有標記的鍵相同，系統會覆寫該標記。

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

   前往「BigQuery」

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

   ALTER SCHEMA PROJECT_ID.DATASET_ID
   SET OPTIONS (
     tags += [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   取代下列項目：

   • PROJECT_ID：您的專案 ID。
   • DATASET_ID：包含資料表的資料集 ID。
   • TABLE_ID：您要標記的資料表名稱。
   • TAG_KEY_1：您要設為資料表第一個標記的命名空間鍵名，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：標記值的簡稱，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二個標記的命名空間鍵名。
   • TAG_VALUE_2：第二個標記值的簡短名稱。

3. 按一下「執行」play_circle。

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

bq

使用 bq update 指令並加上 --add_tags 旗標：

bq update \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID

更改下列內容：

• TAG：要附加至資料集的標記。 多個標記之間以半形逗號分隔。例如：556741164180/env:prod,myProject/department:sales。每個標記都必須有命名空間限定鍵名和值簡稱。
• PROJECT_ID：現有資料集所在的專案 ID。
• DATASET_ID：現有資料集的 ID。

gcloud

如要使用指令列將標記附加至資料集，請使用 gcloud resource-manager tags bindings create 指令建立標記繫結資源：

gcloud resource-manager tags bindings create \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

更改下列內容：

• TAG_VALUE_NAME：要附加的標記值永久 ID 或命名空間名稱，例如 tagValues/4567890123 或 1234567/my_tag_key/my_tag_value。
• RESOURCE_ID：資料集的完整 ID，包括 API 網域名稱 (//bigquery.googleapis.com/)，用於識別資源類型。例如：//bigquery.googleapis.com/projects/my_project/datasets/my_dataset。
• LOCATION： 資料集的位置。

Terraform

將標記新增至資料集的 resource_tags 欄位，然後使用 google_bigquery_dataset 資源套用更新後的設定。詳情請參閱「建立新資料集時附加標記」一文中的 Terraform 範例。

API

呼叫 datasets.get 方法，取得資料集資源，包括 resource_tags 欄位。將標記新增至 resource_tags 欄位，然後使用 datasets.update 方法傳回更新後的資料集資源。

主控台

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

   前往「BigQuery」

2. 在「Explorer」窗格中展開專案並選取資料集。

   標記會顯示在「資料集資訊」部分。

bq

如要列出附加至資料集的標記，請使用 bq show 指令。

bq show PROJECT_ID:DATASET_ID

更改下列內容：

• PROJECT_ID：包含資料集的專案 ID。
• DATASET_ID：您要列出標記的資料集 ID。

gcloud

如要取得附加至資源的標記繫結清單，請使用 gcloud resource-manager tags bindings list 指令：

gcloud resource-manager tags bindings list \
    --parent=RESOURCE_ID \
    --location=LOCATION

更改下列內容：

• RESOURCE_ID：資料集的完整 ID，包括 API 網域名稱 (//bigquery.googleapis.com/)，用於識別資源類型。例如：//bigquery.googleapis.com/projects/my_project/datasets/my_dataset。

• LOCATION：資料集的位置。

輸出結果會與下列內容相似：

name: tagBindings/%2F%2Fbigquery.googleapis.com%2Fprojects%2Fmy_project%2Fdatasets%2Fmy_dataset/tagValues/4567890123
parent: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
tagValue: tagValues/4567890123

Terraform

使用 terraform state show 指令列出資料集的屬性，包括 resource_tags 欄位。在資料集 Terraform 設定檔的執行目錄中執行這項指令。

terraform state show google_bigquery_dataset.default

API

呼叫 datasets.get 方法，取得資料集資源。資料集資源包含附加至 resource_tags 欄位中資料集的標記。

觀看次數

使用 INFORMATION_SCHEMA.SCHEMATA_OPTIONS 檢視畫面。

舉例來說，下列查詢會顯示區域中所有資料集附加的所有標記。這項查詢會傳回資料表，其中包含 schema_name (資料集名稱)、option_name (一律為 'tags')、object_type (一律為 ARRAY<STRUCT<STRING, STRING>>) 和 option_value 等資料欄，其中包含代表與每個資料集相關聯標記的 STRUCT 物件陣列。如果資料集沒有指派的標記，option_value 欄會傳回空陣列。

SELECT * from region-REGION.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE option_name='tags'

更改下列內容：

• REGION：資料集所在的區域。

主控台

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

   前往「BigQuery」

2. 在「Explorer」窗格中展開專案並選取資料集。

3. 在「資料集資訊」部分中，按一下 mode_edit「編輯詳細資料」。

4. 在「標記」部分中，找出要刪除的標記，然後按一下旁邊的「刪除項目」delete。

5. 按一下 [儲存]。

SQL

使用 ALTER SCHEMA SET OPTIONS 陳述式。

以下範例使用 -= 運算子，從資料集卸離標記。如要從資料集卸離所有標籤，可以指定 tags=NULL 或 tags=[]。

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

   前往「BigQuery」

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

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags -= [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   取代下列項目：

   • PROJECT_ID：您的專案 ID。
   • DATASET_ID：包含資料表的資料集 ID。
   • TABLE_ID：要從中卸離標記的資料表名稱。
   • TAG_KEY_1：要卸離的第一個標記的命名空間鍵名，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：要取消連結的標記值的簡短名稱，例如 'prod' 或 'sales'。
   • TAG_KEY_2：要卸離的第二個標記的命名空間金鑰名稱。
   • TAG_VALUE_2：要卸離的第二個代碼值的簡短名稱。

3. 按一下「執行」play_circle。

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

bq

使用 bq update 指令並加上 --remove_tags 旗標：

bq update \
    --remove_tags=REMOVED_TAG \
    PROJECT_ID:DATASET_ID

更改下列內容：

• REMOVED_TAG：要從資料集中移除的標記。多個標記之間以半形逗號分隔。僅接受沒有值配對的鍵。例如：556741164180/env,myProject/department。每個標記都必須有命名空間鍵名。
• PROJECT_ID：包含資料集的專案 ID。
• DATASET_ID：要從中卸離標記的資料集 ID。

或者，如要從資料集移除「所有」標記，請使用 bq update 指令並搭配 --clear_all_tags 標記：

bq update \
    --clear_all_tags
    PROJECT_ID:DATASET_ID

gcloud

如要使用指令列將標記從資料集分離，請使用 gcloud resource-manager tags bindings delete 指令刪除標記繫結：

gcloud resource-manager tags bindings delete \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

更改下列內容：

• TAG_VALUE_NAME：要卸離的標記值的永久 ID 或命名空間名稱，例如 tagValues/4567890123 或 1234567/my_tag_key/my_tag_value。
• RESOURCE_ID：資料集的完整 ID，包括 API 網域名稱 (//bigquery.googleapis.com/)，用於識別資源類型。例如：//bigquery.googleapis.com/projects/my_project/datasets/my_dataset。
• LOCATION：資料集的位置。

Terraform

從資料集的 resource_tags 欄位中移除標記，然後使用 google_bigquery_dataset 資源套用更新後的設定。

API

呼叫 datasets.get 方法，取得資料集資源，包括 resource_tags 欄位。從 resource_tags 欄位移除代碼，並使用 datasets.update 方法傳回更新後的資料集資源。

主控台

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

   前往「BigQuery」

2. 在「Explorer」窗格中展開專案，然後選取資料集。

3. 在「資料集資訊」部分，按一下 add_box 「建立資料表」。

4. 輸入新資料表的資訊。詳情請參閱「建立及使用資料表」。

5. 展開「代碼」部分。

   1. 如要套用現有標籤，請按照下列步驟操作：

      1. 按一下「選取範圍」旁的下拉式箭頭，然後選擇「目前範圍」，並選取「目前的機構」或「目前的專案」。

         或者，按一下「選取範圍」搜尋資源，或查看目前的資源清單。

      2. 針對「Key 1」和「Value 1」，請從清單中選擇適當的值。

   2. 如要手動輸入新標籤，請按照下列步驟操作：

      1. 按一下「選取範圍」旁的下拉式箭頭，然後依序選擇「手動輸入 ID」>「機構」、「專案」或「標記」。

      2. 如要為專案或機構建立標記，請在對話方塊中輸入 PROJECT_ID 或 ORGANIZATION_ID，然後按一下「儲存」。

      3. 針對「Key 1」和「Value 1」，請從清單中選擇適當的值。

   3. 選用：如要在表格中新增其他標記，請按一下「新增標記」，然後按照先前的步驟操作。

6. 點選「建立資料表」。

SQL

使用 CREATE TABLE 陳述式。

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

   前往「BigQuery」

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

   CREATE TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   取代下列項目：

   • PROJECT_ID：您的專案 ID。
   • DATASET_ID：您要在其中建立資料表的資料集 ID。
   • TABLE_ID：新資料表的名稱。
   • TAG_KEY_1：您要設為資料表第一個標記的命名空間鍵名，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：標記值的簡稱，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二個標記的命名空間鍵名。
   • TAG_VALUE_2：第二個標記值的簡短名稱。

3. 按一下「執行」play_circle。

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

bq

使用 bq mk --table 指令並加上 --add_tags 旗標：

bq mk --table \
    --schema=SCHEMA \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID.TABLE_ID

更改下列內容：

• SCHEMA：內嵌結構定義。
• TAG：要附加至新表格的標記。多個標記之間以半形逗號分隔。例如：556741164180/env:prod,myProject/department:sales。每個標記都必須有命名空間限定鍵名和值簡稱。
• PROJECT_ID：您要建立表格的專案 ID。
• DATASET_ID：您要在其中建立資料表的資料集 ID。
• TABLE_ID：新資料表的 ID。

Terraform

使用 google_bigquery_table 資源。

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

下列範例會建立名為 mytable 的資料表，然後填入 resource_tags 欄位，將標記附加至該資料表：

# Create tag keys and values
data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env3"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department3"
}

resource "google_tags_tag_value" "env_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.env_tag_key.name}"
  short_name = "prod"
}

resource "google_tags_tag_value" "department_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.department_tag_key.name}"
  short_name = "sales"
}

# Create a dataset
resource "google_bigquery_dataset" "default" {
  dataset_id                      = "MyDataset"
  default_partition_expiration_ms = 2592000000  # 30 days
  default_table_expiration_ms     = 31536000000 # 365 days
  description                     = "dataset description"
  location                        = "US"
  max_time_travel_hours           = 96 # 4 days
}

# Create a table
resource "google_bigquery_table" "default" {
  dataset_id          = google_bigquery_dataset.default.dataset_id
  table_id            = "mytable"
  description         = "table description"
  deletion_protection = false # set to "true" in production

  # Attach tags to the table
  resource_tags = {
    (google_tags_tag_key.env_tag_key.namespaced_name) : google_tags_tag_value.env_tag_value.short_name,
    (google_tags_tag_key.department_tag_key.namespaced_name) : google_tags_tag_value.department_tag_value.short_name
  }
}

如要在 Trusted Cloud 專案中套用 Terraform 設定，請完成下列各節的步驟。

準備 Cloud Shell

1. 啟動 Cloud Shell。

2. 設定要套用 Terraform 設定的預設 Trusted Cloud 專案。

   每項專案只需要執行一次這個指令，且可以在任何目錄中執行。

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   如果您在 Terraform 設定檔中設定明確值，環境變數就會遭到覆寫。

準備目錄

每個 Terraform 設定檔都必須有自己的目錄 (也稱為根模組)。

1. 在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱的副檔名必須是 .tf，例如 main.tf。在本教學課程中，這個檔案稱為 main.tf。

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. 如果您正在學習教學課程，可以複製每個章節或步驟中的範例程式碼。

   將範例程式碼複製到新建立的 main.tf。

   視需要從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議您使用這個方法。

3. 查看並修改範例參數，套用至您的環境。
4. 儲存變更。
5. 初始化 Terraform。每個目錄只需執行一次這項操作。

   terraform init

   如要使用最新版 Google 供應商，請加入 -upgrade 選項：

   terraform init -upgrade

套用變更

1. 檢查設定，確認 Terraform 即將建立或更新的資源符合您的預期：

   terraform plan

   視需要修正設定。

2. 執行下列指令，並在提示中輸入 yes，即可套用 Terraform 設定：

   terraform apply

   等待 Terraform 顯示「Apply complete!」訊息。

3. 開啟 Trusted Cloud 專案即可查看結果。在 Trusted Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。

API

使用已定義的資料表資源呼叫 tables.insert 方法。在 resource_tags 欄位中加入標記。

主控台

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

   前往「BigQuery」

2. 在「Explorer」窗格中，展開專案和資料集，然後選取資料表。

3. 按一下「詳細資料」分頁標籤，然後點選「編輯詳細資料」mode_edit。

4. 展開「代碼」部分。

   1. 如要套用現有標籤，請按照下列步驟操作：

      1. 按一下「選取範圍」旁的下拉式箭頭，然後選擇「目前範圍」，並選取「目前的機構」或「目前的專案」。

         或者，按一下「選取範圍」搜尋資源，或查看目前的資源清單。

      2. 針對「Key 1」和「Value 1」，請從清單中選擇適當的值。

   2. 如要手動輸入新標籤，請按照下列步驟操作：

      1. 按一下「選取範圍」旁的下拉式箭頭，然後依序選擇「手動輸入 ID」>「機構」、「專案」或「標記」。

      2. 如要為專案或機構建立標記，請在對話方塊中輸入 PROJECT_ID 或 ORGANIZATION_ID，然後按一下「儲存」。

      3. 針對「Key 1」和「Value 1」，請從清單中選擇適當的值。

   3. 選用：如要在表格中新增其他標記，請按一下「新增標記」，然後按照先前的步驟操作。

5. 按一下 [儲存]。

SQL

使用 ALTER TABLE SET OPTIONS 陳述式。

以下範例會覆寫現有資料表的所有標記。

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

   前往「BigQuery」

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

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   取代下列項目：

   • PROJECT_ID：您的專案 ID。
   • DATASET_ID：包含資料表的資料集 ID。
   • TABLE_ID：您要標記的資料表名稱。
   • TAG_KEY_1：您要設為資料表第一個標記的命名空間鍵名，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：標記值的簡稱，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二個標記的命名空間鍵名。
   • TAG_VALUE_2：第二個標記值的簡短名稱。

3. 按一下「執行」play_circle。

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

以下範例使用 += 運算子將標記附加至資料表，而不覆寫現有標記。如果現有標記的鍵相同，系統會覆寫該標記。

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

   前往「BigQuery」

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

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags += [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   取代下列項目：

   • PROJECT_ID：您的專案 ID。
   • DATASET_ID：包含資料表的資料集 ID。
   • TABLE_ID：您要標記的資料表名稱。
   • TAG_KEY_1：您要設為資料表第一個標記的命名空間鍵名，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：標記值的簡稱，例如 'prod' 或 'sales'。
   • TAG_KEY_2：第二個標記的命名空間鍵名。
   • TAG_VALUE_2：第二個標記值的簡短名稱。

3. 按一下「執行」play_circle。

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

bq

使用 bq update 指令並加上 --add_tags 旗標：

bq update \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID.TABLE_ID

更改下列內容：

• TAG：要附加至資料表的標記。多個標記之間以半形逗號分隔。例如：556741164180/env:prod,myProject/department:sales。每個標記都必須有命名空間限定鍵名和值簡稱。
• PROJECT_ID：包含資料表的專案 ID。
• DATASET_ID：包含資料表的資料集 ID。
• TABLE_ID：您要更新的資料表 ID。

gcloud

如要透過指令列將標記附加至資料表，請使用 gcloud resource-manager tags bindings create 指令建立標記繫結資源：

gcloud resource-manager tags bindings create \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

更改下列內容：

• TAG_VALUE_NAME：要附加的標記值永久 ID 或命名空間名稱，例如 tagValues/4567890123 或 1234567/my_tag_key/my_tag_value。
• RESOURCE_ID：資料表的完整 ID，包括 API 網域名稱 (//bigquery.googleapis.com/)，用於識別資源類型。例如： //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table
• LOCATION：資料表的位置。

Terraform

在資料表的 resource_tags 欄位中新增標記，然後使用 google_bigquery_table 資源套用更新後的設定。詳情請參閱「建立新資料表時附加標記」一文中的 Terraform 範例。

API

使用已定義的資料表資源呼叫 tables.update 方法。在 resource_tags 欄位中加入標記。

主控台

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

   前往「BigQuery」

2. 在「Explorer」窗格中，展開專案和資料集，然後選取資料表。

   標籤會顯示在「詳細資料」分頁中。

bq

使用 bq show 指令，然後尋找 tags 欄。如果表格中沒有任何代碼，系統就不會顯示「tags」欄。

bq show \
    PROJECT_ID:DATASET_ID.TABLE_ID

更改下列內容：

• PROJECT_ID：包含資料表的專案 ID。
• DATASET_ID：包含資料表的資料集 ID。
• TABLE_ID：資料表的 ID。

gcloud

如要取得附加至資源的標記繫結清單，請使用 gcloud resource-manager tags bindings list 指令：

gcloud resource-manager tags bindings list \
    --parent=RESOURCE_ID \
    --location=LOCATION

更改下列內容：

• RESOURCE_ID：資料表的完整 ID，包括 API 網域名稱 (//bigquery.googleapis.com/)，用於識別資源類型。例如：//bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table。

• LOCATION：資料集的位置。

輸出結果會與下列內容相似：

name: tagBindings/%2F%2Fbigquery.googleapis.com%2Fprojects%2Fmy_project%2Fdatasets%2Fmy_dataset/tagValues/4567890123
parent: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
tagValue: tagValues/4567890123

Terraform

使用 terraform state show 指令列出資料表的屬性，包括 resource_tags 欄位。在執行資料表 Terraform 設定檔的目錄中執行這項指令。

terraform state show google_bigquery_table.default

API

使用已定義的資料表資源呼叫 tables.get 方法，並尋找 resource_tags 欄位。

觀看次數

使用 INFORMATION_SCHEMA.TABLE_OPTIONS 檢視畫面。

舉例來說，下列查詢會顯示資料集中所有資料表附加的所有標記。這項查詢會傳回資料表，其中包含 schema_name (資料集名稱)、option_name (一律為 'tags')、object_type (一律為 ARRAY<STRUCT<STRING, STRING>>) 和 option_value 等資料欄，其中包含代表與每個資料集相關聯標記的 STRUCT 物件陣列。如果資料表未指派標記，option_value 欄會傳回空陣列。

SELECT * from DATASET_ID.INFORMATION_SCHEMA.TABLE_OPTIONS
WHERE option_name='tags'

請將 DATASET_ID 改成包含資料表的資料集 ID。

主控台

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

   前往「BigQuery」

2. 在「Explorer」窗格中，展開專案和資料集，然後選取資料表。

3. 按一下「詳細資料」分頁標籤，然後點選「編輯詳細資料」mode_edit。

4. 在「標記」部分中，找出要刪除的標記，然後按一下旁邊的「刪除項目」delete。

5. 按一下 [儲存]。

SQL

使用 ALTER TABLE SET OPTIONS 陳述式。

下列範例使用 -= 運算子，從資料表卸離標記。如要從表格中取消連結所有標記，可以指定 tags=NULL 或 tags=[]。

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

   前往「BigQuery」

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

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags -= [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   取代下列項目：

   • PROJECT_ID：您的專案 ID。
   • DATASET_ID：包含資料表的資料集 ID。
   • TABLE_ID：要從中卸離標記的資料表名稱。
   • TAG_KEY_1：要卸離的第一個標記的命名空間鍵名，例如 'my-project/env' 或 '556741164180/department'。
   • TAG_VALUE_1：要取消連結的標記值的簡短名稱，例如 'prod' 或 'sales'。
   • TAG_KEY_2：要卸離的第二個標記的命名空間金鑰名稱。
   • TAG_VALUE_2：要卸離的第二個代碼值的簡短名稱。

3. 按一下「執行」play_circle。

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

bq

如要從資料表移除部分標記，請使用帶有 --remove_tags 旗標的 bq update 指令：

bq update \
    --remove_tags=TAG_KEYS \
    PROJECT_ID:DATASET_ID.TABLE_ID

更改下列內容：

• TAG_KEYS：要從資料表分離的標記鍵，以半形逗號分隔。例如：556741164180/env,myProject/department。每個標記鍵都必須有命名空間鍵名。
• PROJECT_ID：包含資料表的專案 ID。
• DATASET_ID：包含資料表的資料集 ID。
• TABLE_ID：您要更新的資料表 ID。

如要從資料表移除所有標記，請使用 bq update 指令搭配 --clear_all_tags 標記：

bq update \
    --clear_all_tags \
    PROJECT_ID:DATASET_ID.TABLE_ID

gcloud

如要透過指令列從資料表移除標記關聯，請使用 gcloud resource-manager tags bindings delete 指令刪除標記繫結：

gcloud resource-manager tags bindings delete \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

更改下列內容：

• TAG_VALUE_NAME：要刪除的標記值的永久 ID 或命名空間名稱，例如 tagValues/4567890123 或 1234567/my_tag_key/my_tag_value。
• RESOURCE_ID：資料表的完整 ID，包括 API 網域名稱 (//bigquery.googleapis.com/)，用於識別資源類型。例如：//bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table。
• LOCATION：資料集的位置。

Terraform

從資料表的 resource_tags 欄位中移除標記，然後使用 google_bigquery_table 資源套用更新後的設定。

API

使用已定義的資料表資源呼叫 tables.update 方法，然後移除 resource_tags 欄位中的標記。如要移除所有標記，請移除 resource_tags 欄位。