BigQuery ラベルを追加する

このドキュメントでは、Dataform のテーブルにラベルを追加する方法について説明します。

BigQuery では、リソースへのラベルの追加がサポートされます。BigQuery のラベルの詳細については、ラベルの概要をご覧ください。

始める前に

  1. Google Cloud コンソールの [Dataform] ページに移動します。

    [Dataform] ページに移動

  2. リポジトリを作成または選択します。

  3. 開発ワークスペースを作成または選択します。

  4. テーブルを作成する

必要なロール

Dataform テーブルに BigQuery ラベルを追加するために必要な権限を取得するには、ワークスペースに対する Dataform 編集者 （roles/dataform.editor）IAM ロールの付与を管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

BigQuery ラベルを追加する

Dataform のテーブルに BigQuery ラベルを追加するには、テーブル定義 SQLX ファイルの config ブロックにある bigquery ブロックにラベルを追加します。

テーブル定義ファイルに BigQuery ラベルを追加する手順は次のとおりです。

  1. 開発ワークスペースに移動します。
  2. [ファイル] ペインで、definitions/ を展開します。
  3. SQLX テーブル定義ファイルを選択します。

  4. config ブロックに、次の形式のラベルを追加します。

    bigquery: {
    labels: {
      LABEL1: "VALUE_OF_LABEL1"
    }
  }

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

    • LABEL1: ラベルの名前
    • VALUE_OF_LABEL1: ラベルの値

  5. 省略可: 特殊文字を含む名前のラベルを追加するには、ラベル名を引用符 "" で囲みます。

  6. 省略可: [書式] をクリックします。

次のサンプルコードは、パーティション分割テーブルの定義の SQLX ファイルの bigquery ブロックに追加された department:shipping ラベルと cost-center:logistics ラベルを示しています。

config {
  type: "table",
  bigquery: {
    partitionBy: "DATE(ts)",
    labels: {
      department: "shipping",
      "cost-center": "logistics"
    }
  }
}

SELECT CURRENT_TIMESTAMP() AS ts

次のステップ