ドキュメントExperience Cloud KCS

タイムスタンプマッピングエラーによりBigQueryの読み込みに失敗する（CONNECTOR-2001-500 | MAPPER-3700-199）

最終更新日： 2026年6月24日

ネイティブコネクタを介してBigQuery テーブルをAdobe Experience Platform（AEP）に読み込むと、タイムスタンプフィールドマッピングエラーが発生して失敗します。 同じデータセットがCSVまたはFTPを通じて正常に取り込まれるため、BigQuery データフローでのタイムスタンプ処理に対する問題が分離されます。 この問題を解決するには、タイムスタンプ形式をスキーママッピングに合わせます。

説明 description

環境

  • 商品： Adobe Experience Platform （AEP）
  • シナリオ： BigQuery ネイティブ ソース コネクタの取り込み

問題/症状

  • ネイティブコネクタを使用したBigQuery テーブルの読み込みは、取り込み中に失敗します。
  • プロセスはエラー​ CONNECTOR-2001-500 （処理/解析/検証/変換のエラー） ​を返します。
  • 診断レポートのタイムスタンプフィールド変換警告にエラー​ "code": “MAPPER-3700-199”, “description”: “フィールド変換警告”、およびエラー呼び出し日（java.lang.String,java.lang.String）を示す詳細が原因：日付22:30:00 ESTをyyy-MM-dd HHss zzz ​形式で解析できません。
  • CSVまたはFTPを介した同一データの読み込みは、エラーなしで正常に完了します。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. タイムスタンプフィールドがAdobe Experience Platform スキーマで「必須」としてマークされているかどうかを確認します。 この要件が必要でない場合は、必須 オプションのチェックを外します。
  2. ソース BigQuery テーブルにタイムスタンプ列が含まれており、列がデータ準備で正しくマッピングされていることを確認します。
  3. タイムスタンプ列のnull値または空の値について、ソースデータを確認します。 データを修正するか、影響を受ける行を削除します。
  4. すべてのタイムスタンプ値がRFC 3339またはISO 8601形式（例：2024-01-15T10:00:00Z）に従っていることを確認します。
  5. BigQuery コネクタを使用して、修正したバッチを再インポートします。
  6. インポートが正常に完了し、タイムスタンプ関連のエラーがレポートされないことを確認します。

メモ：問題が解決しない場合は、変換ロジックを確認し、追加のエラーメッセージで詳細を確認してください。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles