注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
はじめに
規模が大きく複雑な Workbook を作成するにつれて、新たな課題に直面することがあります。
- Workbook に新しい変更を加えて試してみたいものの、既存のロジックを維持し、本番パイプラインを壊さないようにする必要があります。
- 同僚と Workbook で共同作業をしたいものの、同じ Workbook を同時に変更する際の競合を避ける必要があります。
ブランチを使用すると、これらの課題を解決できます。このチュートリアルでは、次の概念を探索します。
ブランチを作成する
この例では、タイタニック号の乗客のデータセットを起点に、いくつかのフィルターを適用する短いパイプラインを使用します。
ブランチは Workbook の作業用コピーです。安全に変更を加え、後でマスターバージョンに組み込むことができます。ブランチについて詳しくはこちら。
Workbook の左上にあるブランチメニューをクリックし、新しいブランチの名前を入力して、作成するをクリックします。ブランチ名には、変更の種類に基づく接頭辞（例：feature/ または bugfix/）や、ユーザー名またはイニシャルに基づく接頭辞（例：jdoe/ または jd/）を付けるのが一般的です。
feature/filter-logic が作成されると、トランスフォームにはブランチ作成時のデータとロジックが反映されます。master が変更されても、このブランチ feature/filter-logic はそれまでと同じように動作し続けます。同様に、feature/filter-logic で行った変更は、master のロジックやデータの変更に干渉しません。
新しいブランチで、通常どおり変更を加えます。この例では、絞り込みを行うコードの1行のロジックを変更します。
マージをプレビューする
マージは、このブランチで行った作業のコピーと、マスターコピーの現在の状態を組み合わせたものです。これにより、変更をマスターに組み込む前に確認できます。
このブランチの変更を元のブランチに組み込む準備ができたら、右上のマージをプレビューをクリックします。
マージの状態に移ります。この状態では、組み込まれる変更に納得できるまで、引き続きロジックを変更し、トランスフォームを実行できます。上部の影響を受ける実行ボタンを使用すると、この Workbook 内で影響を受けるすべてのトランスフォーム（ロジックが変更されたものと、その下流にあるすべてのトランスフォーム）をワンクリックで実行できます。
マージ中は、サイドバーに、このマージによって生じる行数や列の変更が表示されます。これにより、実際に編集したトランスフォームと下流のトランスフォームの両方で、このブランチによって生じた変更を把握しやすくなります。
このマージによって組み込まれるロジックの変更を確認するには、変更されたトランスフォームを選択し、変更を表示をクリックします。変更されたロジックが分割画面で表示されます。
以下に示すように、テンプレートでも同じように確認できます。
マージを完了する
組み込む変更に納得できたら、ブランチをマージをクリックして master ブランチへのマージを完了します。2つのトグルがあるダイアログボックスが表示されます。
1つ目のトグルでは、マージ元のブランチのトランザクションをマージ先のブランチにコピーするかどうかを選択できます。ブランチの作成後、マスターで追加の作業が行われ、派生データセットの master ブランチに新しいトランザクションがコミットされた場合を考えてみます。このトグルを true に設定すると、feature/filter-logic ブランチの作成後にマスターで作成されたトランザクションは、マージ後にデータセットに表示されなくなります。
2つ目のトグルでは、マージ元のブランチをデータセットから削除するかどうかを選択できます。これは Workbook のブランチ自体の削除とは異なる点に注意してください。Workbook のブランチ自体はマージ時に必ず削除され、この動作は設定できません。2つ目のトグルが true の場合、マージ元のブランチは Workbook で作成された派生データセットから削除されます。
上記のように、マージ元のブランチのデータを master にコピーしないことを選択したとします。master にマージをクリックすると、master ブランチがマージのロジックで更新されます。
マージ競合を解決する
ブランチを使用する頻度が増えるにつれて、特に同僚と共同作業をしている場合には、2つの異なるブランチで同じ部分のロジックを変更することがあります。このセクションでは、その場合に何が起こるかを説明します。
マージをプレビューをクリックしたときに、競合する変更がすでに master に組み込まれている場合は、マージを進める前に競合を解決する必要があることを示すプロンプトが表示されます。
競合しているトランスフォームをクリックすると、マージ競合の表示に切り替わります。コードの場合は、インラインの競合マーカーで、使用するロジックを選択できます。
競合にテンプレートが関係している場合や、いずれかのブランチでトランスフォームが削除されている場合は、分割画面を使用して競合を解決できます。
競合を解決した後も、引き続き編集を行い、トランスフォームを実行して、マージしたロジックが期待されるとおりに動作することを確認できます。準備ができたら、マージを完了をクリックして、通常どおりマージを完了します。