BigQuery では、リソースへのラベルの追加がサポートされます。BigQuery のラベルの詳細については、ラベルの概要をご覧ください。
始める前に
Google Cloud コンソールの [Dataform] ページに移動します。
リポジトリを作成または選択します。
開発ワークスペースを作成または選択します。
必要なロール
Dataform テーブルに BigQuery ラベルを追加するために必要な権限を取得するには、ワークスペースに対する Dataform 編集者 (roles/dataform.editor
)IAM ロールの付与を管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
BigQuery ラベルを追加する
Dataform のテーブルに BigQuery ラベルを追加するには、テーブル定義 SQLX ファイルの config
ブロックにある bigquery
ブロックにラベルを追加します。
テーブル定義ファイルに BigQuery ラベルを追加する手順は次のとおりです。
- 開発ワークスペースに移動します。
- [ファイル] ペインで、
definitions/
を展開します。 - SQLX テーブル定義ファイルを選択します。
config
ブロックに、次の形式のラベルを追加します。bigquery: { labels: { LABEL1: "VALUE_OF_LABEL1" } }
次のように置き換えます。
- LABEL1: ラベルの名前
- VALUE_OF_LABEL1: ラベルの値
省略可: 特殊文字を含む名前のラベルを追加するには、ラベル名を引用符
""
で囲みます。省略可: [書式] をクリックします。
次のサンプルコードは、パーティション分割テーブルの定義の 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
次のステップ
- インクルードでコードを再利用する方法については、インクルードで変数と関数を再利用するをご覧ください。
- 実行を手動でトリガーする方法については、トリガーの実行をご覧ください。