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

SAP SLT 同期に OData を使用する

このガイドでは、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 にアクセスできます。

  • ODP: RFC 経由で SAP の ODP Data Replication API を使用するレガシー API です (ODP-RFC)。
  • OData: SAP の OData 経由の ODP ベースのデータ抽出 ↗を使用する後継 API です。コネクターの PALODATA コンポーネントがこの API を提供します。
SAP は ODP-RFC API へのアクセスを制限しています

SAP Note 3255746 ↗ に記載されているとおり、SAP は ODP-RFC API へのアクセスを制限しています。顧客のアプリケーションおよびサードパーティアプリケーションによる ODP Data Replication API の RFC モジュールの使用は、許可されなくなりました。SAP が公開している ODP に関するよくある質問では、SAP のセキュリティパッチが未承認の ODP-RFC 呼び出しを拒否すると説明されています。このパッチが SAP システムに適用されると、引き続き ODP API を使用している SLT 同期は失敗します。各システムへのパッチ適用時期を SAP ベーシスコンポーネント担当チームに確認し、それまでに移行してください。

移行の対象条件

このガイドは、SLT レプリケーション同期にのみ適用されます。

  • SLT Replication Server オブジェクトタイプを使用する SAP SLT ソースのバッチ同期とストリーミング同期。
  • SLT SAP オブジェクトタイプを使用する SAP(カスタムソース) ソースのバッチ同期。
  • SAP(カスタムソース) ソースのストリーミング同期。

SAP SLT ソースのローカルテーブル同期、およびその他の SAP オブジェクトタイプ(ERP テーブル、InfoProvider、エクストラクターなど)では、このガイドで説明する API の選択は使用しません。上記に記載されていないオブジェクトタイプについては、Palantir サポートにお問い合わせください。

既存の同期は、そのまま移行されます。同期のソースと出力データセットまたはストリームは保持されます。

OData API と ODP API の差異

同期を移行する前に、次の差異を確認してください。

  • テーブルと SAP ユーザーの組み合わせごとに1つの購読: OData API では、ソースが認証に使用する SAP ユーザーについて、テーブルごとに1つのアクティブな購読が許可されます。同じソース資格情報を使用する2つの同期では、フィルターやスケジュールが異なっていても、両方で OData 経由で同じテーブルを取り込むことはできません。ODP API では、複数の同期が同じテーブルを個別に購読できます。
  • リモートコンテキストと並列ページングは使用不可: OData 同期では、リモートコンテキストによる初期読み込みのバイパスも、並列ページングのスレッド数も使用しません。ページは順次取得されるため、大規模な初期読み込みにかかる時間が長くなる可能性があります。
  • 新たな初期読み込みが必要: OData 同期は、ODP のデルタポインターから継続できません。ODP から OData に同期を移行するには、以下の手順で説明するとおり、OData 経由で完全な初期読み込みを1回行う必要があります。

互換性と前提条件

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 の前提条件

次の SAP 側の要件は、4種類すべてのソースと同期の組み合わせに適用されます。これらは SAP アドオンのバージョンに関する要件であり、上の表に記載された Foundry コネクターの要件とは別のものです。

  • コネクターがインストールされている SLT Replication Server の SAP_BASIS が 7.50 SP09 以降であること。
  • コネクターのバージョンが 2.34 (SP34) 以降であること。PALANTIR および PALCONN コンポーネントは SP34 以降である必要があります。最新の OData 機能を利用するため、移行前に SP39 Fix Pack 4 以降にアップグレードすることを推奨します。
  • SLT システムに PALODATA コンポーネントがインストールされていること。SLT 用コネクターのインストールについて詳しくはこちら。
  • OData 経由で ODP を使用するに記載された SAP Note を読み、該当するものを実装していること。
  • SICF サービスを有効化するの説明に従い、コネクターの SICF サービスがアクティブであること。
  • ソースシステム用の SLT 設定が存在すること。そのキューエイリアスが、同期で使用されるコンテキストになります。

SAP コンポーネントのバージョンを確認する

