SAP Data Agentトラブルシューティングガイド ​

SAP Data Agentでパイプラインを設定または実行する際の問題をトラブルシューティングするには、このガイドを使用します。このガイドでは、SAP Table Reader、SAP BW Open Hub Destination (OHD)、SAP Operational Data Provisioning (ODP) プラグインを扱います。

SAP Table Reader ​

SAP Table Reader抽出でパイプラインを設定または実行する際の問題をトラブルシューティングするには、このセクションを使用します。

権限エラー ​

このセクションでは、抽出中のSAPユーザー権限の欠落または不足に関連する問題について説明します。

テーブル/ビューへのアクセス権限がありません ​

抽出中に次のエラーが表示される場合があります。

Not authorized to access table/view: <table/view name>

発生する理由 ​

このエラーは、抽出を実行しているSAP技術ユーザーに、指定されたテーブルまたはビューに対する十分な権限がない場合に発生します。

必要なロールまたは権限オブジェクトがないか、正しく割り当てられていません。

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

ログと監視のエラー ​

このセクションでは、パイプライン実行中のSAPアプリケーションログと監視の可視性に関連する問題について説明します。

SLG1ログが見つかりません ​

パイプラインの実行後に、想定されるアプリケーションログがSLG1に表示されない場合があります。

発生理由 ​

これは次の場合に発生することがあります。

• 不正なログオブジェクトまたはサブオブジェクトが使用されている
• ログ保持期間が期限切れになっている

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

ログでの入力ペイロード取得エラー ​

入力ペイロードまたはリクエストパラメーターがSAPログに表示されないことがあります。

発生理由 ​

これは次の場合に発生することがあります。

• ログ設定が不完全である
• ユーザーにログ権限がない
• アプリケーションログテーブルに想定されるエントリが含まれていない

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

高度なログ追跡 ​

標準のSAPログで抽出失敗の診断に十分な詳細が得られない場合は、高度なログを使用します。

明確なエラー詳細がないまま抽出が失敗する ​

パイプラインは失敗しますが、ログでは十分な診断の詳細が得られません。

発生理由 ​

標準ログには高レベルのエラーメッセージが記録されますが、詳細なランタイムパラメーターが含まれない場合があります。

SM37のバックグラウンドジョブログにも、根本原因を特定するために必要な内部コンテキストが不足している場合があります。

高度なログは、複雑または不明瞭な失敗のトラブルシューティングに向けて、より深い実行Insightsを提供します。

高度なログを使用するタイミング ​

次のシナリオでは高度なログを使用します。

• 明確な根本原因がないままジョブが失敗する
• SM37のバックグラウンドジョブログで十分な詳細が得られない
• 入力ペイロードの検証は正しいように見えるが、抽出が引き続き失敗する
• フィルター条件、フィールドリスト、または内部処理状態を可視化する必要がある

トラブルシューティング方法 ​

より詳細な分析のために高度なログを有効化するには、次の手順を完了します。

高度なログを有効化した後、/WKTO/ERR_LOGおよび/WKTO/DA_LOG_SRVのログを確認します。

ログにアクセス

これらのログには次が含まれます。

• 入力ペイロードパラメーター
• フィルター条件
• フィールドリスト
• ジョブメタデータ
• 内部処理ステータス

ログを表示

パイプラインとクリーンアップの問題 ​

このセクションでは、パイプライン状態、ランタイムクリーンアップ、およびバックグラウンドジョブの可用性に関連する問題について説明します。

パイプラインの詳細が見つかりません ​

抽出中に次のエラーが表示される場合があります。

Pipeline details not found

発生理由 ​

これは次のシナリオが原因で発生することがあります。

• パイプラインIDが無効である
• パイプラインランタイムの詳細がメモリからクリーンアップされた
• SAPシステムでバックグラウンドジョブの負荷が高い

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

大規模テーブルのパッケージサイズ調整 ​

可変長フィールドを含む大規模なSAPテーブルでは、安定した処理を確保するために、抽出パッケージサイズを小さくする必要がある場合があります。

推奨される理由 ​

一部のSAPテーブルには、次のような大きなデータ型が含まれています。

• STRING
• RAWSTRING
• LRAW
• SSTRING

単一の抽出パッケージに大きなレコードが多く含まれすぎると、累積ペイロードサイズがSAPの内部文字列サイズ制限に近づく可能性があります。これにより、ランタイムが不安定になったり、ジョブが終了したりする可能性があります。

パッケージサイズを縮小すると、大規模なテーブルやテキストの多いテーブルの信頼性を向上できます。

パッケージサイズの調整方法 ​

パッケージサイズを調整するには、次の手順を完了します。

更新されたパッケージサイズは、新しい実行にのみ適用されます。既存の実行中ジョブには影響しません。

同時実行とシステム過負荷 ​

