実行タグを追加する

このドキュメントでは、タグをDataform コアSQL ワークフローを分類する SQLX ファイルに追加する方法について説明します。

SQL ワークフローのコンポーネントをコレクションに整理するには、次のタイプの SQLX ファイルにカスタムタグを追加します。

  • table
  • view
  • incremental
  • assertion
  • operations

ワークフローの実行中に、選択したタグを持つファイルのみを実行できます。

Cloud Composer または Cloud Scheduler と Cloud Scheduler を併用すると、タグを特定の間隔で選択して、Dataform ワークフローを実行するスケジュールを作成できます。

始める前に

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

    [Dataform] ページに移動

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

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

  4. 次のいずれかのタイプの SQLX ファイルを定義します。

必要なロール

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

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

タグを追加

SQLX ファイルには複数のタグを追加できます。

タグを SQLX ファイルに追加する手順は次のとおりです。

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

  4. config ブロックに、次の形式でタグを追加します。

    tags: ["CUSTOM_TAG"]

    CUSTOM_TAG はタグに置き換えます。

  5. 省略可: 複数のタグを追加するには、, をカンマで区切ります。

次のサンプルコードは、daily と hourly タグの付いた user_counts ビューを示しています。

config {
  type: "view",
  name: "user_counts",
  tags: ["daily", "hourly"]
}

次のステップ