リポジトリを管理する

このドキュメントでは、Dataform で次の操作を行う方法について説明します。

• Dataform ワークフロー設定を構成する。
• Dataform コアパッケージを管理する。
• コードのバージョン管理を行う。

始める前に

1. リポジトリを作成する
2. 省略可: リポジトリをサードパーティの Git リポジトリに接続します。
3. リポジトリで開発ワークスペースを作成して初期化します。

必要なロール

このドキュメントのタスクを完了するために必要な権限を取得するには、管理者に次の IAM ロールを付与するよう依頼してください。

• Dataform の設定を構成し、Dataform コア パッケージのロケーションを管理する: リポジトリに対する Dataform 管理者 （roles/dataform.admin）。
• Dataform コア パッケージを更新し、Dataform でバージョン管理を使用する: ワークスペースの Dataform 編集者 （roles/dataform.editor）。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

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

Dataform ワークフローの設定を構成する

このセクションでは、特定のリポジトリの Dataform ワークフロー処理設定を編集する方法について説明します。

設定ファイルを編集してスキーマの名前を変更したり、カスタム コンパイル変数をリポジトリに追加したりする必要が生じることがあります。

リポジトリの設定について

各 Dataform リポジトリには、固有のワークフロー設定ファイルが含まれています。このファイルには、 Google Cloud プロジェクト ID と、Dataform が BigQuery にアセットを公開するスキーマが含まれています。Dataform はデフォルトの設定を使用しますが、設定ファイルを編集してニーズに最も合うようにオーバーライドできます。

Dataform コア 3.0.0 以降、ワークフロー設定はデフォルトで workflow_settings.yaml ファイルに保存されます。以前のバージョンの Dataform コアでは、ワークフロー設定は dataform.json ファイルに保存されます。これらの構成ファイルは、リポジトリのルート ディレクトリに配置する必要があります。Dataform コア 3.0 の workflow_settings.yaml ファイルには、dataform.json ファイルとの下位互換性があります。dataform.json ファイルを使用してワークフロー設定を保存することは引き続き可能です。今後の互換性のために、workflow_settings.yaml 形式にリポジトリ ワークフロー設定を移行することをおすすめします。

workflow_settings.yaml の概要

Dataform コア 3.0 で導入された workflow_settings.yaml ファイルには、Dataform ワークフロー設定が YAML 形式で保存されます。

次のコードサンプルは、サンプル workflow_settings.yaml ファイルを示しています。

  defaultProject: my-gcp-project-id
  defaultDataset: dataform
  defaultLocation: australia-southeast2
  defaultAssertionDataset: dataform_assertions

上記のコードサンプルでは、Key-Value ペアは次のように記述されています。

• defaultProject: BigQuery Google Cloud プロジェクト ID。
• defaultDataset: Dataform がアセットを作成する BigQuery データセット。デフォルトでは dataform と呼ばれます。

• defaultLocation（省略可）: デフォルトの BigQuery データセットのロケーション。Dataform は、このロケーションを使用してコードを処理し、結果を保存します。この処理ロケーションは、BigQuery データセットのロケーションと一致する必要があります。ただし、Dataform リポジトリのロケーションと一致する必要はありません。

  defaultLocation パラメータを設定しない場合、Dataform は SQL クエリが参照するデータセットに基づいてロケーションを決定します。この機能は次のように動作します。

  • クエリが同じロケーションのデータセットを参照している場合、Dataform はそのロケーションを使用します。
  • クエリが 2 つ以上の異なるロケーションのデータセットを参照している場合、エラーが発生します。この制限の詳細については、クロスリージョン データセット レプリケーションをご覧ください。
  • クエリがデータセットを参照していない場合、Dataform のデフォルトのロケーションは US マルチリージョンです。別の場所を選択するには、デフォルトの場所を設定します。または、クエリで @@location システム変数を使用します。詳細については、ロケーションを指定するをご覧ください。

• defaultAssertionDataset: Dataform がアサーション結果を含むビューを作成する BigQuery データセット。デフォルトでは dataform_assertions と呼ばれます。

workflow_settings.yaml プロパティの詳細については、GitHub の WorkflowSettings をご覧ください。

workflow_settings.yaml で定義されたプロパティには、Dataform コードで dataform.projectConfig オブジェクトのプロパティとしてアクセスできます。

workflow_settings.yaml オプションからコードでアクセス可能な dataform.projectConfig オプションへの次のマッピングが適用されます。

