注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

Object Storage V1 (Phonograph) から Object Storage V2 への移行

Object Storage V2 (OSv2) の改善点に必要なアーキテクチャの変更には、Object Storage V1 (Phonograph) から Object Storage V2 (OSv2) へのオブジェクトタイプおよび多対多リンクタイプの移行が必要です。

移行は現在必須ではありませんが、推奨されています。Foundry の Ontology Manager は、オブジェクトタイプおよび多対多リンクタイプのダウンタイムゼロの移行のための統合フレームワークを提供します。

Foundry オントロジーは、すべてのオブジェクトタイプおよび多対多リンクタイプを一度に移行する必要はありません。Object Storage V1 (Phonograph) にある一部のオブジェクトタイプと Object Storage V2 (OSv2) にある一部のオブジェクトタイプが混在した状態でも通常の運用を継続できます。Foundry の Ontology Manager では、オントロジータイプを一括で移行することもサポートしています。

移行を実行する前の考慮事項

移行の動作

オブジェクトタイプに対するオントロジー定義の変更が Funnel 置換パイプラインを引き起こす場合、進行中の移行は中止されます。これを避けるため、オブジェクトタイプのスキーマが移行全体（浸透期間を含む）で安定していることを確認し、移行を開始する前にスキーマ変更を行ってください。
Object Storage V1 (Phonograph) の登録は、Ontology Manager に保存された変更に対して同期的に更新されます。しかし、Funnel はオントロジー定義の変更を非同期に記録するため、Ontology Manager にオントロジー変更を保存してからその変更が Funnel によって検出されるまでに遅延が生じます。このため、start や abort といった移行イベントは、オントロジーが保存された数秒後に Ontology Manager に表示されることがあります。
Object Storage V1 (Phonograph) は、Object Storage V1 (Phonograph) 編集 API を通じてオブジェクトおよびリンクタイプを直接編集することをサポートしています。このやり取りは廃止されており、OSv2 とは互換性がありません。ユーザーによる編集があるオブジェクトタイプの移行を開始する前に、使用法が互換性があることを確認してください。その後、Ontology Manager でそのオブジェクトタイプを見つけ、Datasources タブに移動します。Only allow edits via actions をオンに切り替えて、そのオブジェクトタイプの移行を解除します。
ユーザーによる編集は、移行定義の瞬間から移行全体（浸透期間を含む）にわたって自動的に無効化されます。移行プロセス中に新しいユーザー編集は投稿できませんが、オブジェクトの読み取りは中断なくアクセス可能です。
オブジェクトタイプの編集履歴と属性は移行中に保存されません。Object Storage V1 (Phonograph) の各オブジェクトインスタンスの最新の状態が Object Storage V2 に移行されます。編集履歴と属性をキャプチャするために Action Log オブジェクトタイプを使用していなかった場合は、追加のサポートについて Palantir の担当者に連絡してください。

互換性のない使用法

互換性のない使用法 ビューにアクセスできない場合は、この機能の有効化について Palantir の担当者にお問い合わせください。

Object Storage V2 での特定のやり取りは破壊的変更と見なされ、Object Storage V2 と互換性がありません。この互換性のない使用法は Ontology Manager で追跡され、報告されます。Incompatible usage アラートを選択すると、過去30日間の互換性のない使用法の視覚化が提供され、対処を支援します。

OSv1 to OSv2 migration incompatible usage visualization

非ブロッキングな互換性のない使用法

Object Storage V1 (Phonograph) エンドポイントへの直接 API コールなど、いくつかの互換性のない使用法は、OSv2 への移行の開始をブロックしませんが、オブジェクトタイプが OSv2 に移行された後に失敗します。

OSv1 to OSv2 migration warning

互換性のない使用法を調査し、アクションが必要かどうかを判断する必要があります。たとえば、オブジェクトクエリ/リードのために Object Storage V1 (Phonograph) コールを Object Set Service に移行する、オブジェクト編集のために Actions を使用する、オブジェクトタイプメタデータ情報のために Ontology Metadata Service を使用するなどです。これらの互換性のない使用法がもはや関連性がないか、影響なしに壊れる場合は、対策せずに移行を開始できます。

ブロッキングな互換性のない使用法

OSv1 と OSv2 の間の他の変更、たとえばアクションのみによる編集の有効化などは、Ontology Manager で移行を積極的にブロックします。

OSv1 to OSv2 migration error

この場合、移行を開始する前に互換性のない使用法の発生をすべて削除する必要があります。

互換性のない使用法がない場合

互換性のない使用法や破壊的変更がないオブジェクトタイプには、移行の準備が整っていることを示す緑色のチェックアイコンがバナーに表示されます。

OSv1 to OSv2 migration ready

エンティティの移行

移行の開始

移行を開始するには、オブジェクトタイプまたは結合テーブルを持つ多対多リンクタイプの Datasources タブに移動し、Indexing Metadata セクションに進みます。オブジェクトタイプが移行対象である場合、Object Storage V2 ラジオボタンを選択でき、移行パラメーターを選択するためのウィザードが開きます。このセクションが存在しない場合、ユーザーが作業しているオントロジーはすべてのオブジェクトタイプおよび結合テーブルリンクタイプに対して Object Storage V2 が強制されている可能性が高いです。