このセクションでは、SAPシステムのバックグラウンドジョブリソース制約によって発生する抽出失敗をトラブルシューティングする方法について説明します。

システム過負荷によるジョブ失敗 ​

抽出ジョブがリリース済み状態のままになるか、断続的に失敗します。

発生理由 ​

SAPシステムで十分なバックグラウンドワークプロセスを利用できない可能性があります。複数のパイプラインまたはスケジュール済みジョブが同時に実行されると、利用可能なプロセスが枯渇する場合があります。

トラブルシューティング方法 ​

これにより、システムの安定性を確保し、他のスケジュール済みジョブとの競合を減らし、抽出の信頼性を向上できます。

SAP BW Open Hub Destination ​

SAP BW Open Hub Destination（OHD）抽出でパイプラインを設定または実行する際の問題をトラブルシューティングするには、このセクションを使用します。

OHD設定エラー ​

このセクションでは、Open Hub DestinationとそのData Transfer Process（DTP）設定に関連する問題について説明します。

複数のDTPを持つOHDはサポートされていません ​

抽出中に次のエラーが表示される場合があります。

OHD having multiple DTP is not supported

発生する理由 ​

選択したOHDには複数のData Transfer Process（DTP）がデータを投入しています。 SAP Data Agentは、単一のDTPに関連付けられたOHDからの抽出のみをサポートしています。

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

入力されたOHDのDTPが見つかりません ​

抽出中に次のエラーが表示される場合があります。

No DTP found for the entered OHD

発生する理由 ​

OHDは存在しますが、データを投入するためのData Transfer Process（DTP）が作成または割り当てされていません。その結果、SAP Data AgentはOHDからデータを抽出できません。

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

オブジェクトに設定する同期モードは、DTPの抽出モードと一致している必要があります。詳細については、同期モードの選択を参照してください。

権限エラー ​

このセクションでは、SAPの権限とアクセス許可に関連する問題について説明します。

権限チェック時にテーブルまたはビューを使用できません ​

抽出中に次のエラーが表示される場合があります。

Table/View Not available: <table_name> - while checking authorization

発生する理由 ​

抽出を実行しているSAPテクニカルユーザーには、指定されたテーブルまたはビューに対する十分な権限がありません。

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

パッケージサイズ ​

BW OHD抽出の抽出パッケージサイズを手動で調整することはできません。 /WKTO/PACKトランザクションは、SAP Table Reader抽出にのみ適用されます。

SAP ODP ​

このセクションでは、SAP Operational Data Provisioning (ODP) 抽出を使用するパイプラインの設定または実行時に発生する問題のトラブルシューティング方法を説明します。

差分サブスクリプションエラー ​

このセクションでは、ODP データソースに対して増分同期が作成する差分サブスクリプションに関連する問題について説明します。各 ODP サービスは増分同期サブスクリプションを 1 つサポートします。詳細については、Select the sync mode を参照してください。

パイプラインが実行できない: サービスが別のパイプラインで使用中 ​

抽出中に次のエラーが表示される場合があります。

サービス '<ServiceName>' に対する SAP ODP2 サブスクリプションはすでに別のパイプラインに保持されています: この OData サービスはすでにパイプライン ID: <PipelineID> によって使用されています。新しい OData サービスを作成するか、SAP トランザクション /WKTO/ODP_SUBS を使用して既存のパイプラインとそのサブスクリプションを削除してください。既存のパイプラインを終了するか、SAP トランザクション /WKTO/ODP_SUBS を使用してスロットを解放し、その後このパイプラインを再実行してください。

発生理由 ​

増分同期を開始したデータソースのサービスが、すでに別のパイプラインで増分同期に使用されています。各 ODP サービスは、1 つのパイプラインでのみ増分同期に使用できます。

トラブルシューティング方法 ​

データソース用に新しい ODP サービスを作成し、このパイプラインで使用します。詳細については、Expose an ODP data source as an OData service を参照してください。

または、既存のサブスクリプションを解放して、このパイプラインがサービスを使用できるようにします。

既存のサブスクリプションを解放するには、次の手順を実行します。

サブスクリプション終了後も差分エントリが残っている ​

抽出中に次のエラーが表示される場合があります。

SAP ODP2 データソース '<DataSourceName>' は新規の初回ロード用にサブスクライブされたばかりですが、その DeltaLinks 履歴が空ではありません（<n> 件のエントリ、最新の !deltatoken は '<DeltaToken>'）。別のサブスクリプションが SAP 側に正しく終了されないまま残されており、どのエントリがこのパイプラインに属するか判別できないため続行できません。オペレーターに依頼して SAP トランザクション /WKTO/ODP_SUBS を実行し、孤立したサブスクリプションをクリーンアップしてから、このパイプラインを再実行してください。

発生理由 ​