SAP ベーシスコンポーネント担当チームに、SLT Replication Server にインストールされているコンポーネントのバージョンの確認を依頼してください。

  1. SAP GUI で SLT システムにログインします。
  2. メニューからシステム > ステータスを選択します。
  3. SAP システムデータで、コンポーネント情報を開きます。
  4. 次の行を確認します。
    • SAP_BASIS:リリースが 750 で、サポートパッケージが SAPK-75009INSAPBASIS 以降であること、またはそれより上位のリリースであること。
    • PALANTIR および PALCONN:サポートパッケージレベルが SP34 以降であること。SP39 Fix Pack 4 以降を推奨します。
    • PALODATA:一覧に存在すること。

Foundry もコネクターのバージョンを確認します。アドオンが OData をサポートできないと Foundry が判断した場合、API バージョンカードの OData の選択肢に次のいずれかのメッセージが表示されます。

  • このソースのアドオンは、OData に必要なバージョン 2.34 (SP34) より古いバージョンです。OData を選択する前に、コネクターをアップグレードしてください。
  • このソースのアドオンがバージョン 2.34 (SP34) 以降であることを確認できなかったため、OData が動作しない可能性があります。上記の説明に従い、SAP でコンポーネントのバージョンを確認してください。

Foundry のサポート状況を確認する

Foundry コネクターとユーザーインターフェースの更新は Palantir が提供するため、管理が必要なバージョン番号はありません。特定の同期タイプについて、Foundry 環境が OData をサポートしているか確認するには、そのタイプの既存の同期を開くか、新しい同期の作成を開始します。次に、互換性の表に記載されているコントロールがあるかを確認します。

SLT 同期で API バージョンカードが表示されない場合、そのエンロールメントでは、その同期タイプの OData 選択はまだ利用できません。ほかの方法で OData を設定しようとしないでください。ソースタイプ、同期タイプ、SAP コンポーネントのバージョンを添えて、Palantir サポートにお問い合わせください。

バッチ同期

OData を使用するバッチ SLT 同期は、Foundry の標準のトランザクションタイプに従います。

  • APPEND: インクリメンタル(差分)同期です。実行のたびに、前回正常に実行されて以降に ODQ に記録された変更をリクエストし、データセットに追加します。
  • SNAPSHOT: 実行のたびに、データセットの内容をその実行の出力で置き換えます。
インクリメンタル同期を SNAPSHOT に切り替えてもテーブルはフルロードされません

APPEND 同期を SNAPSHOT に変更しても、インクリメンタル設定を保持している場合、SAP は引き続き前回の実行以降の変更のみを送信します。その後、SNAPSHOT トランザクションによってデータセット全体がその変更で置き換えられるため、データセットが不完全または空になる可能性があります。テーブル全体をフルロードするには、インクリメンタル状態のリセットを有効にします。これにより、フルロードのために同期が自動的に SNAPSHOT に切り替わります。インクリメンタル状態のリセットを無効にすると、トランザクションタイプは APPEND に戻ります。