• defaultProject => defaultDatabase
• defaultDataset => defaultSchema
• defaultAssertionDataset => assertionSchema
• projectSuffix => databaseSuffix
• datasetSuffix => schemaSuffix
• namePrefix => tablePrefix

次のコードサンプルは、ビューの SELECT ステートメントで参照される dataform.projectConfig オブジェクトを示しています。

  config { type: "view" }
  SELECT ${when(
    !dataform.projectConfig.tablePrefix,
    "table prefix is set!",
    "table prefix is not set!"
  )}

dataform.json の概要

dataform.json ファイルには、Dataform ワークフロー設定が JSON 形式で保存されます。

次のコードサンプルは、サンプル dataform.json ファイルを示しています。

  {
    "warehouse": "bigquery",
    "defaultDatabase": "my-gcp-project-id",
    "defaultSchema": "dataform",
    "defaultLocation": "australia-southeast2",
    "assertionSchema": "dataform_assertions"
  }

上記のコードサンプルでは、Key-Value ペアは次のように記述されています。

• warehouse: Dataform がアセットを作成する BigQuery へのポインタ。
• defaultDatabase: BigQuery Google Cloud プロジェクト ID。
• defaultSchema: Dataform がアセットを作成する BigQuery データセット。

• defaultLocation（省略可）: デフォルトの BigQuery データセットのロケーション。Dataform は、このロケーションを使用してコードを処理し、結果を保存します。この処理ロケーションは、BigQuery データセットのロケーションと一致する必要があります。ただし、Dataform リポジトリのロケーションと一致する必要はありません。

  defaultLocation パラメータを設定しない場合、Dataform は SQL クエリが参照するデータセットに基づいてロケーションを決定します。この機能は次のように動作します。

  • クエリが同じロケーションのデータセットを参照している場合、Dataform はそのロケーションを使用します。
  • クエリが 2 つ以上の異なるロケーションのデータセットを参照している場合、エラーが発生します。この制限の詳細については、クロスリージョン データセット レプリケーションをご覧ください。
  • クエリがデータセットを参照していない場合、Dataform のデフォルトのロケーションは US マルチリージョンです。別の場所を選択するには、デフォルトの場所を設定します。または、クエリで @@location システム変数を使用します。詳細については、ロケーションを指定するをご覧ください。

• assertionSchema: Dataform がアサーション結果を含むビューを作成する BigQuery データセット。デフォルトでは dataform_assertions と呼ばれます。

dataform.json ファイルで定義されたプロパティには、プロジェクト コード内で dataform.projectConfig オブジェクトのプロパティとしてアクセスできます。

スキーマ名を構成する

スキーマ名を構成するには、workflow_settings.yaml ファイルの defaultDataset プロパティと defaultAssertionSchema プロパティ、または dataform.json ファイルの defaultSchema プロパティと assertionSchema プロパティを編集する必要があります。

スキーマの名前を構成する手順は次のとおりです。

workflow_settings.yaml

1. 開発ワークスペースの [ファイル] ペインで、workflow_settings.yaml ファイルをクリックします。

2. defaultDataset、defaultAssertionSchema、またはその両方の値を編集します。

次のコードサンプルは、workflow_settings.yaml ファイルで定義されたカスタム defaultDataset 名を示しています。

  ...
  defaultDataset: mytables
  ...

dataform.json

1. 開発ワークスペースの [ファイル] ペインで、dataform.json ファイルをクリックします。

2. defaultSchema、assertionSchema、またはその両方の値を編集します。

次のコードサンプルは、dataform.json ファイルで定義されたカスタム defaultSchema 名を示しています。

{
  ...
  "defaultSchema": "mytables",
  ...
}

カスタム コンパイル変数を作成する

コンパイル変数には、リリース構成または Dataform API リクエストで、コンパイルのオーバーライドを使用して変更できる値が含まれています。

workflow_settings.yaml でコンパイル変数を定義し、選択したテーブルに追加すると、リリース構成または Dataform API コンパイルのオーバーライドで値を変更するを使用して、テーブルを条件付きで実行できます。

コンパイル変数を使用してテーブルを条件付きで実行する方法については、Dataform のコード ライフサイクルの概要をご覧ください。

リポジトリ全体で使用できるコンパイル変数を作成する手順は次のとおりです。

workflow_settings.yaml

1. Dataform 開発ワークスペースに移動します。
2. [ファイル] ペインで、workflow_settings.yaml ファイルを選択します。

