xDB Data Migration ツール3.0.0~4.0.0を使用している場合、Sitecore アナリティクス データをSitecore XP 8.xからSitecore XP 9.xに移行する際に、未処理の例外で失敗する場合があります。この問題は、xConnectが特定の時間以内に応答しない場合に発生します(デフォルトでは30秒以上)。問題が発生した場合、ログに以下のメッセージが記録されます:
An error occurred while sending the request. (pipeline: Process Single Contact from MongoDB Pipeline, pipeline step: Add Contact Model to xConnect Batch, pipeline step identifier: 46ebebbf-250f-4bc2-a5f2-e4a64b58e561)
A task was canceled. (pipeline: Process Single Contact from MongoDB Pipeline, pipeline step: Add Contact Model to xConnect Batch, pipeline step identifier: 46ebebbf-250f-4bc2-a5f2-e4a64b58e561)
この問題を解決するには、以下のいずれかを検討してください:
- Sitecore XP 9.0.0 ~ 9.1.1の場合、インスタンスをSitecore XP 9.2またはSitecore XP 9.3にアップグレードしてから続行します。
- Sitecore XP 9.2およびSitecore XP 9.3の場合、以下の手順を実行します:
- 貴社の製品バージョンに対応するhotfixをダウンロードして、コンテンツ管理・スタンドアロン サーバーにインストールします:
Sitecore XP 9.2の場合: SC Hotfix 391475-1 Sitecore Data Exchange Framework 3.0.1.zip
Sitecore XP 9.3の場合: SC Hotfix 426890-1 Sitecore Data Exchange Framework 4.0.0.zip
このhotfixを使用すると、xConnect 接続のタイムアウトを構成でき、新しい例外処理が導入されます。
- [テナント]/Endpoints/Providers/xConnect/xConnect Client Endpoint に移動し、Collection Service タイムアウト フィールドの値を30を超える値(たとえば100など)に設定して、xConnect 接続のタイムアウトを増やします。
- xConnect 例外が発生したときに移行を続行する必要がある場合、以下の各アイテムに移動し、各アイテムでProceed On Exception チェックボックスをオンにします:
- [テナント]/Pipelines/MongoDB Contacts to xConnect Migration Pipelines/Process Single Contact from MongoDB Pipeline/Add Contact Model to xConnect Batch
- [テナント]/Pipelines/MongoDB Contacts to xConnect Migration Pipelines/Process Single Device from MongoDB Pipeline/Add Device Profile Model to xConnect Batch
- [テナント]/Pipelines/MongoDB Contacts to xConnect Migration Pipelines/Process Single Interaction from MongoDB Pipeline/Add Interaction Model to xConnect Batch
- [テナント]/Pipelines/MongoDB Contacts to xConnect Migration Pipelines/Read Contacts from MongoDB Pipeline/Submit Remaining Operations in xConnect Batch
注意:バッチの送信時に例外が発生した場合、データは再度処理されません。