プロファイルインポートエラーとトラブルシューティング
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要機能の利用可能性は段階的に展開される一環です。あなたの組織はまだこの機能に気づいていないかもしれません。環境が導入された際に利用可能になります。
このトピックでは、バッチ状態、レコードレベルのエラーコード、HTTPエラー応答、そしてプロファイルインポート時に直面する一般的な問題について説明します。
バッチ状態
バッチはライフサイクル中に以下の状態を通過します:
州
概要
QUEUED
ファイルは正常にアップロードされ、現在処理のためにピックアップ待ちです。
RUNNING
バッチは処理中です。記録は読み取られ、検証され、インポートされています。
COMPLETED
バッチ内のすべてのレコードはエラーゼロで正常に処理されました。
COMPLETED_WITH_ERRORS
処理は完了しましたが、少なくとも1つのレコードが失敗しました。結果ファイルをダウンロードして、どの記録が失敗したのか、その理由を特定してください。
FAILED
すべての再試行を果たした後、システムのエラーによりバッチは失敗しました。
!注処理中にシステムエラーが発生した場合、システムは最大3回まで自動的にバッチを再試行します。3回の失敗後、バッチは永久にFAILED状態に移動します。
レコードレベルのエラーコード
処理中に個々のレコードが失敗した場合、各失敗したレコードにはエラーコードが結果ファイルに含まれます。以下の表はエラーコードとその原因を示しています。
エラーコード
原因
解決
INVALID_RECORD
記録が歪んでいる。一般的な原因は、JSONの不具合、 recordTypeの欠如または無効、配列 identifiersの欠如または非配列、有効な識別子の不存在(設定された識別ルールに一致する provider がない、または空の id)、 id フォーマットの無効(有効なUUIDでない)、または contact または extensions フィールドの配列値などです。
入力レコードを修正してください。 recordType が profileに設定されているか identifiers 、少なくとも1つの有効なエントリが含まれ、ペイロードに配列が含まれていないか確認してください。
NO_UPDATABLE_FIELDS
レコードペイロードは空であるか、すべてのフィールドが nullです。プロフィールに書くべきことは何もありません。
contactまたはextensionsに少なくとも1つの非ヌルフィールドを追加します。
INCONSISTENT_IDENTIFIERS
レコードの識別子は複数の既存のプロファイルに解像度されます。システムはどのプロファイルを更新すべきかを判断できません。
記録内の識別子を確認してください。一貫して単一のプロフィールを指し示すようにしてください。重複したプロフィールを整理したり、識別子を調整したりする必要があるかもしれません。
WRITE_FAILED
すべての再写を使い果たした後、レコードをデータストアに書き込む際にシステムエラーが発生しました。
これは通常、過渡的な誤差です。バッチを再度アップロードして再試行してください。エラーが続く場合は Sitecoreサポートに連絡してください。
HTTPエラー応答
以下の表は、プロファイルインポートAPIが返すことができるHTTPエラーを示しています。
ステータスコード
終着点
原因
400 Bad Request
アップロード
MD5のチェックサムがアップロードされたファイルと一致しないか、ファイルが空のままです。
401 Unauthorized
全員
リクエストには有効なAPIキーが含まれていません。
403 Forbidden
全員
APIキーはこの操作を行う権限を持っていません。
404 Not Found
状況、統計、結果
指定された batchId は存在しないか、結果がまだ入手可能ではありません。
429 Too Many Requests
アップロード
キューの上限に達しました。バッチはすでにあなたの環境でキューに入れられているか実行中です。現在のバッチが完了するまで次のアップロードを待ちましょう。
再試行の動作
プロファイルインポートには、2つのレベルで自動再試行処理が含まれています:
-
Batch-level retries - バッチが処理中にシステムエラーに遭遇した場合、システムは自動的にバッチを再試行します。バッチはQUEUED状態に戻り、スケジューラーによって再度拾われます。バッチは最大3回まで再試され、その後永久にFAILEDとしてマークされます。
再試行は冪等性です。以前の試みですでに処理されたレコードは再処理されません。システムはそれらをスキップし、未完了の記録のみを処理します。
-
レコードレベルのエラー処理 - 個々のレコードの失敗がバッチを停止させることはありません。レコードの検証や処理に失敗した場合、システムはエラーを記録し、残りのレコードの処理を続けます。すべてのレコードレベルの失敗は、結果ファイルをダウンロードするかバッチ統計を確認することで確認できます。