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

よくある質問

このページでは、Palantir Foundry Connector 2.0 for SAP Applications(以下「コネクター」)に関するよくある質問について詳しく説明します。

接続する

全般

コネクターで、ソース SAP システムの SAP ABAP プラットフォームに ABAP アドオンをインストールする必要があるのはなぜですか?

この方式には、次のような利点があります。

  • SAP のリソース使用状況を監視し、システムの過負荷を防止できます。
  • 生データだけでなく、ビュー、BW InfoProvider、BEx クエリなど、より幅広い SAP の作成物へのアクセスやクエリが可能です。
  • Foundry の充実したソース探索機能により、SAP 内で関連データを見つけるプロセスを大幅に迅速化し、データ同期を一括作成できます。
  • インクリメンタル(差分)データ同期(変更データキャプチャ)をより幅広くサポートします。
  • データ同期が失敗したときに問題を調査するためのデバッグ機能が充実しています。

システムとバージョン

コネクターはどの SAP システムをサポートしていますか?

  • SAP R/3、SAP ECC、および SAP S/4HANA
  • SAP SLT Replication Server(変更データキャプチャ用)
  • SAP BW(APO などのツールを含む)

コネクターはどの SAP バージョンをサポートしていますか?

ABAP アドオンは SAP ABAP プラットフォーム(旧称 SAP NetWeaver Application Server)で動作するため、SAP_BASIS コンポーネントのバージョンが最も重要です。SAP_BASIS は、SAP NetWeaver と SAP S/4HANA の両方のシステムに適用される技術コンポーネントのバージョンです。 推奨する SAP_BASIS の最小バージョンは次のとおりです。

  • SAP_BASIS 7.4 SP5 以上
  • SAP_BASIS 7.5(最小 SP レベルの指定なし)

これらは最小バージョンです。コネクターは、SAP_BASIS 8.x(たとえば SAP_BASIS 816)をベースとする SAP S/4HANA リリースを含め、これらより上位のすべての SAP_BASIS バージョンをサポートします。

OData 経由の SLT を使用する場合、OData コンポーネント(PALODATA)には SAP_BASIS 7.50 SP09 以上が必要です。

主要な SAP システムで稼働している SAP_BASIS のバージョンが 7.4 未満の場合、コネクターの機能の一部を利用できるソリューションがあります。ただし、このソリューションでも、Foundry が旧バージョンに接続するためのゲートウェイとして機能する、SAP_BASIS バージョン 7.4 以上のシステムが必要です。このアプリケーションサーバーは、未使用のものでも、BW などの新しい SAP システムで使用中のものでも構いません。

コネクターは SAP IBP / SAP Ariba / ... をサポートしていますか?

SAP システムまたはモジュールが SAP ABAP プラットフォームで動作している場合、コネクターでそのデータを抽出できます。

一方、SAP システムがクラウドベース(たとえば SAP IBP)の場合、または ABAP プラットフォームベースではない場合(SAP Ariba など)、このコネクターはデータ抽出に適したソリューションではありません。これらのシステムからデータを抽出するほかの方法については、Palantir サポートにお問い合わせください。

認証

アドオンは SAP の認証を受けていますか?

Palantir Foundry Connector 2.0 for SAP Applications は、2023年4月18日に SAP 統合証明書 ↗を取得しており、その有効期限は2026年12月31日です。

SAP のリファレンスアーキテクチャ ↗では、Palantir のネイティブ SAP コネクターの既存ユーザーに対し、SAP Data Accelerator プロキシソースを使用して、2026年12月31日までに SAP が推奨する統合アーキテクチャへ移行するよう求めています。このアーキテクチャでは ABAP アドオンを維持し、SAP Data Accelerator を経由して接続します。

アンインストール

アドオンはアンインストールできますか?

はい。アドオンは独自の名前空間を使用しており、アンインストールすると SAP システムからすべてが削除されます。残るのは、アドオンがいつインストールおよびアンインストールされたかを示す SAINT インストールログの記録のみです。

負荷とパフォーマンス

コネクターが SAP システムに過負荷をかけないことを、どのように確認できますか?

コネクターは、SAP システムの負荷とパフォーマンスを最優先事項として設計されています。SAP システムからのデータレプリケーションによって、エンドユーザーの利用体験やほかの重要なプロセスに支障が生じないようにするためのリソースチェック機能を備えています。