Ontology Metadata Service は Object Storage V1 (Phonograph) を利用したオブジェクトタイプの互換性のない使用法を追跡し、互換性のない使用法があるオブジェクトタイプの移行を試みるとアラートをトリガーします。また、オブジェクトタイプのスキーマに破壊的変更が含まれていないことを確認する必要があります。

OSv1 to OSv2 migration landing page

トランジションウィンドウ

トランジションウィンドウ オプションを使用すると、安全な移行のための好ましい時間枠を設定できます。たとえば、オブジェクトタイプの使用ケースが最小限の活動を持つ曜日と時間を設定することができます。移行プロセスが開始されると、最初の Funnel パイプラインを開始するまでに最大30分かかる場合があります。移行が最初のトランジションウィンドウ内に完了できない場合、Object Set Service は次のウィンドウまで待機して OSv2 からデータを読み取り始めます。

トランジションウィンドウが設定されていない場合、最初の Funnel パイプラインが成功した時点で移行が開始されます。

OSv1 to OSv2 migration transition window

最初の OSv2 への同期が正常に完了した後にトランジションウィンドウが計算されます。これにより、最初の同期が設定されたトランジションウィンドウの途中で完了した場合、移行はこれを受け入れ可能なトランジションウィンドウと見なさず、次のウィンドウを試みます。

浸透期間

移行プロセス中に Object Storage V1 (Phonograph) に戻す必要がある場合、浸透期間中にダウンタイムなしでこれが可能です。移行フレームワークは、浸透期間の終了まで Object Storage V1 (Phonograph) インデックスを最新の状態に保ちながら、Object Storage V2 (OSv2) と同期します。浸透期間は、最大14日までの日単位で設定でき、移行がトランジションウィンドウを通過した後にのみ開始されます。

浸透期間中、Foundry オントロジーバックエンドはすべてのクエリを自動的に OSv2 にルーティングし、OSv1 への要求は拒否されます。この期間は、移行後にワークフローが期待通りに機能していることを確認するために使用できます。浸透期間中に問題が発生した場合は、移行を中止して OSv1 インデックスの使用にすぐに切り替えることができます。

浸透期間を0日に設定すると、OSv2 インデックスが準備完了し、トランジションウィンドウがアクティブ化され次第、そのオブジェクトタイプの OSv1 インデックスが削除されます。浸透期間終了後に OSv1 に戻すには、データの再インデックス化が必要で、ダウンタイムが発生する可能性があります。

オブジェクトタイプは浸透期間中に OSv1 と OSv2 で二重にインデックスされます。これにより、追加のコンピュートおよびストレージ使用量が発生します。追加のリソース使用量を避けたい場合は、移行を設定する際に浸透期間を0日に設定できます。

OSv1 to OSv2 migration soak period

書き戻しデータセットの移行

Object Storage V1 (Phonograph) では、オブジェクトタイプまたは結合テーブルを持つ多対多リンクタイプに対するユーザー編集を有効にするために書き戻しデータセットが必要です。Object Storage V2 は書き戻しデータセットを実体化データセットに置き換えます。Object Storage V2 では、ユーザー編集を有効にするために実体化データセットは必要ありません。OSv2 ではオプションの実体化データセットを使用でき、下流での使用が必要な場合にのみ実体化を作成する必要があります。

オブジェクトおよびリンクタイプの書き戻しデータセットは、OSv2 で実体化データセットとして移行できます。実体化データセットは同じ列を保持し、既存の下流パイプラインとの互換性を維持します。この切り替えは、現在の書き戻しデータセットを他のアプリケーションで使用している場合にのみ関連します。ユーザー編集は引き続き OSv2 に移行されます。

書き戻しデータセットを移行しない場合、そのデータセットは削除されません。代わりに、データセットは静的になり、最後のビルド時間のデータを含みます。

書き戻しデータセットにオブジェクトタイププロパティにマッピングされていない列が含まれている場合、それらの列は移行の一部として削除されます。

Writeback dataset migration option

移行の中止

Object Storage V2 に切り替えた後にパフォーマンスの低下やバグが発生した場合、浸透期間中に進行中の移行を安全に中止し、OSv1 に戻すことができます。移行フレームワークは、移行プロセス全体を通じて新しいデータで OSv1 インデックスを最新の状態に保ち、ダウンタイムは発生しません。

移行中のオブジェクトタイプに既存のユーザー編集がある場合、新しいユーザー編集は移行が完了するまで無効になります。

同期の失敗

移行プロセス中にオブジェクトタイプの同期が失敗することがあります。この場合、Datasources タブの Indexing Metadata セクションに PIPELINE_FAILED エラーが表示されます。その場合は、funnel バッチパイプラインのデバッグの手順に従って問題を調査し、修正してください。

OSv1 to OSv2 migration failure

一括移行

左側のナビゲーションバーの Object types セクションに移動し、複数のオブジェクトタイプを同時に選択することで、同じトランジションウィンドウおよび浸透期間の設定を使用して一括移行を実行できます。プロセスおよび設定ウィザードは、単一のオブジェクトタイプを移行する場合と同じです。予期しない複雑さやエラーを防ぐために、1回の一括移行で100個未満のエンティティを移行することをお勧めします。

このウィザードは、OSv2 のみが有効なオントロジーにはインターフェースに表示されません。

OSv1 to OSv2 bulk migration