注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
ソフトウェア開発者は通常、バージョン管理システムを使ってコードベースでの作業を調整します。これにより、複数のエンジニアが同じコードに安全に変更を加えられます。
Palantir プラットフォームでは、ソフトウェア開発者がコードを扱うのと同じように、データと変更管理を考えることができます。つまり、多くのユーザーがほかのユーザーの作業を妨げずに、同じデータに変更を加えたり、操作したりするための方法が必要です。Global Branching は、バージョン管理システムで一般的なブランチという機能を活用し、ソフトウェア開発のベストプラクティスを Palantir プラットフォームに適用します。
大まかに言うと、ブランチを使うことで、既存の環境を分岐させ、独立したブランチ内でエンドツーエンドのワークフローのコンポーネントを操作できます。変更内容に問題がなければ、このブランチで加えた変更を main ブランチにマージできます。
グローバルブランチは、Foundry アプリケーション内、または Global Branching アプリケーションで直接作成できます。次の図は、ブランチのワークフローを使って Palantir プラットフォームのリソースを変更する方法を示しています。

Foundry アプリケーションのブランチセレクターから、または Global Branching アプリケーションでブランチを作成できます。

オントロジー、組織、スペースがブランチの作成にどう関係するかについては、ブランチのセキュリティのドキュメントを参照してください。
既存のグローバルブランチにアクセスするには、対応しているアプリケーションのブランチセレクターでそのブランチを選択します。Global Branching アプリケーションのブランチタブから既存のブランチを探して移動することもできます。

対応しているアプリケーションでグローバルブランチを操作している間は、ブランチタスクバーが表示されます。

ブランチ内では、main ブランチに影響を与えずに Foundry リソースを変更できます。ただし、ブランチで Foundry リソースを作成または削除すると、main に影響します。これはオントロジーリソースには当てはまりません。オントロジーリソースでは、main ブランチに影響を与えずに、ブランチ上でエンティティを作成、変更、削除できます。
リソースの変更をはじめるにあたり、事前にリソースをこのブランチに追加する必要があるアプリケーションもあれば、最初の変更を保存した後に自動的に追加されるアプリケーションもあります。事前の追加が必要な場合は、ブランチを選択すると追加を求めるダイアログが表示されます。

main ブランチからの更新このブランチでリソースを変更している間に、main ブランチでも同じリソースが更新されることがあります。これらの更新を取り込むには、このブランチをリベースします。つまり、main の変更をこのブランチにマージし、その上に以前保存したブランチの変更を再適用します。

ブランチからリソースを外すと、その状態は main ブランチ上のリソースのバージョンに戻ります。Global Branching アプリケーションまたはブランチタスクバーから、ブランチのリソースを直接外すことができます。

リソースを外すと、ブランチの状態が破損する可能性があります。そのため、リソースのリネージを確認し、ブランチ内のほかのリソースがその変更に依存していないことを確認することが重要です。
ブランチの状態に問題がなければ、提案を作成して変更のレビューをはじめ、最終的に main ブランチにマージします。はじめるには、Global Branching アプリケーションで提案の作成を選択するか、ブランチタスクバーで同じ選択肢を選択します。提案を作成するには、ブランチの所有者ロールまたはスペースの管理者権限が必要です。ブランチのロールと権限の詳細については、ブランチのセキュリティのドキュメントを参照してください。提案には説明項目があり、変更のレビューに必要な情報を入力できます。この項目は Markdown テキストに対応しています。

提案ページまたはブランチタスクバーでは、チェックを使ってリソースのマージ準備状況を確認し、リソースごとの承認ポリシーを表示できます。

提案を作成すると、提案をマージできるかどうかを判断するために、リソースごとにチェックが実行されます。
チェックでは、main ブランチと現在のブランチの競合や必要な承認など、リソースのマージを妨げる可能性のある問題が表示されます。提案をマージするには、ブランチ内のリソースに対するすべてのチェックに合格する必要があります。
ブランチをマージ可能な状態にするには、ブランチ内のすべてのリソースが main ブランチの最新バージョンとマージ可能である必要があります。リソースが main より古い状態である場合や、競合なくマージできない場合は、リベースのチェックに失敗します。ブランチ内のリソースをリベースするために、適切なアプリケーションにリダイレクトされます。ブランチ内のリソースと main 上のリソースの間に競合がある場合は、リベースのチェックに合格するために、それらの競合を解決する必要があります。
アプリケーションごとのリベースの実装方法に関するドキュメントについては、統合ページを参照してください。
Global Branching は、リベース中に競合のない変更をすべて自動的に解決します。実際に競合している場合、つまり同じリソースの同じプロパティが main とこのブランチの両方で編集されている場合は、自動では解決されません。リベースを続行するには、いずれかのバージョンを手動で選択する必要があります。