データ抽出はページ単位で行われ、各ページのリクエスト前に、アドオンがメモリー使用率、CPU 使用率(システムとユーザーの両方)、および実行中のワークプロセス数(ダイアログとバックグラウンドの両方)を評価します。これらのメトリクスのいずれかが、すべて設定可能なしきい値の範囲外になった場合、抽出は中止され、十分なリソースが利用可能になっている可能性がある後の時点で再試行されます。

この機能は、多くの大企業の複雑な本番 SAP システム環境で使用されており、コネクターが数十億行ものデータをレプリケートする中で、エンドユーザーやほかの実行中のプロセスに支障をきたす可能性のある過剰な負荷から、これらのシステムを保護することが確認されています。

ライセンス

コネクターを使用するには追加の SAP ライセンスが必要ですか?

SAP ライセンスへの準拠はお客様の責任です

Palantir は SAP と提携しておらず、SAP ライセンスに関する法的助言を提供できません。そのため、SAP システムおよびコネクターの現在または今後の利用の範囲と詳細、ならびにそれが SAP ライセンスおよび契約に及ぼす影響を評価する責任は、お客様のみが負うものとします。

これまでの経験では、アプリケーションレイヤーを介して SAP ERP システムからスケジュールに従ってデータを抽出することは、SAP が「間接的な静的読み取り」と呼ぶものに該当する可能性があり、そのデータを SAP 以外のサードパーティー製システムで使用する際にライセンスが不要な場合があります。ただし、ユーザーが SAP 以外のサードパーティー製システムから SAP にデータをライトバックする場合は、追加の SAP ライセンスが必要になることが多くあります。

懸念がある場合は、法律顧問や SAP 担当者に確認し、SAP の利用状況とライセンスについてご相談ください。

セキュリティ

すべてのデータは転送中および保存時に暗号化されますか?

はい。SAP から Data Connection Agent へのデータ転送、および Agent から Foundry へのデータ転送には HTTPS が使用されます。Data Connection Agent のホストマシンに一時的にステージングされるデータは暗号化されます。

アドオンはどのような種類の権限ロールを使用しますか?

アドオンでは4種類の権限ロールを使用します。

  • サービスロール: アドオンの実行に必要なロールです。これらのロールは変更しないでください。
  • コンテンツロール: SAP システムからデータを抽出するために必要なロールです。これらのロールは、コピーしたうえで業務要件に応じて変更できます。
  • ライトバックロール: Foundry から SAP システムへのライトバックが有効になっている場合に必要なロールです。
  • 監視およびデバッグロール: リモート監視を可能にする SAP システム情報を Foundry に公開するために必要なロールです。

詳細については、権限ロールを参照してください。

Foundry へのデータ同期を試みたときに発生する SSL の問題にはどう対処できますか?

  • javax.net.ssl.SSLHandshakeException: PKIX path building failed
    • これは、SAP システムへの HTTPS 接続が有効であることを検証するための情報が、Data Connection Agent に十分にないことを意味します。
    • 多くの場合、該当する SSL 証明書を Data Connection Agent のトラストストアにアップロードすることで、この問題を解決できます。
    • SSL 証明書をダウンロードするには、Data Connection Agent がインストールされている(仮想)マシンから次のコマンドを実行します($HOST と $PORT を SAP システムのホストとポート番号に置き換えます)。
    openssl s_client -showcerts -servername $HOST -connect $HOST:$PORT </dev/null 2>/dev/null |sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' | python3 -c "from sys import stdin; text = stdin.read(); ca_cert = text.split('-----BEGIN CERTIFICATE-----')[-1][:-26]; ca_cert = ca_cert.replace('\n', ''); print('\n' + ca_cert)"
    
    これは、マシンに openssl と python3 がインストールされていることを前提としている点に注意してください。
    • このコマンドは、SSL 証明書を表す長い文字列を出力します。この文字列をクリップボードにコピーします。
    • 次に、Foundry UI で Data Connection Agent の設定ページに移動します。
    • Agent 設定 > Agent 証明書を管理 > 新しい証明書を追加をクリックします。
    • 証明書にエイリアス(証明書の発行元である SAP システムの名前など)を付け、クリップボードから「pem...」という名前のボックスに証明書を貼り付けます。
    • 変更を保存してから、Agent を再起動します。
  • javax.net.ssl.SSLPeerUnverifiedException: Hostname XXXXX not verified
    • これは通常、証明書に SAN(サブジェクト代替名)が設定されていないことを意味します。
    • ドメインの検証に CN(コモンネーム)を使用することは非推奨となっているため、SAP ベーシスコンポーネントチーム(またはセキュリティチーム)に、SAN を使用した新しい証明書の発行を依頼することを推奨します。
    • 推奨はしませんが、非本番環境のシナリオでは、Foundry の SAP ソース設定で次の設定を使用して、レガシーのホスト名検証機能を有効にできます:useLegacyHostnameVerifier: true。

