テーブル、ビュー、データセットにタグを付ける

コンソール

1. Trusted Cloud コンソールで、[BigQuery] ページに移動します。

   [BigQuery] に移動

2. [エクスプローラ] ペインで、データセットを作成するプロジェクトを選択します。

3. more_vert（アクションを表示）> [データセットを作成] をクリックします。

4. 新しいデータセットの情報を入力します。詳細については、データセットを作成するをご覧ください。

5. [タグ] セクションを開きます。

   1. 既存のタグを適用する手順は次のとおりです。

      1. [スコープの選択] の横にあるプルダウン矢印をクリックし、[現在の対象] - [現在の組織を選択] または [現在のプロジェクトを選択] を選択します。

         または、[スコープの選択] をクリックして、リソースを検索するか、現在のリソースのリストを表示します。

      2. [キー 1] と [値 1] で、リストから適切な値を選択します。

   2. 新しいタグを手動で入力する手順は次のとおりです。

      1. [スコープを選択] の横にあるプルダウン矢印をクリックし、[ID を手動で入力] > [組織]、[プロジェクト]、または [タグ] を選択します。

      2. プロジェクトまたは組織のタグを作成する場合は、ダイアログで PROJECT_ID または ORGANIZATION_ID を入力し、[保存] をクリックします。

      3. [キー 1] と [値 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: 2 番目のタグの名前空間付きキー名。
   • TAG_VALUE_2: 2 番目のタグの値の短い名前。

3. [play_circle実行] をクリックします。

クエリの実行方法については、インタラクティブ クエリを実行するをご覧ください。

bq

--add_tags フラグを指定して bq mk --dataset コマンドを使用します。

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 プロジェクトを設定します。

   このコマンドは、プロジェクトごとに 1 回だけ実行する必要があります。これは任意のディレクトリで実行できます。

   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 を初期化します。これは、ディレクトリごとに 1 回だけ行います。

   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. [エクスプローラ] ペインでプロジェクトを開いて、データセットを選択します。

3. [データセット情報] セクションで、mode_edit [詳細を編集] をクリックします。

4. [タグ] セクションを開きます。

   1. 既存のタグを適用する手順は次のとおりです。

      1. [スコープの選択] の横にあるプルダウン矢印をクリックし、[現在の対象] - [現在の組織を選択] または [現在のプロジェクトを選択] を選択します。

         または、[スコープの選択] をクリックして、リソースを検索するか、現在のリソースのリストを表示します。

      2. [キー 1] と [値 1] で、リストから適切な値を選択します。

   2. 新しいタグを手動で入力する手順は次のとおりです。

      1. [スコープを選択] の横にあるプルダウン矢印をクリックし、[ID を手動で入力] > [組織]、[プロジェクト]、または [タグ] を選択します。

      2. プロジェクトまたは組織のタグを作成する場合は、ダイアログで PROJECT_ID または ORGANIZATION_ID を入力し、[保存] をクリックします。

      3. [キー 1] と [値 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: 2 番目のタグの名前空間付きキー名。
   • TAG_VALUE_2: 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: 2 番目のタグの名前空間付きキー名。
   • TAG_VALUE_2: 2 番目のタグの値の短い名前。

3. [play_circle実行] をクリックします。

クエリの実行方法については、インタラクティブ クエリを実行するをご覧ください。

bq

--add_tags フラグを指定して bq update コマンドを使用します。

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: リソースのタイプを識別するための API ドメイン名（//bigquery.googleapis.com/）を含む、データセットの完全な ID（例: //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. [エクスプローラ] ペインでプロジェクトを開いて、データセットを選択します。

   タグが [データセット情報] セクションに表示されます。

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: リソースのタイプを識別するための API ドメイン名（//bigquery.googleapis.com/）を含む、データセットの完全な ID（例: //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. [エクスプローラ] ペインでプロジェクトを開いて、データセットを選択します。

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: 適用を解除する 2 番目のタグの名前空間付きのキー名。
   • TAG_VALUE_2: 適用を解除する 2 番目のタグの値の短い名前。

3. [play_circle実行] をクリックします。

クエリの実行方法については、インタラクティブ クエリを実行するをご覧ください。

bq

--remove_tags フラグを指定して bq update コマンドを使用します。

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

次のように置き換えます。

• REMOVED_TAG: データセットから削除するタグ。複数のタグを指定する場合はカンマで区切ります。値のペアのないキーのみを受け入れます。例: 556741164180/env,myProject/department。各タグには名前空間付きのキー名が必要です。
• PROJECT_ID: データセットを含むプロジェクトの ID。
• DATASET_ID: タグを取り外すデータセットの ID。

データセットからすべてのタグを削除する場合は、--clear_all_tags フラグを指定して bq update コマンドを使用します。

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: リソースのタイプを識別するための API ドメイン名（//bigquery.googleapis.com/）を含む、データセットの完全な ID（例: //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. [エクスプローラ] ペインでプロジェクトを開き、データセットを選択します。

3. [データセット情報] セクションで、add_box[テーブルを作成] をクリックします。

4. 新しいテーブルの情報を入力します。詳細については、テーブルの作成と使用をご覧ください。

5. [タグ] セクションを開きます。

   1. 既存のタグを適用する手順は次のとおりです。

      1. [スコープの選択] の横にあるプルダウン矢印をクリックし、[現在の対象] - [現在の組織を選択] または [現在のプロジェクトを選択] を選択します。

         または、[スコープの選択] をクリックして、リソースを検索するか、現在のリソースのリストを表示します。

      2. [キー 1] と [値 1] で、リストから適切な値を選択します。

   2. 新しいタグを手動で入力する手順は次のとおりです。

      1. [スコープを選択] の横にあるプルダウン矢印をクリックし、[ID を手動で入力] > [組織]、[プロジェクト]、または [タグ] を選択します。

      2. プロジェクトまたは組織のタグを作成する場合は、ダイアログで PROJECT_ID または ORGANIZATION_ID を入力し、[保存] をクリックします。

      3. [キー 1] と [値 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: 2 番目のタグの名前空間付きキー名。
   • TAG_VALUE_2: 2 番目のタグの値の短い名前。

3. [play_circle実行] をクリックします。

クエリの実行方法については、インタラクティブ クエリを実行するをご覧ください。

bq

--add_tags フラグを指定して bq mk --table コマンドを使用します。

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 プロジェクトを設定します。

   このコマンドは、プロジェクトごとに 1 回だけ実行する必要があります。これは任意のディレクトリで実行できます。

   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 を初期化します。これは、ディレクトリごとに 1 回だけ行います。

   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. [エクスプローラ] ペインで、プロジェクトとデータセットを開いて、テーブルを選択します。

3. [詳細] タブをクリックし、mode_edit（詳細を編集）をクリックします。

4. [タグ] セクションを開きます。

   1. 既存のタグを適用する手順は次のとおりです。

      1. [スコープの選択] の横にあるプルダウン矢印をクリックし、[現在の対象] - [現在の組織を選択] または [現在のプロジェクトを選択] を選択します。

         または、[スコープの選択] をクリックして、リソースを検索するか、現在のリソースのリストを表示します。

      2. [キー 1] と [値 1] で、リストから適切な値を選択します。

   2. 新しいタグを手動で入力する手順は次のとおりです。

      1. [スコープを選択] の横にあるプルダウン矢印をクリックし、[ID を手動で入力] > [組織]、[プロジェクト]、または [タグ] を選択します。

      2. プロジェクトまたは組織のタグを作成する場合は、ダイアログで PROJECT_ID または ORGANIZATION_ID を入力し、[保存] をクリックします。

      3. [キー 1] と [値 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: 2 番目のタグの名前空間付きキー名。
   • TAG_VALUE_2: 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: 2 番目のタグの名前空間付きキー名。
   • TAG_VALUE_2: 2 番目のタグの値の短い名前。

3. [play_circle実行] をクリックします。

クエリの実行方法については、インタラクティブ クエリを実行するをご覧ください。

bq

--add_tags フラグを指定して bq update コマンドを使用します。

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: リソースのタイプを識別するための API ドメイン名（//bigquery.googleapis.com/）を含む、テーブルの完全な ID。例: //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. [エクスプローラ] ペインで、プロジェクトとデータセットを開いて、テーブルを選択します。

   タグは [詳細] タブに表示されます。

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: リソースのタイプを識別する API ドメイン名（//bigquery.googleapis.com/）を含む、テーブルの完全な ID。例: //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. [エクスプローラ] ペインで、プロジェクトとデータセットを開いて、テーブルを選択します。

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: 適用を解除する 2 番目のタグの名前空間付きのキー名。
   • TAG_VALUE_2: 適用を解除する 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。

テーブルからすべてのタグを削除するには、--clear_all_tags フラグを指定して bq update コマンドを使用します。

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: リソースのタイプを識別する API ドメイン名（//bigquery.googleapis.com/）を含む、テーブルの完全な ID。例: //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 フィールドを削除します。