このブランチをマージするには、すべての承認ポリシーを満たす必要があります。保護されていないリソースでも、編集レベルの権限を持つユーザーによる承認が必要ですが、変更を加えたユーザーがポリシーを満たしている場合は、自動的に承認されることがあります。保護されたリソースには、リソースの保護と承認ポリシーで定義された必須のレビュー担当者によるレビューが必要です。
承認待ちと表示されているリソースごとに、承認ステータスを選択して、関連する承認ポリシーと承認資格のあるレビュー担当者を表示します。

Code Repositories および Pipeline Builder のパイプラインでは、承認ポリシーはリソース内で定義されます。
資格のあるレビュー担当者は、提案の変更タブまたはリソースのアプリケーションでリソースをレビューできます。提案ページでリソースのレビューを選択するか、ブランチタスクバーまたは提案ページのリソースメニューにあるリンクを使います。どちらの方法でも、リソースの種類に応じて、提案内でのレビューに対応している場合は変更タブが開き、それ以外の場合はリソースのアプリケーションが開きます。

レビュー中にいずれかのユーザーが1回でも拒否すると、そのリソースの変更は拒否済みになります。これにより、 提案全体をマージできなくなります。提案をマージするには、拒否したユーザーが変更を再度レビューし、承認する 必要があります。
変更が承認され、すべてのチェックに合格すると、ブランチタスクバーまたは Global Branching アプリケーションで提案をマージを選択して、提案を main ブランチにマージできます。マージ権限については、ブランチのセキュリティに関するドキュメントで説明しています。
提案をマージするときに、ブランチ上で直接変更されていないリソースも含め、影響を受けるリソースのビルドをトリガーできます。ビルドには3つのオプションがあります。

必要に応じて、変更されたリソースをマージ時のビルドから除外できます。除外するリソースの選択を保存すると、影響を受けるリソースのプレビューが更新されます。影響を受けるリソースとは、選択された変更済みリソースのペアの間にあると算出されたトランスフォームです。リソースを除外しても、マージ時のビルドから除かれるだけで、そのリソースの変更はマージされます。

マージが部分的に失敗した場合、提案ページには、マージに成功したリソースと、マージに失敗してブランチ上に残っているリソースが表示されます。現在、部分的に失敗したマージを元に戻すことはできません。表示されたエラーを解決し、提案のマージを再試行する必要があります。

ブランチを作成すると、ステータスはアクティブに設定されます。その後、ブランチは非アクティブ、アーカイブ済み、マージ済みのいずれかの状態に移行できます。利用可能な4つのブランチの状態は、次のように定義されています。
アクティブ: 作業中、またはマージ処理中のブランチです。アクティブなブランチ上でビルドまたはインデックス化されたデータは、ブランチがアクティブな間は保持されます。
非アクティブ: アクティビティがない状態が設定可能な期間続いた後、自動的に非アクティブとしてマークされるブランチです。この状態では、オントロジーリソースのインデックス化が解除され、指定された日数が経過するとデータが削除されます。非アクティブなブランチ上のリソースのビルドは、直ちに失敗します。ブランチが非アクティブとしてマークされると、ブランチの所有者にメール通知とプラットフォーム内の通知の両方が送信されます。


アーカイブ済み: 作業が行われなくなったブランチです。アーカイブは常に手動で行います。ブランチの所有者には、メール通知とプラットフォーム内の通知の両方が送信されます。アーカイブ済みブランチでのインデックス化の解除、ビルドの失敗、データの削除は、非アクティブなブランチと同じように行われます。以前に変更されたリソースなどのメタデータは保持され、アーカイブ済みブランチは復元できます。アーカイブ済みブランチはブランチセレクターに表示されませんが、Global Branching アプリケーションで開いて復元できます。

マージ済み: 提案がマージされたブランチです。マージ済みブランチは最終状態であり、復元できず、ブランチセレクターにも表示されません。アクセスできるのは Global Branching アプリケーションからのみです。
ブランチが非アクティブになるのを防ぐには、ブランチの詳細パネルのブランチ設定セクションで、ブランチをアクティブに保つオプションを有効にします。ブランチはアクティブな状態を維持し、その後のインデックス化の解除やデータ削除の対象にはなりません。アクティブなブランチは、非アクティブなブランチと比べて、時間の経過とともにコストが増加します。

ブランチが非アクティブまたはアーカイブ済みだった場合、そのブランチ上のリソースでは、オントロジーエンティティのインデックス化の解除や、ロジックとデータの削除が行われている可能性があります。その後ブランチをアクティブ化または復元した場合、削除されたデータやインデックス化が解除されたデータを復旧するため、次の操作が必要になることがあります。
提案は、次の3つの状態のいずれかになります。
main ブランチにマージされた提案です。