データ統合のアプローチ

ソース ERP からデータを抽出すべきなのはなぜですか(たとえば SAP BW ではなく)?

利用可能なソースデータの中で最も粒度の細かいデータから始めることで、データ統合によって実現する下流のアプリケーションの柔軟性と有用性を最大限に確保しやすくなります。前処理済みのデータを使用することは近道に見えるかもしれませんが、そうすると、将来対応できる問題の範囲がすぐに狭まってしまいます。

使用したい既存の BW レポートやクエリがある場合は、生の ERP データと BW データの両方を抽出するのがよい方法です。

データ抽出

全般

SAP からどの種類のテーブルを抽出できますか?

透過テーブル、プールテーブル、クラスターテーブルはすべて SAP から抽出できます。

データ抽出時に ABAP のデータ型は Foundry のデータ型にどのように変換されますか?

次のテーブルは、システム間での各データ型のマッピングを示しています。

SAP ABAP データ型Foundry データ型説明
ACCP文字列転記期間
CHAR文字列固定長文字列
CLNT文字列クライアントフィールド
CUKY文字列通貨キー(CURR から参照)
CURRDecimal通貨フィールド
D16DDecimalBCD 形式で保存される10進浮動小数点数
D16NDecimal10進浮動小数点数
D16RDecimal2進数として保存される10進浮動小数点数
D16SDecimalスケーリング付き10進浮動小数点数(廃止されていますが、古いシステムでは引き続き使用されています)
D34DDecimalBCD 形式で保存される10進浮動小数点数
D34NDecimal10進浮動小数点数
D34RDecimal2進数として保存される10進浮動小数点数
D34SDecimalスケーリング付き10進浮動小数点数(廃止されていますが、古いシステムでは引き続き使用されています)
DATNDateYYYYMMDD 形式の日付(HANA のネイティブデータ型 DATE)
DATSDate日付値
DECDecimal符号付き固定小数点10進数
FLTPDouble浮動小数点数
INT1Integer非常に小さい符号付きの正確な整数
INT2Integer小さい符号付きの正確な整数
INT4Integer通常の符号付きの正確な整数
LANG文字列言語キー
LCHR文字列固定長文字列
LRAWBinary解釈されない可変長バイト列
NUMC文字列テキスト文字列
PREC文字列QUAN フィールドの精度
QUANDecimalDEC フィールドの数量
RAWBinary解釈されないバイト列
RAWSTRINGBinary可変長文字列データ
TIMS文字列*時刻値
UNIT文字列単位キー(QUAN から参照)

Foundry には(Date や Timestamp とは異なる)専用の Time データ型がないため、TIMS 型は String として表現されます。Foundry のデータ変換パイプラインの最初のステップとして、TIMS 型のフィールドを対応する DATS 型のフィールドと組み合わせ、新しい Date または Timestamp フィールドを作成することを推奨します。

コネクターはビューの抽出をサポートしていますか?

SAP にはいくつかの種類の「ビュー」があります。

  • ERP ビュー:「ERP Table」オブジェクトタイプを使用して抽出できます。同期設定のドロップダウンリストでは、オブジェクト名の横に「VIEW」と表示されます。
  • ABAP CDS ビュー: これらのビューのサポートは、アドオンの SP21 で追加されました。
  • HANA Information ビュー: これらのビューのサポートは、アドオンの SP22 で追加されました。

技術的な詳細

特定の SAP ソースに対して Foundry でデータ同期を実行すると、何が起こりますか?

