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

次のステップ