注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
このガイドでは、OData API を使用するように SAP SLT レプリケーション同期を設定する方法と、既存の同期をレガシーの ODP API から OData に移行する方法を説明します。SAP SLT ソースと、SLT レプリケーションに使用する SAP(カスタムソース)コネクターの両方について、バッチ同期とストリーミング同期を取り上げます。
SAP SLT 同期は、SLT Replication Server の Operational Delta Queue (ODQ) から変更データを読み取ります。Foundry は、Palantir Foundry Connector 2.0 for SAP Applications(以下「コネクター」)の次の2つの API のいずれかを介して ODQ にアクセスできます。
PALODATA コンポーネントがこの API を提供します。SAP Note 3255746 ↗ に記載されているとおり、SAP は ODP-RFC API へのアクセスを制限しています。顧客のアプリケーションおよびサードパーティアプリケーションによる ODP Data Replication API の RFC モジュールの使用は、許可されなくなりました。SAP が公開している ODP に関するよくある質問では、SAP のセキュリティパッチが未承認の ODP-RFC 呼び出しを拒否すると説明されています。このパッチが SAP システムに適用されると、引き続き ODP API を使用している SLT 同期は失敗します。各システムへのパッチ適用時期を SAP ベーシスコンポーネント担当チームに確認し、それまでに移行してください。
このガイドは、SLT レプリケーション同期にのみ適用されます。
SAP SLT ソースのローカルテーブル同期、およびその他の SAP オブジェクトタイプ(ERP テーブル、InfoProvider、エクストラクターなど)では、このガイドで説明する API の選択は使用しません。上記に記載されていないオブジェクトタイプについては、Palantir サポートにお問い合わせください。
既存の同期は、そのまま移行されます。同期のソースと出力データセットまたはストリームは保持されます。
同期を移行する前に、次の差異を確認してください。
OData API には、SAP システム側と Foundry 側に要件があります。OData を使用するように同期を設定する前に、表に記載された4つの要件グループをすべて満たす必要があります。
| ソースと同期の種類 | SAP の前提条件 | Foundry コネクター | Foundry ユーザーインターフェース |
|---|---|---|---|
| SAP SLT ソース、バッチ同期 | SAP 共通の前提条件 | 対応 | バッチ同期エディターのAPI バージョンカードとキュー登録のリセットカード。任意のプロパティであるインクリメンタル状態のリセット。 |
| SAP SLT ソース、ストリーミング同期 | SAP 共通の前提条件 | 対応 | ストリーミング同期エディターのAPI バージョンカード、キュー登録のリセットカード、およびスナップショットを強制設定。 |
| SAP (Custom source)、SLT オブジェクトタイプを使用するバッチ同期 | SAP 共通の前提条件 | レガシー SLT バッチ同期で OData に対応したコネクターリリースが必要です | バッチ同期エディターのAPI バージョンカード。任意のプロパティであるインクリメンタル状態のリセット。キュー登録のリセットは利用できません。 |
| SAP (Custom source)、ストリーミング同期 | SAP 共通の前提条件に加えて、SLT 接続タイプが明示的に指定されたソース | 対応 | ストリーミング同期エディターのAPI バージョンカード、キュー登録のリセットカード、およびスナップショットを強制設定。 |
次の SAP 側の要件は、4種類すべてのソースと同期の組み合わせに適用されます。これらは SAP アドオンのバージョンに関する要件であり、上の表に記載された Foundry コネクターの要件とは別のものです。
PALANTIR および PALCONN コンポーネントは SP34 以降である必要があります。最新の OData 機能を利用するため、移行前に SP39 Fix Pack 4 以降にアップグレードすることを推奨します。PALODATA コンポーネントがインストールされていること。SLT 用コネクターのインストールについて詳しくはこちら。SICF サービスがアクティブであること。SAP ベーシスコンポーネント担当チームに、SLT Replication Server にインストールされているコンポーネントのバージョンの確認を依頼してください。
SAP_BASIS:リリースが 750 で、サポートパッケージが SAPK-75009INSAPBASIS 以降であること、またはそれより上位のリリースであること。PALANTIR および PALCONN:サポートパッケージレベルが SP34 以降であること。SP39 Fix Pack 4 以降を推奨します。PALODATA:一覧に存在すること。Foundry もコネクターのバージョンを確認します。アドオンが OData をサポートできないと Foundry が判断した場合、API バージョンカードの OData の選択肢に次のいずれかのメッセージが表示されます。
Foundry コネクターとユーザーインターフェースの更新は Palantir が提供するため、管理が必要なバージョン番号はありません。特定の同期タイプについて、Foundry 環境が OData をサポートしているか確認するには、そのタイプの既存の同期を開くか、新しい同期の作成を開始します。次に、互換性の表に記載されているコントロールがあるかを確認します。
SLT 同期で API バージョンカードが表示されない場合、そのエンロールメントでは、その同期タイプの OData 選択はまだ利用できません。ほかの方法で OData を設定しようとしないでください。ソースタイプ、同期タイプ、SAP コンポーネントのバージョンを添えて、Palantir サポートにお問い合わせください。
OData を使用するバッチ SLT 同期は、Foundry の標準のトランザクションタイプに従います。
APPEND 同期を SNAPSHOT に変更しても、インクリメンタル設定を保持している場合、SAP は引き続き前回の実行以降の変更のみを送信します。その後、SNAPSHOT トランザクションによってデータセット全体がその変更で置き換えられるため、データセットが不完全または空になる可能性があります。テーブル全体をフルロードするには、インクリメンタル状態のリセットを有効にします。これにより、フルロードのために同期が自動的に SNAPSHOT に切り替わります。インクリメンタル状態のリセットを無効にすると、トランザクションタイプは APPEND に戻ります。
pointer に設定します。OData 同期は、ほかの増分フィールドをサポートしていません。maxRowsPerSync(SAP(カスタムソース)のアドバンスドタブ)を設定し、大規模な初回ロードを複数回の実行に分割します。複数回の実行に分割する初回ロードを参照してください。SAP の ODQ がデルタリクエストを保持する期間には制限があります。インクリメンタル OData 同期の実行間隔が ODQ の保持期間より長い場合、デルタポインターが失われ、同期が失敗する可能性があります。インクリメンタル同期は、ODQ の保持期間より短い間隔で実行するようにスケジュールしてください。保持期間のデフォルトは24時間です。詳細は、SAP Note 2888122「ソースシステムの最新のデルタリクエストが削除されると ODATA ODP デルタを実行できない」を参照してください。
既存のバッチ同期を移行しても、ソース、出力データセット、およびトランザクションタイプは保持されます。
この手順は、トランザクションタイプが APPEND の既存のバッチ同期に使用します。OData を介してテーブルを1回フルロードした後、インクリメンタル取り込みを再開します。
pointer のままであること。インクリメンタル設定は削除しないでください。フルロード後に購読を保持するために、この設定が必要です。ODQMON でテーブルのレガシー ODP 購読を確認するよう依頼します。コネクターは、その購読から読み込まなくなっています。未使用の購読を終了しても、削除されるのはキューと購読のデータのみであり、SAP 業務テーブルのデータは削除されません。ほかのコンシューマーに属する購読は終了しないでください。SLT 購読のハウスキーピングについては、詳しくはこちらを参照してください。インクリメンタル状態のリセットをオンのままにしないでください。オンになっている間は、実行のたびに SAP で新たな完全な初回読み込みが強制的に行われ、データセットが置き換えられます。
このセクションは、インクリメンタルバッチ同期の移行手順を含むインクリメンタル同期に適用されます。以下では、この手順のステップを参照します。インクリメンタル同期で同期あたりの最大行数(または maxRowsPerSync)を使用している場合、初回読み込みのデータは複数回の実行に分けて配信されます。
SAP(カスタムソース)のバッチ同期は、OData を選択する前に次の要件を満たしている必要があります。要件を満たしていない場合、該当する設定名を示すエラーが発生し、実行が失敗します。
pointer である必要があります。useKernelJsonSerialization: true を追加します。これにより、転送用のページのエンコード方法が変わりますが、抽出される行は変わりません。timestamp、resourceCheck、および debug の設定は、true、false、ON、または OFF である必要があります。filter、incrementalType、initialIncrementalValue、twinTable、twinMap、twinJoinConfigItems、incrementalSubTypes、incrementalComparator、trace、および continuousResourceCheck。BEx、関数、または TSV 固有の設定など、ほかのオブジェクトタイプにのみ適用される設定も削除する必要があります。同期が filter を使用している場合、それを削除すると抽出される行が変わります。OData API がサポートする同等のフィルターを用意するまで、その同期を移行しないでください。フィルターの記述についてサポートが必要な場合は、Palantir サポートにお問い合わせください。
OData 同期では、並列ページングのスレッド数設定は無視されます。
ストリーミング同期は、SNAPSHOT および APPEND トランザクションタイプを使用しません。ストリーミング同期は、ストリームによって識別される独自の SAP 購読を保持し、ストリームの実行中にその購読をポーリングして変更を取得します。ストリームの開始方法を制御するには、スナップショットの強制を使用します。
| 状況 | スナップショットを強制 |
|---|---|
| 新しいストリームで、対象のテーブルと SAP ユーザーに対するほかの OData 購読がない場合 | Off |
| ODP から OData に移行する既存のストリーム | 移行後の初回起動時は On、その後は Off |
| SLT トリガーがリセットされた場合、またはストリームの SLT ポインターが失われた場合 | 1回の起動で On、その後は Off |
| 別の同期が、対象のテーブルと SAP ユーザーに対する OData 購読をすでに保持している場合 | ストリームを起動する前に、SAP で購読の競合を解決します |
ストリーミング同期では、キュー登録のリセットをオフのままにしてください。この設定がリセットするのは、ストリーム自体の OData 購読のみであり、これはスナップショットの強制によってすでに行われます。別の同期が保持する購読を引き継ぐことはできません。ストリームの実行中、この設定は1回だけではなくポーリングリクエストごとに送信されるため、ストリームが繰り返し再初期化され、テーブル全体が再送信されることがあります。
初期ロードを受信したら、スナップショットの強制をオフにしてください。オンのままにすると、ストリームが再起動するたびにテーブル全体がフルロードされます。
以下の設定によって、ストリーミング同期が SAP に接続する方法が決まります。SLT コンテキストはソースで設定し、それ以外のすべての設定はストリーミング同期エディターで行います。
| 設定 | SAP SLT ソース | SAP (Custom source) | OData の値 |
|---|---|---|---|
| SLT コンテキスト | ソースのリモートコンテキスト。形式は SLT~<Alias_Name> です | ソース YAML の connectionType.slt.context | SLT キューのエイリアスです。移行による変更はありません。 |
| テーブル名 | ストリーミング同期エディター | ストリーミング同期エディター | 移行による変更はありません。 |
| API バージョン | ストリーミング同期エディター | ストリーミング同期エディター | OData |
| スナップショットを強制 | ストリーミング同期エディター | ストリーミング同期エディター | 移行後の初回起動時のみ On にします。移行の段階を参照してください。 |
| キュー登録のリセット | ストリーミング同期エディター | ストリーミング同期エディター | Off。ストリーミング同期を参照してください。 |
| ポーリング間隔とバッチサイズ | ストリーミング同期エディター | ストリーミング同期エディター | 移行による変更はありません。 |
SAP (Custom source) のストリーミング同期には、SLT 接続タイプが明示的に設定されたソースが必要です。ソース設定を開き、YAML に以下のような connectionType ブロックが含まれていることを確認します。ここで、<context> は SLT キューのエイリアスです。
Copied!1 2 3 4 5 6 7type: magritte-sap-source url: https://<host>:<port>/sap/palantir usernamePassword: <username>:{{password}} connectionType: type: slt slt: context: <context>
このブロックがない場合は、ストリームを作成または移行する前に、ストリーミング同期を有効にするの説明に従って追加します。このソースのすべてのストリーミング同期は、このコンテキストを使用します。OData 用にこれ以外のソース設定は必要ありません。
この手順では、ソースと出力ストリームを維持したまま、既存の SAP SLT または SAP (Custom source) のストリーミング同期を OData に切り替えます。ストリームを移行すると、既存のストリームにテーブル全体が再送信されるため、開始前にリプレイを計画してください。
移行中は、ストリームを以下の段階に沿って進めます。このテーブルを使用して、各段階の設定を確認します。
| 段階 | ストリーム | API バージョン | スナップショットを強制 | キュー登録のリセット |
|---|---|---|---|---|
| 移行前 | 実行中 | ODP | Off | 利用不可 |
| 再設定(ステップ 2–6) | 停止中 | OData | On | Off |
| 初回読み込みのリプレイ(ステップ 7–8) | 実行中 | OData | On | Off |
| 定常状態(ステップ 9以降) | 実行中 | OData | Off | Off |
ストリームは、ODP チェックポイントを OData に引き継ぎません。スナップショットの強制をオンにして最初に開始したとき、ストリームは OData 購読を通じて新しい初期ロードを要求します。その後、スナップショットの強制をオフにして開始した場合は、SAP がストリーム用に保持している OData デルタポインターから再開します。
/PALANTIR/TIMESTAMP 列に基づいて重複を削除します。ODQMON でそのテーブルのレガシー ODP 購読を確認するよう SAP ベーシスコンポーネントチームに依頼します。OData API では、SAP ユーザーごとに各テーブルに対して1つのアクティブな購読が許可されます。同じ SAP ユーザーを使用する別の同期が、テーブルの OData 購読をすでに保持している場合、競合が発生します。一般的な原因は次のとおりです。
エラーメッセージには、購読を保持している同期のインクリメンタル ID、最終実行日、作成者が含まれます。これらの詳細を使用して、購読を所有する同期を特定します。
キュー登録のリセットでは競合は解消されません。この設定では、現在の同期自身の購読のみがリセットされます。別の同期が購読を保持している場合、実行は You cannot reset this sync, an active sync is already configured for this table というエラーで失敗します。
競合を解消するには、次のいずれかの方法を選択します。
ODQMON で該当するテーブルと SAP ユーザーの競合する OData 購読を終了します。これにより削除されるのは購読のみで、SAP 業務テーブルのデータは削除されません。購読を保持していた同期は、インクリメンタルに継続できなくなります。その同期が引き続き必要な場合は、新たな初期読み込みが必要になり、競合が再発するため、代わりに一方の同期で別の SAP ユーザーを使用します。API バージョンカードに、アドオンが 2.34 (SP34) より古いと表示されることがあります。また、OData には SAP アドオン 2.34.0 (SP34) 以降が必要であることを示すエラーで、実行が失敗することもあります。いずれの場合も、サポートパッケージをインストールするおよびインストールの説明に従って、コネクターをアップグレードし、PALODATA をインストールします。その後、コンポーネントのバージョンを確認します。
同じソースで ODP の実行は成功するにもかかわらず、OData の実行が SAP への接続中に失敗する場合は、次の点を確認します。
PALODATA がインストールされていること、および SAP_BASIS が 7.50 SP09 以降であることを確認します。SICF サービスがアクティブであることを確認します。Only one active incremental sync is permitted per table per technical user や You cannot reset this sync, an active sync is already configured for this table などのエラーは、購読の競合を示しています。エラーメッセージには、購読を保持している同期の詳細が含まれます。
バッチ同期が実行のたびにデータセット全体を置き換える場合、またはストリームがテーブル全体を再送信する場合は、次の設定がオンのままになっていないか確認します。
実行中のストリームは、開始時の設定を保持します。変更をストリームに適用するには、ストリームを停止し、設定をオフにして保存してから、ストリームを再度開始します。
インクリメンタル状態のリセットを使用せずに SNAPSHOT として実行するインクリメンタル(差分)OData 同期では、最新の差分のみが書き込まれ、データセットが置き換えられます。復旧するには、インクリメンタルバッチ同期の移行手順のステップ2から進めてテーブル全体をフルロードし、その後 APPEND に戻します。