3. 次のコード スニペットを入力します。

   "vars": {
     "VARIABLE":"VALUE"
   }
   

   以下を置き換えます。

   • VARIABLE: 変数の名前
   • VALUE: コンパイル変数のデフォルト値

次のコードサンプルは、workflow_settings.yaml ファイルで myVariableValue に設定された myVariableName コンパイル変数を示しています。

...
vars:
  myVariableName: myVariableValue
...

次のコードサンプルは、executionSetting コンパイル変数が dev に設定された workflow_settings.yaml ファイルを示しています。

defaultProject: default_bigquery_database
defaultLocation: us-west1
defaultDataset: dataform_data,
vars:
executionSetting: dev

dataform.json

1. Dataform 開発ワークスペースに移動します。
2. [ファイル] ペインで、dataform.json ファイルを選択します。

3. 次のコード スニペットを入力します。

   "vars": {
     "VARIABLE":"VALUE"
   }
   

   以下を置き換えます。

   • VARIABLE: 変数の名前
   • VALUE: コンパイル変数のデフォルト値

次のコードサンプルは、dataform.json ファイルで myVariableValue に設定された myVariableName コンパイル変数を示しています。

{
  ...
  "vars": {
    "myVariableName": "myVariableValue"
  },
  ...
}

次のコードサンプルは、executionSetting コンパイル変数が dev に設定された dataform.json ファイルを示しています。

{
"warehouse": "bigquery",
"defaultSchema": "dataform_data",
"defaultDatabase": "default_bigquery_database".
"defaultLocation":"us-west-1",
"vars": {
"executionSetting":"dev"
}
}

コンパイル変数をテーブルに追加する

SQLX テーブル定義ファイルにコンパイル変数を作成する手順は次のとおりです。

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

3. ファイルに、次の形式で when 句を入力します。

   ${when(dataform.projectConfig.vars.VARIABLE === "SET_VALUE", "CONDITION")}
   

   以下を置き換えます。

   • VARIABLE: 変数の名前（例: executionSetting）
   • SET_VALUE: 変数の値（例: staging）
   • CONDITION: テーブルの実行条件

次のコードサンプルは、when 句と、ステージング実行設定でデータの 10% を実行する executionSetting 変数を含むテーブル定義 SQLX ファイルを示しています。

  select
    *
  from ${ref("data")}
  ${when(
    dataform.projectConfig.vars.executionSetting === "staging",
    "where mod(farm_fingerprint(id) / 10) = 0",
  )}

次のコードサンプルは、when 句と myVariableName 変数を含むビュー定義 SQLX ファイルを示しています。

  config { type: "view" }
  SELECT ${when(
    dataform.projectConfig.vars.myVariableName === "myVariableValue",
    "myVariableName is set to myVariableValue!",
    "myVariableName is not set to myVariableValue!"
  )}

ワークフロー設定を workflow_settings.yaml に移行する

ワークフロー設定ファイルと今後の Dataform コア フレームワーク バージョンとの互換性を確保するには、ワークフロー設定を dataform.json ファイルから workflow_settings.yaml ファイルに移行する必要があります。

workflow_settings.yaml ファイルは dataform.json ファイルに代わります。

リポジトリ内の依存関係パッケージが Dataform コアのみの場合、workflow_settings.yaml ファイルは package.json ファイルも置き換えます。package.json ファイルを workflow_settings.yaml ファイルに置き換える方法については、Dataform コアパッケージを管理するをご覧ください。

次の表は、dataform.json ファイルから workflow_settings.yaml ファイルへのワークフロー設定プロパティのマッピングを示しています。

dataform.json のプロパティ	workflow_settings.yaml のプロパティ	説明
assertionSchema	defaultAssertionDataset	必須。アサーションのデフォルトのデータセット。
defaultDatabase	defaultProject	必須。デフォルトのプロジェクト名。 Google Cloud
defaultLocation	defaultLocation	省略可。Dataform がテーブルを作成するデフォルトの BigQuery のロケーション。設定されていない場合、Dataform は SQL クエリが参照するデータセットに基づいてロケーションを決定します。詳細については、ロケーションを指定するをご覧ください。
defaultSchema	defaultDataset	必須。デフォルトのデータセット。
databaseSuffix	projectSuffix	省略可。すべての Google Cloud プロジェクト参照に追加する接尾辞。
schemaSuffix	datasetSuffix	省略可。すべてのアクション データセットに追加する接尾辞。
tablePrefix	namePrefix	省略可。すべてのアクション名の先頭に追加する接頭辞。
vars	vars	省略可。コンパイル中にプロジェクト コードで使用できるユーザー定義変数。key: value ペアのリストを含むオブジェクト。
warehouse	-	dataform.json の場合に必須。bigquery に設定してください。 「workflow_settings.yaml」では利用できません。
-	dataformCoreVersion	「dataform.json」では利用できません。新しいリポジトリでは、デフォルトで workflow_settings.yaml にインストールされます。詳細については、Dataform コアパッケージを管理するをご覧ください。