OData を使用して新しいバッチ同期を作成する

  1. SAP の前提条件が満たされていること、および使用するソースと同期の種類で API バージョンカードが利用可能であることを確認します。Foundry のサポートを確認するを参照してください。
  2. 同期を作成します。
    • SAP SLT ソース: ソースの概要ページで、バッチ同期の横にある + 新規を選択し、SLT Replication Server オブジェクトタイプを選択します。
    • SAP(カスタムソース): ソースの概要ページで、バッチ同期の横にある + 新規を選択し、SLT SAP オブジェクトタイプを選択します。
  3. API バージョンで OData を選択します。SAP SLT ソースでは、アドオンが 2.34 (SP34) より古いと Foundry が判断しない限り、新しい同期のデフォルトは OData です。SAP(カスタムソース)同期では、新しい同期のデフォルトは ODP であるため、OData を選択する必要があります。
  4. テーブルとコンテキストを設定します。
    • SAP SLT ソース: テーブル名を入力します。コンテキストには、ソースのリモートコンテキスト設定が使用されます。
    • SAP(カスタムソース): コンテキスト(SLT キューのエイリアス)を選択し、オブジェクト名を入力します。
  5. インクリメンタル設定を行います。
    • インクリメンタル取り込みを行うには、トランザクションタイプを APPEND に設定します。SAP(カスタムソース)同期では、増分フィールドを pointer に設定します。OData 同期は、ほかの増分フィールドをサポートしていません。
    • 購読ポインターを使用せずに毎回テーブル全体を読み込むには、トランザクションタイプを SNAPSHOT に設定します。
    • 必要に応じて、同期あたりの最大行数(SAP SLT ソース)または maxRowsPerSync(SAP(カスタムソース)のアドバンスドタブ)を設定し、大規模な初回ロードを複数回の実行に分割します。複数回の実行に分割する初回ロードを参照してください。
  6. 同期を保存します。まだスケジュールは追加しないでください。
  7. SAP ランドスケープで新しい SLT 初回ロードまたは新しい ODQ 購読に承認が必要な場合は、続行する前に SAP ベーシスコンポーネントのチームから承認を得てください。この承認は組織内のプロセスであり、コネクターの要件ではありません。また、多くのランドスケープでは必要ありません。
  8. 同期を手動で実行します。APPEND 同期の初回実行では、テーブルの初回ロードが行われます。
  9. 初回ロードを検証します。フィルターや削除された列を考慮して、データセットの行数を SAP テーブルの行数と比較します。初回ロードを複数回の実行に分割した場合は、初回ロードが完了するまで同期を実行し続けてから、行数を比較します。
  10. スケジュールを追加し、以降の実行がインクリメンタルであることを確認します。各 APPEND トランザクションには、変更されたレコードのみが含まれます。通常、以降のインクリメンタル実行では、SAP ベーシスコンポーネントからの追加承認は必要ありません。

SAP の ODQ がデルタリクエストを保持する期間には制限があります。インクリメンタル OData 同期の実行間隔が ODQ の保持期間より長い場合、デルタポインターが失われ、同期が失敗する可能性があります。インクリメンタル同期は、ODQ の保持期間より短い間隔で実行するようにスケジュールしてください。保持期間のデフォルトは24時間です。詳細は、SAP Note 2888122「ソースシステムの最新のデルタリクエストが削除されると ODATA ODP デルタを実行できない」を参照してください。

既存のバッチ同期を ODP から OData に移行する

既存のバッチ同期を移行しても、ソース、出力データセット、およびトランザクションタイプは保持されます。

  • SNAPSHOT 同期:SAP の前提条件と Foundry のサポートを確認します。SAP(カスタムソース)同期の場合は、設定要件も満たしてください。次に、同期設定を開き、API バージョンで OData を選択して保存します。インクリメンタル状態のリセットは不要です。
  • APPEND 同期:インクリメンタルバッチ同期を移行するの手順に沿って進めてください。この手順では、OData を介してテーブルを1回フルロードした後、インクリメンタル取り込みを再開します。

インクリメンタルバッチ同期を移行する