特定の SAP ソースに対して Foundry でデータ同期を実行すると、次のステップが行われます。

  1. Data Connection Coordinator が適切な Data Connection Agent への接続を試み、同期を開始します。
  2. Data Connection Agent 上で実行されている SAP プラグインがトリガーされ、同期プロセスを開始します。
  3. SAP アドオンへの最初のリクエストはページング初期化リクエストです。このリクエストを受けて、SAP アドオンは該当するテーブルまたはオブジェクトをクエリし、/PALANTIR/ スペース内のテーブルに、高度に圧縮されたデータページの書き込みを開始します。
  4. その後の SAP アドオンへのリクエストでは、最後のデータページに到達するまで、データページを順番にポーリングします(該当するページがまだ利用可能でない場合は、一時停止して再試行します)。これらのデータページは、Data Connection Agent のホストマシン上に、暗号化された Apache Parquet ファイルとして書き込まれます。
  5. 最後のデータページを取得すると、ページング終了リクエストが SAP アドオンに送信されます。
  6. 続いて Data Connection Agent は、すべてのデータが対象のデータセットに転送されるまで、Apache Parquet ファイルを Foundry にアップロードします。

次のデータ同期エラーを解決するにはどうすればよいですか?

  • Unexpected value encountered in SAP data Failed to parse value XXX in field YYY
    • このエラーは、日付または数値の値が不正で、パースできない場合に発生することがあります。同期の予期しない値を無視を有効にすると、パースできない値が null に設定され、処理が続行されます。
  • Current CPU user load(X%) is higher than the max. CPU user parameter(Y%)., Please increase CPU_USER threshold value!, System resources are below threshold values.
    • CPU、メモリー、またはワークプロセスのリソースチェックに失敗すると、この形式のエラーが表示されることがあります。これは、システムの過負荷を防ぐために定義されたしきい値に照らして、該当するシステムリソースが不足していることを示します。場合によっては、これは望ましい結果であり、システムの負荷が下がるまで待ってから同期を再試行することが適切な解決策です。ただし、該当するリソースチェックのしきい値が保守的すぎる可能性もあります。しきい値を再設定する方法については、パフォーマンスパラメーターを参照してください。
  • ERROR : User XXXXX does not have enough authorization for this service call.
    • このエラーは、SAP アドオンが使用する技術ユーザーに必要な権限ロールが生成されていないか、ロールが正しく割り当てられていないことを示します。権限ロールを確認してください。

変更データキャプチャ

コネクターには、インクリメンタル(差分)同期 / 変更データキャプチャ用にどのようなオプションがありますか?

  • SAP SLT Replication Server(利用可能な場合)
    • ソース ERP のトリガーに基づいて、データが Foundry にレプリケートされます。
  • SAP ERP または S/4HANA
    • BW エクストラクター(利用可能な場合)を使用すると、エクストラクターが管理する差分に基づいてデータを Foundry にレプリケートできます。
    • アドオンには、変更データキャプチャのための包括的かつ柔軟な独自の方式も含まれており、さまざまな標準 SAP テーブルで動作するように設定できます。詳細については、インクリメンタル同期を参照してください。

SAP の任意のテーブル/オブジェクトに対してインクリメンタル同期を設定する場合、incrementalField にはどのようなフィールドを選ぶとよいですか?

指定するインクリメンタルフィールドの値は、単調増加することが理想的ですが、そのようなフィールドが常に見つかるとは限りません。日付フィールド(時刻の要素を含まないもの)が最適な選択肢となる場合もあります。このため、システムは単に「より大きい」ではなく「以上」の比較を使用し、前回の同期がある日付の途中で実行されていてもデータが欠落しないようにします。その結果、Foundry の出力データセットに重複する値が含まれる可能性があります。これらの重複する値は、Foundry のデータ変換パイプラインの最初のステップとして、たとえば主キーで重複行を確認することにより、削除する必要があります。詳細については、インクリメンタル同期を参照してください。

インクリメンタルデータ同期を開始するためにトランザクションタイプを SNAPSHOT から APPEND に切り替えると、なぜテーブル全体が重複するのですか?

データ同期を SNAPSHOT トランザクションタイプで開始すると、コネクターはインクリメンタル状態を追跡しません。その後 APPEND に切り替えると、最初のインクリメンタル同期では SAP システムからすべてのデータが抽出され、それ以降は「差分」(前回の同期以降に変更されたもの)のみが抽出されます。そのため、どのデータ同期をインクリメンタルにするかを事前に計画し、それらの同期を APPEND トランザクションタイプで開始することを推奨します。

SNAPSHOT から APPEND への切り替えによってデータセット内のデータが重複した場合は、インクリメンタル状態のリセットの手順に沿って進めてください。

リソースチェック

どの種類のリソースチェックを利用できますか?

