ドキュメント

無効なスキーマ参照が原因でストリーミング取得が失敗する

Last update: Tue Jan 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Adobe Experience Platformでは、ストリーミングエンドポイントを使用した場合、ストリーミング取得が失敗する可能性があります。 このエラーは、データセットのスキーマ参照に一致しないため、メッセージを検証できないことを示しています。 この問題は、ペイロードのスキーマ参照が正しくないか、形式が正しくない場合に発生します。多くの場合、コピー/貼り付け操作時に（UI からスキーマペイロードをコピーを使用して）余分な文字が発生することが原因です。 スキーマ参照を修正すると、検証エラーが解決し、データ取り込みを続行できます。 これを修正するには、ペイロードの schemaRef.id を確認し、不要な文字を削除して、修正したリクエストを再送信します。

説明 description

環境

Adobe Experience Platform

問題/症状

  • ストリーミング取得の試行は、検証エラーで失敗します。
  • このエラーメッセージは、メッセージがデータセットのスキーマ参照に一致しないことを示しています。
  • 失敗したレコードは、schemaRef のスキーマ URL の末尾に予期しない URL エンコードされた二重引用符（%22）が含まれていることを示しています。

解決策 resolution

この問題を修正するには、次の手順に従います。

  1. AEPでストリーミング取得用に送信されたペイロードを確認します。
  2. ヘッダーセクションを調べ、schemaRef.id の値を見つけます。
  3. URL エンコードされた二重引用符（schemaRef.id）など、%22 の末尾の不要な文字を削除します。
  4. 追加の文字を含めずに、schemaRef.id がデータセットで想定されるスキーマ URL と一致することを確認します。
  5. 修正されたヘッダーでストリーミングペイロードを再送信します。
  6. データの取り込みが成功し、検証エラーが発生していないことを確認します。

メモ： この問題は、他のソースから値をコピーする際に発生することがよくあります。これにより、誤って設定フィールドに不要な文字が取り込まれる可能性があります。 URL と識別子を API リクエストまたは設定ファイルで使用する前に、必ずアーティファクトをエンコードしていないことを確認してください。

関連資料

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f