この手順は、トランザクションタイプが APPEND の既存のバッチ同期に使用します。OData を介してテーブルを1回フルロードした後、インクリメンタル取り込みを再開します。

  1. 移行を計画します。 次の確認を行います。
    • SAP の前提条件が満たされていること、および同期で API バージョンカードと任意のプロパティであるインクリメンタル状態のリセットが利用可能であることを確認します。Foundry のサポートを確認するを参照してください。
    • SAP ベーシスコンポーネントチームと移行の実施時間帯について合意します。フルロードは初回読み込みと同様に SLT および ODQ リソースを消費します。リソースサイジングを確認します。
    • SAP(カスタムソース)同期を移行する場合は、SAP(カスタムソース)の設定要件を確認します。
  2. 実行の重複を防ぎます。 この同期を含むすべてのスケジュールを一時停止し、進行中の実行が完了するまで待ちます。
  3. OData を選択します。 同期設定を開き、API バージョンで OData を選択します。
  4. インクリメンタル状態のリセットを有効にします。 任意のプロパティであるインクリメンタル状態のリセットを追加し、オンにします。Foundry はトランザクションタイプを SNAPSHOT に設定し、インクリメンタル設定をロックします。保存する前に、次のことを確認します。
    • トランザクションタイプが SNAPSHOT であること。
    • インクリメンタル設定が引き続き存在すること。SAP(カスタムソース)同期では、増分フィールドが pointer のままであること。インクリメンタル設定は削除しないでください。フルロード後に購読を保持するために、この設定が必要です。
  5. 同期設定を保存します。
  6. 必要に応じて、SAP 側の購読確認を完了します。 OData では、テーブルと SAP ユーザーの組み合わせごとに1個のアクティブな購読が許可されます。同じテーブルと SAP ユーザーの組み合わせに対して別の OData 購読がすでに存在する場合、テクニカルユーザーごとにテーブルあたり1個のアクティブなインクリメンタル同期のみが許可されることを示すエラーが発生し、実行が失敗します。同期を実行する前にこの問題を解決する方法については、購読の競合を参照してください。
  7. フルロードを開始します。 SAP ランドスケープで新しい初回読み込みの承認が必要な場合は、先に承認を取得してください。次に、同期を手動で実行します。この実行では、OData を介して完全な初回読み込みが行われ、データセットの内容が置き換えられます。
  8. 初回読み込みを確認します。 実行が成功し、フィルターや削除された列を考慮したうえで、データセットの行数が SAP テーブルと一致することを確認します。同期あたりの最大行数を設定した場合は、行数を比較する前に複数回の実行に分割される初回読み込みを参照してください。
  9. インクリメンタル状態のリセットを無効にします。****インクリメンタル状態のリセットをオフにします。Foundry はトランザクションタイプを APPEND に戻し、インクリメンタル設定のロックを解除します。トランザクションタイプが APPEND であることを確認してから保存します。
  10. インクリメンタル取り込みを確認します。 同期を再度手動で実行し、新しいトランザクションが APPEND であり、フルロード以降の変更のみが含まれていることを確認します。変更されたレコードがない場合は、空のトランザクションになるのが想定される動作です。
  11. スケジュールを再開します。
  12. 古い ODP 購読をクリーンアップします。 移行した同期を確認した後、SAP ベーシスコンポーネントチームに、トランザクション ODQMON でテーブルのレガシー ODP 購読を確認するよう依頼します。コネクターは、その購読から読み込まなくなっています。未使用の購読を終了しても、削除されるのはキューと購読のデータのみであり、SAP 業務テーブルのデータは削除されません。ほかのコンシューマーに属する購読は終了しないでください。SLT 購読のハウスキーピングについては、詳しくはこちらを参照してください。

インクリメンタル状態のリセットをオンのままにしないでください。オンになっている間は、実行のたびに SAP で新たな完全な初回読み込みが強制的に行われ、データセットが置き換えられます。

複数回の実行に分割される初回読み込み

このセクションは、インクリメンタルバッチ同期の移行手順を含むインクリメンタル同期に適用されます。以下では、この手順のステップを参照します。インクリメンタル同期で同期あたりの最大行数(または maxRowsPerSync)を使用している場合、初回読み込みのデータは複数回の実行に分けて配信されます。

  1. リセット実行(ステップ7)では、テーブルの最初の部分を SNAPSHOT として書き込みます。
  2. ステップ9の説明に従って、最初の実行が成功した後にインクリメンタル状態のリセットをオフにします。オンのままにすると、実行のたびに初回読み込みが最初からやり直されるため、読み込みが完了しません。
  3. 残りの部分の配信が完了するまで、APPEND として同期を手動で実行します。
  4. 初回読み込みが完了してから完全性を検証し(ステップ8)、その後ステップ10に進みます。

SAP(カスタムソース)の設定要件