ワークフロー設定を workflow_settings.yaml に移行する手順は次のとおりです。

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

   Dataform に移動

2. リポジトリを選択し、ワークスペースを選択します。

3. [ファイル] ペインで、[追加] 追加 をクリックし、[ファイルを作成] をクリックします。

4. [ファイルパスを追加] フィールドに「workflow_settings.yaml」と入力します。

5. [ファイルを作成] をクリックします。

6. workflow_settings.yaml ファイルに、dataform.json ファイルの設定を YAML 形式にマッピングして追加します。

7. [ファイル] ペインで、dataform.json の横にある [その他] メニューをクリックし、[削除] をクリックします。

8. dataform.json の削除を確定するには、[削除] をクリックします。

次のコードサンプルは、dataform.json ファイルで定義されたワークフロー設定を示しています。

{
  "warehouse": "bigquery",
  "defaultDatabase": "dataform-demos",
  "defaultLocation": "US",
  "defaultSchema": "dataform",
  "assertionSchema": "dataform_assertions"
  "vars": {
    "environmentName": "development"
  }
}

次のコードサンプルは、workflow_settings.yaml に変換した上記の dataform.json ファイルを示しています。

defaultProject: dataform-demos
defaultLocation: US
defaultDataset: dataform
defaultAssertionDataset: dataform_assertions
vars:
    environmentName: "development"

Dataform コアパッケージを管理する

このセクションでは、Dataform コア フレームワークの依存関係パッケージを管理し、最新バージョンに更新する方法について説明します。

Dataform コアは、SQL、SQLX、JavaScript を使用してワークフローを開発するためのオープンソースの Dataform フレームワークです。ベスト プラクティスとして、利用可能な最新バージョンの Dataform コア フレームワークを常に使用することをおすすめします。Dataform コア フレームワークのリリースについては、GitHub の Dataform リリースをご覧ください。

Dataform コアパッケージの場所を管理する

リポジトリで最初のワークスペースを初期化すると、Dataform は Dataform コアを依存関係パッケージとして自動的に設定します。Dataform コア 3.0.0 以降、Dataform はデフォルトで Dataform コアパッケージを workflow_settings.yaml ファイルにインストールします。以前のバージョンの Dataform コアでは、Dataform コアは package.json ファイルに設定されていました。

Dataform コア 3.0.0 以降では、Dataform コアがリポジトリ内の唯一のパッケージである場合は、workflow_settings.yaml ファイルで設定する必要があります。以前のバージョンの Dataform コアで作成されたリポジトリの場合は、Dataform コアパッケージを workflow_settings.yaml に移動します。

Dataform で追加のパッケージをインストールするには、package.json ファイルが必要です。リポジトリで追加のパッケージを使用している場合は、すべてのパッケージが 1 か所に設定されるように、package.json に Dataform コアパッケージを設定します。リポジトリに package.json ファイルがない場合は、package.json ファイルを作成して Dataform コアパッケージを移動し、追加のパッケージをインストールします。package.json ファイルは、リポジトリのルート ディレクトリに配置する必要があります。

Dataform のコアを workflow_settings.yaml に移動する

3.0.0 より前のバージョンの Dataform コアで作成されたリポジトリで、Dataform コア以外の依存関係パッケージがない場合は、Dataform コアパッケージを package.json ファイルから workflow_settings.yaml ファイルに移動し、冗長な package.json ファイルを削除する必要があります。

Dataform コアパッケージを package.json ファイルから workflow_settings.yaml ファイルに移行するには、次の操作を行います。

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

   Dataform に移動

2. リポジトリを選択し、ワークスペースを選択します。

3. [ファイル] ペインで、workflow_settings.yaml ファイルを選択します。

4. workflow_settings.yaml ファイルに、次の形式で Dataform コアパッケージを追加します。

   dataformCoreVersion: "VERSION"
   
   

   VERSION は、3.0.0 など、最新バージョンの Dataform に置き換えます。

