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

SAP Data Agentでパイプラインを設定または実行する際の問題をトラブルシューティングするには、このガイドを使用します。このガイドでは、SAP Table ReaderおよびSAP BW Open Hub Destination（OHD）プラグインについて説明します。

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トランザクションリファレンス ​

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