SAP(カスタムソース)のバッチ同期は、OData を選択する前に次の要件を満たしている必要があります。要件を満たしていない場合、該当する設定名を示すエラーが発生し、実行が失敗します。

  • SLT オブジェクトタイプのみ: OData は、SAP オブジェクトタイプとして SLT を使用する同期でのみ利用可能です。
  • コンテキストが必須: 同期ではコンテキストを指定する必要があります。
  • 増分フィールド: 設定されている場合、増分フィールドは pointer である必要があります。
  • JSON ページ形式: ソースが TSV シリアライズを使用している場合は、詳細設定タブで同期に useKernelJsonSerialization: true を追加します。これにより、転送用のページのエンコード方法が変わりますが、抽出される行は変わりません。
  • ブールフラグ:timestamp、resourceCheck、および debug の設定は、true、false、ON、または OFF である必要があります。
  • サポートされていない設定: 値が空であっても、同期の YAML から次の設定を削除します。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.contextSLT キューのエイリアスです。移行による変更はありません。
テーブル名ストリーミング同期エディターストリーミング同期エディター移行による変更はありません。
API バージョンストリーミング同期エディターストリーミング同期エディターOData
スナップショットを強制ストリーミング同期エディターストリーミング同期エディター移行後の初回起動時のみ On にします。移行の段階を参照してください。
キュー登録のリセットストリーミング同期エディターストリーミング同期エディターOff。ストリーミング同期を参照してください。
ポーリング間隔とバッチサイズストリーミング同期エディターストリーミング同期エディター移行による変更はありません。

SAP (Custom source) のストリーミング同期には、SLT 接続タイプが明示的に設定されたソースが必要です。ソース設定を開き、YAML に以下のような connectionType ブロックが含まれていることを確認します。ここで、<context> は SLT キューのエイリアスです。

Copied!
1 2 3 4 5 6 7 type: magritte-sap-source url: https://<host>:<port>/sap/palantir usernamePassword: <username>:{{password}} connectionType: type: slt slt: context: <context>

このブロックがない場合は、ストリームを作成または移行する前に、ストリーミング同期を有効にするの説明に従って追加します。このソースのすべてのストリーミング同期は、このコンテキストを使用します。OData 用にこれ以外のソース設定は必要ありません。

OData を使用して新しいストリーミング同期を作成する

  1. SAP の前提条件を満たしていることと、ストリーミング同期エディターで API バージョンカードが利用可能であることを確認します。Foundry のサポートを確認するを参照してください。
  2. ソースの概要ページから、新しいストリーミング同期を作成し、テーブル名を入力します。
  3. API バージョンで、OData を選択します。新しいストリームのデフォルトは OData です。ただし、アドオンが 2.34 (SP34) より古いと Foundry が判断した場合は除きます。
  4. スナップショットの強制とキュー登録のリセットはオフのままにします。新しい購読では、初期ロードが自動的に実行されます。テーブルと SAP ユーザーに対応する OData 購読を別の同期がすでに保持している場合は、ストリームを開始する前に購読の競合を解決します。
  5. 出力ストリームの場所を選択し、ストリーミング同期を作成します。
  6. SAP ランドスケープで、新しい SLT 初期ロードまたは新しい ODQ 購読に承認が必要な場合は、ストリームを開始する前に承認を取得します。
  7. ストリームを開始します。ストリームは最初にテーブルの初期ロードを受信し、その後は変更の受信を続けます。
  8. ストリームを検証します。初期ロードを受信したら、ストリーム内の一意なキーの数が SAP テーブルと一致することを確認します。その後、SAP でテスト用の変更を行い、その変更がストリームに届くことを確認します。

既存のストリーミング同期を ODP から OData に移行する

この手順では、ソースと出力ストリームを維持したまま、既存の SAP SLT または SAP (Custom source) のストリーミング同期を OData に切り替えます。ストリームを移行すると、既存のストリームにテーブル全体が再送信されるため、開始前にリプレイを計画してください。

移行段階

移行中は、ストリームを以下の段階に沿って進めます。このテーブルを使用して、各段階の設定を確認します。

段階ストリームAPI バージョンスナップショットを強制キュー登録のリセット
移行前実行中ODPOff利用不可
再設定(ステップ 2–6)停止中ODataOnOff
初回読み込みのリプレイ(ステップ 7–8)実行中ODataOnOff
定常状態(ステップ 9以降)実行中ODataOffOff