5. [ファイル] ペインで、package.json ファイルの横にある [その他] メニューをクリックし、[削除] をクリックします。

6. dataform.json ファイルの削除を確定するには、[削除] をクリックします。

7. [パッケージをインストール] をクリックします。

Dataform のコアを package.json に移動する

package.json ファイルは、リポジトリに追加のパッケージをインストールするために必要です。リポジトリで追加のパッケージを使用している場合は、Dataform コアパッケージを含むすべてのパッケージを package.json に保存する必要があります。

Dataform コアパッケージが workflow_settings.yaml ファイルに設定されているためにリポジトリに package.json ファイルが含まれていない場合は、追加のパッケージをインストールするために package.json ファイルを作成し、Dataform コアパッケージを workflow_settings.yaml から新しく作成された package.json に移動する必要があります。

package.json ファイルを作成して Dataform コアパッケージを移動する手順は次のとおりです。

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

   Dataform に移動

2. リポジトリを選択し、ワークスペースを選択します。

3. [ファイル] ペインで、[追加] 追加 をクリックし、[ファイルを作成] をクリックします。

4. [ファイルパスを追加] フィールドに「package.json」と入力します。

5. [ファイルを作成] をクリックします。

6. package.json ファイルに、次の形式で Dataform コアパッケージを追加します。

   {
       "dependencies": {
           "@dataform/core": "VERSION"
       }
   }
   

   VERSION は、3.0.0 など、最新バージョンの Dataform に置き換えます。

7. [パッケージをインストール] をクリックします。

8. [ファイル] ペインで、workflow_settings.yaml を選択します。

9. workflow_settings.yaml ファイルで、dataformCoreVersion プロパティを削除します。

Dataform コアを更新する

新しいパッケージ バージョンは、本番環境にデプロイする前に、必ず非本番環境でテストしてください。

Dataform コア依存関係パッケージを更新する手順は次のとおりです。

1. GitHub の Dataform リリースページで、@dataform/core の最新バージョンを確認します。

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

   Dataform に移動

3. リポジトリを選択し、ワークスペースを選択します。

4. [ファイル] ペインで、package.json ファイルまたは workflow_settings.yaml ファイルを選択します。

   Dataform コア依存関係パッケージが設定されている場所は、Dataform コアのバージョンとパッケージの使用状況によって異なります。詳細については、Dataform コアパッケージのロケーションを管理するをご覧ください。

5. Dataform コア依存関係パッケージを最新バージョンに更新します。

   package.json

   {
       "dependencies": {
           "@dataform/core": "VERSION"
       }
   }
   

   VERSION は、3.0.0 など、最新バージョンの Dataform に置き換えます。パッケージのインストールに関する問題を回避するには、Dataform コアパッケージのバージョンを明示的に指定します。package.json ファイルの他の dependencies オプション（>version など）は使用しないでください。

   workflow_settings.yaml

   dataformCoreVersion: "VERSION"
   

   VERSION は、3.0.0 など、最新バージョンの Dataform に置き換えます。

6. [パッケージをインストール] をクリックします。

7. 変更を commit します。

8. リポジトリに変更を push します。

次のコードサンプルは、package.json ファイルで 3.0.0 バージョンに更新された @dataform/core 依存関係を示しています。

{
    "dependencies": {
        "@dataform/core": "3.0.0"
    }
}

コードのバージョン管理を行う

このセクションでは、Dataform でバージョン管理を使用して開発状況を管理する方法について説明します。

Dataform では、リポジトリ内のファイルに加えられた変更を追跡するために Git が使用されます。

Dataform リポジトリでは、Git リポジトリを直接操作します。

接続されたリポジトリでは、リポジトリの接続時に構成したリモート リポジトリのトラッキング ブランチを操作します。

Dataform には、開発ワークスペースの変更のステータスに応じたバージョン管理オプションが表示されます。たとえば、commit されていないローカル変更がワークスペースにある場合にのみ、commit オプションが表示されます。ワークスペース内のファイルがデフォルト ブランチまたはトラッキング ブランチの正確なコピーである場合、Dataform にはワークスペースが最新というステータスが表示されます。

Dataform に表示されるバージョン管理オプションは次のとおりです。

X の変更を commit

ワークスペースまたは選択した変更ファイルのローカル変更の X 番目を commit します。commit されていない変更が表示されます。

デフォルト ブランチに push