パイプラインが増分同期用の初回ロードを開始しましたが、そのデータソースの差分エントリが SAP 内にまだ残っています。この現象は、以前のパイプラインのサブスクリプションを削除した後によく発生します。差分終了処理が差分エントリをクリアするまでには時間がかかり、SAP システムが高負荷のときはさらに長くなることがあります。

トラブルシューティング方法 ​

約 5 分待ってから、パイプラインを再実行します。

エラーが解消しない場合は、トランザクション /WKTO/ODP_SUBS を使用して孤立したサブスクリプションを削除します。手順については、Pipeline can't run because the service is in use by another pipeline を参照してください。

データソースが別のサブスクリプションにより駆動されている ​

抽出中に次のエラーが表示される場合があります。

SAP ODP2 データソース '<DataSourceName>' は現在別のサブスクリプションによって駆動されています: SAP 側の現在の !deltatoken は '<DeltaToken>' ですが、ローカル状態には '<DeltaToken>' が保存されています。続行するとデルタポインタが暗黙的にリセットされ、宛先で行が重複します。このパイプラインを削除して新しいパイプラインを開始し、初回ロードを再確立するか、SAP トランザクション /WKTO/ODP_SUBS を使用して競合しているパイプラインと調整し、スロットを解放してください。

発生理由 ​

このパイプラインの差分サブスクリプションが、トランザクション /WKTO/ODP_SUBS を使って SAP 上で手動終了され、その後、同じデータソースに対して別のパイプラインが増分同期を開始しました。その結果、このパイプラインの差分抽出が破綻します。

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

サブスクリプションに差分エントリがない一方で、パイプライン側には差分トークンが残っている ​

抽出中に次のエラーが表示される場合があります。

サービス '<ServiceName>' に対する SAP ODP2 サブスクリプションにはデルタエントリが存在しない一方で、ローカル状態には !deltatoken '<DeltaToken>' が保持されています。別のパイプラインまたは SAP オペレーターがサブスクリプションを終了しており、続行することはできません。このパイプラインを削除して新しいパイプラインを開始し、初回ロードを再確立するか、SAP トランザクション /WKTO/ODP_SUBS を使用してパイプラインを再作成する前に現在のサブスクリプション所有者を確認してください。

発生理由 ​

このパイプラインの差分サブスクリプションが、トランザクション /WKTO/ODP_SUBS を使って SAP 上で手動終了されました。その結果、このパイプラインの差分抽出が破綻します。

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

スキーマエラー ​

このセクションでは、ODP データソース構造の変更に関連する問題について説明します。

ソース側で主キーが変更された ​

抽出中に次のエラーが表示される場合があります。

プライマリキーがソース側で (<OldKeyFields>) から (<NewKeyFields>) に変更されています。オブジェクトを再同期してください。

発生理由 ​

SAP でデータソースのキー項目が変更されました。

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

次回の同期時に、パイプラインが宛先テーブルを変更します。

抽出エラー ​

このセクションでは、SAP におけるデータ抽出およびサービス構成に関連する問題について説明します。

パッケージが抽出中で再読み取りできない ​

抽出中に次のエラーが表示される場合があります。

General SAP error RSODP_ODATA/012: Could not fetch data via extraction API RODPS_REPL_ODP_FETCH_XML (Package <PackageNumber> is being extracted and therefore cannot be read again), httpCode = 400 BAD_REQUEST

発生理由 ​

SAP がデータパッケージを抽出する際に問題が発生しました。

トラブルシューティング方法 ​

パイプラインを再実行します。

名前空間に対するサービスが見つからない ​

抽出中に次のエラーが表示される場合があります。

サービスが見つかりません: namespace , name <ServiceName>, version 0001

発生理由 ​

トランザクション /WKTO/ODP_CONFIG でデータソースに設定されたサービス名または URL が正しくありません。

トラブルシューティング方法 ​

問題を解決するには、次の手順を実行します。

接続タイムアウト ​

抽出中に、次のいずれかのエラーが発生する場合があります。

General SAP error UNKNOWN: , httpCode = 500, httpCode = 500 INTERNAL_SERVER_ERROR

コネクションのタイムアウト

発生理由 ​

SAP サーバーが、抽出レスポンスを返す前にコネクションをクローズしました。設定されているページサイズに対して、ICM タイムアウトが短すぎる場合に発生します。

トラブルシューティング方法 ​

最初にコネクションのタイムアウト値を増やします。エラーが解消しない場合は、ページサイズを小さくします。

現在のタイムアウトがそれより短い場合に、コネクションのタイムアウトを 10 分に増やすには、次の手順を実行します。

エラーが解消しない場合にページサイズを減らすには、次の手順を実行します。

ページサイズを小さくすると、全体的な抽出スループットが低下します。

SAPトランザクションリファレンス ​

このガイド全体で、次のSAPトランザクションおよびサービスが参照されています。