ストリームは、ODP チェックポイントを OData に引き継ぎません。スナップショットの強制をオンにして最初に開始したとき、ストリームは OData 購読を通じて新しい初期ロードを要求します。その後、スナップショットの強制をオフにして開始した場合は、SAP がストリーム用に保持している OData デルタポインターから再開します。

手順

  1. 移行を計画します。 以下を確認します。
    • SAP の前提条件を満たしていることと、ストリーミング同期エディターで API バージョンカードが利用可能であることを確認します。
    • SAP (Custom source) のストリームの場合は、ソースの SLT 接続タイプを確認します。
    • SAP ベーシスコンポーネントチームと移行時間帯について合意します。
    • ストリームを使用する下流のパイプラインを特定します。移行後、テーブルの現在のすべての行が再び出力されます。ストリームの利用側は、重複レコードに対応できる必要があります。たとえば、テーブルの主キーと、ストリーミング同期で常に追加される /PALANTIR/TIMESTAMP 列に基づいて重複を削除します。
    • 初期ロードは、テーブルの現在の状態を反映します。ストリームの停止中に SAP で削除されたレコードは、削除として出力されません。下流の利用側が削除レコードに依存している場合は、初期ロード後に整合性を確保するための処理を計画します。
  2. ストリームを停止します。 ストリーミング同期を停止し、自動的に再起動するスケジュールを一時停止します。
  3. OData を選択します。 ストリーミング同期の設定を開き、API バージョンで OData を選択します。
  4. スナップショットの強制を有効にします。 スナップショットの強制をオンにし、OData での最初の開始時に、ODP ポインターに依存せずに新しい初期ロードが実行されるようにします。
  5. 購読の競合を確認します。 このテーブルと SAP ユーザーに対応する OData 購読を別の同期がすでに保持している場合は、購読の競合の説明に従って、続行する前に SAP で競合を解決します。キュー登録のリセットがオフであることを確認します。
  6. 設定を保存します。ストリームを開始する前に、設定が移行段階の再設定段階と一致していること、つまり API バージョンが OData で、スナップショットの強制がオンになっていることを確認します。
  7. ストリームを開始します。 SAP ランドスケープで新しい初期ロードに承認が必要な場合は、先に承認を取得します。その後、開始を選択します。
  8. リプレイを検証します。 初期ロードを受信するまで待ちます。一意なキーの数が SAP テーブルと一致することを確認します。
  9. スナップショットの強制をオフにし、保存します。これで、ストリームは移行段階に示す定常状態になります。保存した変更は実行中のストリームには影響せず、次回の開始時に適用されます。スナップショットの強制がオフの場合、その後の再起動では、ダウンタイム後の自動再起動も含め、変更のみがポーリングされます。
  10. デルタを検証します。 SAP で変更を行うか、変更が発生するのを待ち、その変更がストリームに届くことを確認します。
  11. ストリームを再起動するスケジュールを再開する操作を行います。
  12. 古い ODP 購読をクリーンアップします。 ストリームを確認した後、インクリメンタル(差分)バッチ同期の説明に従って、トランザクション ODQMON でそのテーブルのレガシー ODP 購読を確認するよう SAP ベーシスコンポーネントチームに依頼します。

購読の競合

OData API では、SAP ユーザーごとに各テーブルに対して1つのアクティブな購読が許可されます。同じ SAP ユーザーを使用する別の同期が、テーブルの OData 購読をすでに保持している場合、競合が発生します。一般的な原因は次のとおりです。

  • 同じ資格情報を使用する別の SAP SLT または SAP (Custom source) の同期が、すでに OData 経由でそのテーブルを取り込んでいる。
  • Foundry で削除または置き換えられた同期の購読が、SAP でアクティブなままになっている。
  • 同じテーブルと SAP ユーザーで、以前に OData をテストしたことがある。

エラーメッセージには、購読を保持している同期のインクリメンタル ID、最終実行日、作成者が含まれます。これらの詳細を使用して、購読を所有する同期を特定します。