commit された変更をデフォルトのブランチに push します。このオプションは、ワークスペースに commit されていない変更がない場合、Dataform リポジトリで使用できます。

your-branch-name に push

commit された変更を your-branch-name に push します。このオプションは、ワークスペースに commit されていない変更がないときに、サードパーティの Git リポジトリに接続されているリポジトリで使用できます。

デフォルト ブランチから pull

デフォルトのブランチからの最近の変更でワークスペースを更新します。 このオプションは、ワークスペースに commit されていないか、push されていない commit された変更がない場合、Dataform リポジトリで使用できます。

your-branch-name から pull

your-branch-name からの最近の変更でワークスペースを更新します。 このオプションは、ワークスペースに commit されていないか、push されていない commit された変更がない場合、サードパーティの Git リポジトリに接続されているリポジトリで使用できます。

前回の commit に戻す

ワークスペース内のファイルを前回の commit の状態に復元します。

変更を pull

開発ワークスペースがリポジトリと同期されていない場合、Dataform に [Pull] オプションが表示されます。リポジトリから開発ワークスペースに変更を pull する手順は次のとおりです。

1. [Dataform] ページで、リポジトリを選択します。
2. [開発ワークスペース] タブで、開発ワークスペースを選択します。
3. 開発ワークスペース ページで、次の操作を行います。
   1. Dataform リポジトリ内の場合は、[デフォルトのブランチから pull] をクリックします。
   2. サードパーティ Git リポジトリに接続されているリポジトリ内の場合は、[your-branch-name から pull] をクリックします。

変更を反映する

開発ワークスペースで変更を加えると、Dataform に [Commit] オプションが表示されます。すべてのローカル変更または選択したファイルを commit できます。

[新規 commit] ダイアログで、commit されていない変更が表示されます。

開発ワークスペースからリポジトリに変更を commit する手順は次のとおりです。

1. [Dataform] ページで、リポジトリを選択します。
2. リポジトリ ページで、開発ワークスペースを選択します。
3. 開発ワークスペース ページで,commit をクリックします。

4. [新しい commit] ペインで次の操作を行います。

   1. [commit メッセージを追加] フィールドに、commit の説明を入力します。

   2. commit する変更ファイルを選択します。

      ファイルを選択しないと、すべてのローカル変更が commit されます。変更ファイルは、ファイルの状態、ファイル名、パスでフィルタできます。

   3. [全ての変更を commit] または [X 変更を commit] をクリックします。

      ボタンの名称は、commit するファイルの選択によって異なります。

変更を push

変更を commit すると、push オプションが表示されます。開発ワークスペースからリポジトリに変更を push する手順は次のとおりです。

1. [Dataform] ページで、リポジトリを選択します。
2. リポジトリ ページで、開発ワークスペースを選択します。
3. 変更を commit します。
4. 開発ワークスペース ページで、次の操作を行います。
   1. Dataform リポジトリ内の場合は、[デフォルトのブランチに push する] をクリックします。
   2. サードパーティの Git リポジトリに接続されているリポジトリ内の場合は、[your-branch-name に push] をクリックします。

commit されていない変更を元に戻す

commit されていない変更を元に戻すには、次の手順に従います。

1. [Dataform] ページで、リポジトリを選択します。
2. リポジトリ ページで、開発ワークスペースを選択します。
3. [ファイル] ペインの上にある [その他] メニューをクリックし、[最後のコミットに戻す] を選択します。

マージの競合を解決する

開発ワークスペースのローカル変更がリポジトリのデフォルトの追跡ブランチに加えられた変更と互換性がない場合、マージの競合が発生することがあります。通常、複数のユーザーが同じファイルを同時に編集している場合に発生します。

通常、別のユーザーが同じブランチに競合する変更を push した後、ブランチから pull すると、マージの競合が発生します。 影響を受けるファイルを編集して、マージの競合を手動で解決する必要があります。

次のコードサンプルは、SQLX ファイルに表示されるマージの競合を示しています。

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

マージの競合を解決する手順は次のとおりです。

1. 開発ワークスペースの [ファイル] ペインで、影響を受けるファイルを選択します。
2. 選択した変更を加えてファイルを編集します。
3. 変更を commit します。
4. 省略可: 変更を push します。

次のステップ

• Dataform プロジェクト設定の詳細については、IProjectConfig リファレンスをご覧ください。
• 追加のパッケージをインストールする方法については、Dataform にパッケージをインストールするをご覧ください。
• テーブルの作成方法については、テーブルを作成するをご覧ください。