次の3種類のリソースチェックを利用できます。

  • CPU_CHECK: CPU 使用率が指定のしきい値を超えている場合に、同期の実行を防ぎます
  • MEMORY_CHECK: メモリー使用率が指定のしきい値を超えている場合に、同期の実行を防ぎます
  • PROCESS_CHECK: 利用可能なプロセス数が指定のしきい値を下回っている場合に、同期の実行を防ぎます

デフォルトではどのように動作し、変更するにはどうすればよいですか?

デフォルトでは、すべてのリソースチェックが有効になっており、さらに、これらのリソースチェックは「継続的」に適用されます。つまり、同期の開始時だけでなく、各ページをリクエストする前にチェックが行われます。

個々のデータ同期の単位でデフォルトの動作を変更するには、Data Connection UI で次の順に選択します。追加設定 > リソースチェック / 継続的なリソースチェック > オフ。

SAP Business Warehouse (BW) の機能

どの SAP BW 機能がサポートされていますか?

次のものからデータを抽出できます。

  • SAP BW InfoProviders — DataStore Objects (DSO)、InfoCubes、InfoObjects を含みます
  • SAP BW BEx Queries

機密データ

必要な非機密データの抽出を妨げずに、機密データが SAP システムの外部に出ないようにするには、どのようなオプションを利用できますか?

最も大きな単位では、アドオンのコンテンツの権限ロールを変更して、テーブル全体またはオブジェクト全体の抽出を防止できます。

抽出可能なデータを行単位で制限するには、フィルターを使用できます。フィルターは、データが SAP システムの外部に出る前に適用されます。

  • フィルターは、Foundry の Data Connection UI の同期設定で定義できます。
  • ただし、SAP システム自体の Connector Cockpit で「事前フィルター」を設定することもできます。これらのフィルターは、Foundry からのフィルターに加えてテーブルに適用されるため、Source Explorer および同期設定 UI に表示されるデータプレビューにも適用されます。詳細については、事前フィルターを参照してください。

列単位でデータ抽出を制限する方法は2つあります(これらの方法も、上記のフィルターと同様に、データが SAP システムの外部に出る前に適用されます)。

  • 同期設定 UI には、データ抽出から除く列を選択するための「列を削除」機能があります。
  • Connector Cockpit では、さまざまな暗号化およびデータマスキングの設定を利用できます。

ライトバック

技術的な詳細

Foundry から SAP へのライトバックはどのように実現されますか?

ABAP アドオンは、Foundry から SAP 関数を呼び出す機能を提供します。BAPI (Business API) 関数は、構造が明確に定義され、エラーメッセージもわかりやすいため推奨されますが、必要に応じて、アドオンから任意の種類の関数モジュールを呼び出すこともできます。

ライトバックを設定するには、Foundry Webhook を作成する必要があります。詳細については、概要を説明した Webhookと、SAP 固有の詳細を説明した Webhook の設定 - SAP を参照してください。

名前付きユーザーへの帰属

Foundry から SAP に、技術ユーザーやサービスアカウントではなく、名前付きユーザーとしてライトバックできますか?

はい。OAuth 2.0 認可コードフローを使用することでサポートされます。このシナリオでは、SAP システムが OAuth 2.0 サーバーとして機能し、Foundry が OAuth 2.0 クライアントとして機能します。ユーザーが Foundry から SAP へのライトバックを初めて試みると、SAP システムの認可ダイアログにリダイレクトされ、Foundry がそのユーザーに代わって SAP にライトバックすることを許可するかどうかを確認します。

詳細については、OAuth 2.0 を使用したユーザーに帰属する SAP ライトバックを参照してください。

コネクターのメンテナンス

アップグレード

SAP アドオンはどのようにアップグレードしますか?

新しいサポートパッケージ (SP) が提供されます。ドキュメントに記載されたアップグレード手順に従ってください。

SAP アドオンの新しいリリースはどのくらいの頻度で提供されますか?

リリーススケジュールは固定されていませんが、通常は2~3か月ごとに新しいサポートパッケージ (SP) が提供されます。

ハウスキーピング

SAP アドオンは、テーブルスペースがいっぱいにならないように、ログテーブルを定期的に切り詰めますか?

はい。ただし、SAINT によるインストール処理では関連するハウスキーピングジョブを自動的に有効にできないため、有効にする必要があります。詳細については、ハウスキーピングジョブをセットアップして設定するを参照してください。