キュー登録のリセットでは競合は解消されません。この設定では、現在の同期自身の購読のみがリセットされます。別の同期が購読を保持している場合、実行は You cannot reset this sync, an active sync is already configured for this table というエラーで失敗します。

競合を解消するには、次のいずれかの方法を選択します。

  • SAP で購読を解除する: 競合している同期の所有者と調整し、まずその同期を停止します。次に、SAP ベーシスコンポーネントチームに依頼して、トランザクション ODQMON で該当するテーブルと SAP ユーザーの競合する OData 購読を終了します。これにより削除されるのは購読のみで、SAP 業務テーブルのデータは削除されません。購読を保持していた同期は、インクリメンタルに継続できなくなります。その同期が引き続き必要な場合は、新たな初期読み込みが必要になり、競合が再発するため、代わりに一方の同期で別の SAP ユーザーを使用します。
  • 別の SAP ユーザーを使用する: 2つの同期で同じテーブルを独立して取り込む必要がある場合は、異なる SAP ユーザーとして認証するソースを使用します。

トラブルシューティング

API バージョンカードが表示されない

  • 同期で SLT Replication Server オブジェクトタイプ(SAP SLT ソース)または SLT SAP オブジェクトタイプ(SAP (Custom source))が使用されていることを確認します。ローカルテーブルやその他のオブジェクトタイプでは、カードは表示されません。
  • SAP (Custom source) のストリーミング同期の場合は、ソースに SLT 接続タイプが明示的に設定されていることを確認します。
  • オブジェクトタイプが正しいにもかかわらずカードが表示されない場合、そのエンロールメントでは、その同期の種類での OData の選択がまだ利用できません。Palantir サポートにお問い合わせください。

アドオンのバージョンに対応していない

API バージョンカードに、アドオンが 2.34 (SP34) より古いと表示されることがあります。また、OData には SAP アドオン 2.34.0 (SP34) 以降が必要であることを示すエラーで、実行が失敗することもあります。いずれの場合も、サポートパッケージをインストールするおよびインストールの説明に従って、コネクターをアップグレードし、PALODATA をインストールします。その後、コンポーネントのバージョンを確認します。

OData サービスが利用できない

同じソースで ODP の実行は成功するにもかかわらず、OData の実行が SAP への接続中に失敗する場合は、次の点を確認します。

  • PALODATA がインストールされていること、および SAP_BASIS が 7.50 SP09 以降であることを確認します。
  • OData 経由で ODP を使用するに記載されている SAP ノートが実装されていることを確認します。
  • コネクターの SICF サービスがアクティブであることを確認します。
  • Add-on Cockpit でコネクターのログを確認してから、エラーメッセージと SAP コンポーネントのバージョンを添えて Palantir サポートにお問い合わせください。

テーブルにアクティブな購読があると実行時に報告される

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 などのエラーは、購読の競合を示しています。エラーメッセージには、購読を保持している同期の詳細が含まれます。

毎回の実行でテーブル全体がフルロードされる

バッチ同期が実行のたびにデータセット全体を置き換える場合、またはストリームがテーブル全体を再送信する場合は、次の設定がオンのままになっていないか確認します。

  • インクリメンタル状態のリセット(バッチ)。オフにします。Foundry によってトランザクションの種類が APPEND に戻されます。
  • キュー登録のリセット(バッチまたはストリーミング)。オフにします。ストリームでは、この設定によって実行中に購読が繰り返し再初期化されることがあります。
  • スナップショットの強制(ストリーミング)。オフにします。

実行中のストリームは、開始時の設定を保持します。変更をストリームに適用するには、ストリームを停止し、設定をオフにして保存してから、ストリームを再度開始します。

SNAPSHOT 実行後にデータセットが一部のみになるか空になる

インクリメンタル状態のリセットを使用せずに SNAPSHOT として実行するインクリメンタル(差分)OData 同期では、最新の差分のみが書き込まれ、データセットが置き換えられます。復旧するには、インクリメンタルバッチ同期の移行手順のステップ2から進めてテーブル全体をフルロードし、その後 APPEND に戻します。