よくある質問

このページでは、クラウドデータ取り込みに関してよくある質問への回答を提供します。

CDI同期はどのくらいの頻度で実行できますか？

定期同期は最短5分ごとから最長月1回まで設定できます。デフォルトでは、ダッシュボードで設定可能な最短間隔は15分で、これはデータウェアハウスのコンピューティングコストとリクエスト量の管理に役立ちます。5分ごとに同期するには、Brazeサポートまたはカスタマーサクセスマネージャーにお問い合わせください。データの変更に応じてすぐに同期するには、同期をトリガーするエンドポイントを呼び出してください。詳細については、仕組みを参照してください。

「CDI同期エラー」というメールが届いたのはなぜですか？

このタイプのメールは、通常CDI設定に問題があることを意味します。以下に、一般的な問題とその解決方法を示します。

CDIが認証情報を使用してデータウェアハウスまたはテーブルにアクセスできない

これは、CDIの認証情報が正しくないか、データウェアハウス側で正しく設定されていないことを意味する場合があります。詳細については、データウェアハウスインテグレーションを参照してください。

テーブルが見つからない

正しいデータベース設定でインテグレーションを更新するか、database/tableなどの一致するリソースをデータウェアハウス上に作成してください。

カタログが見つからない

インテグレーションで設定されたカタログがBrazeカタログに存在しません。インテグレーションの設定後にカタログが削除された可能性があります。この問題を解決するには、インテグレーションを更新して別のカタログを使用するか、インテグレーションのカタログ名と一致する新しいカタログを作成してください。

「CDI同期で行エラーが発生しました」というメールが届いたのはなぜですか？

このタイプのメールは、同期中に一部のデータを処理できなかったことを意味します。具体的なエラーを確認するには、BrazeでCDI > 同期ログに移動してログを確認してください。

CDI設定で「Time must be string in ISO8601 Format」エラーを修正するには？

このエラーは、CDIペイロード内のイベントのtime値がサポートされている日時形式ではないことを意味します。

イベントおよび購入ペイロードの場合、timeを以下の形式でフォーマットしてください。

• ISO 8601文字列、または
• yyyy-MM-dd'T'HH:mm:ss:SSSZ

timeが省略された場合、Brazeはイベント時刻としてUPDATED_ATを使用します。

ペイロード要件の詳細については、Cloud Data Ingestionのテーブル設定を参照してください。

テスト接続やサポートメールのエラーを修正するにはどうすればよいですか？

• snowflake
• redshift
• bigquery
• databricks

CDI統合のメールアラート設定を更新するにはどうすればよいですか？

各統合には独自の通知設定があります。CDIページに移動し、更新したい統合名を選択します。通知設定セクションで、選択した統合に関するアラートの受信方法を更新できます。

「Incorrect Integration Object」エラーが表示されるのはなぜですか？

このエラーは、CDI統合の通知設定を更新しようとした際に、2つ以上のワークスペースが同じクラウドストレージバケットまたはフォルダーを指す統合を持っている場合に発生します。各クラウドストレージの場所は、一度に1つの統合でのみ使用できます。

これを解決するには、以下の手順に従ってください。

1. 同じストレージの場所を使用しているCDI統合が、他のどのワークスペースにあるかを確認します。
2. 競合している統合を、該当するワークスペースから削除するか再設定します。
3. 競合を解消した後、通知設定を更新できます。

エラーが表示されなくなり、通知設定を正常に更新できるようになります。問題が解決しない場合は、サポートチケットを送信してください。

将来のUPDATED_ATが統合で同期されるとどうなりますか？

CDIはUPDATED_ATを使用して新しいデータを判別します。将来のUPDATED_ATが同期されると、その将来の日時より前のデータは処理されません。これを修正するには、以下の手順に従ってください。

1. UPDATED_ATを修正します。
2. Brazeと既に同期された古いデータを削除します。
3. そのテーブルを再処理するための新しい統合を作成します。

「同期された行数」がウェアハウスの数値と一致しないのはなぜですか？

CDIはUPDATED_ATを使用して、同期中にどのレコードを取得するかを決定します。その仕組みについては、こちらの図解を参照してください。同期の実行開始時に、CDIはウェアハウスにクエリを実行して、以前に処理されたUPDATED_ATの値より後のUPDATED_ATを持つすべてのレコードを取得します。境界のタイムスタンプと完全に一致するレコードも、そのタイムスタンプを共有する新しい行がある場合は再同期される可能性があります。クエリの実行時に取得されたすべてのレコードはBrazeに同期されます。レコードが同期されない一般的なケースは以下のとおりです。

• すでに処理済みのUPDATED_AT値を持つレコードをテーブルに追加している場合。
• 同期による処理後にレコードの値を更新しているが、UPDATED_ATを変更していない場合。
• 同期の実行中にレコードを追加または更新している場合。CDIクエリの実行タイミングによっては、レコードが取得されない競合が発生する可能性があります。

ヒント

これらの動作を今後回避するために、単調に増加するUPDATED_AT値を使用し、スケジュールされた同期の実行中にテーブルを更新しないことをお勧めします。

大規模なCDIインポートでは、ほとんど一意のUPDATED_AT値が必要ですか？

はい。大量のデータ（たとえば約1,000万行を超える場合）を処理する場合、ソースデータのほとんどのUPDATED_AT値が一意であることを確認してください。同じタイムスタンプを共有する行が多すぎると、CDIが後続の実行で境界タイムスタンプの行を再選択する可能性が高くなります。これにより、重複同期やデータポイントの消費が増加する可能性があります。

CDIの境界動作の詳細については、重複タイムスタンプによる行の再同期を回避するを参照してください。

これらのSQLチェックはどこで実行しますか？

CDI統合で使用しているのと同じテーブルまたはビューに対して、データウェアハウスのSQLエディターで直接チェックを実行します。

• Snowflake: Projects > Worksheets（詳細については、Snowflake Worksheetsを参照してください）
• Redshift: Query Editor v2（詳細については、Using Amazon Redshift Query Editor v2を参照してください）
• BigQuery: BigQuery Studio SQLワークスペース（詳細については、BigQuery Studio introductionを参照してください）
• Databricks: SQLエディター（SQLウェアハウス）（詳細については、Databricks SQL editorを参照してください）
• Fabric: SQLクエリエディター

大規模な同期を有効化またはスケールする前に、このプロセスを使用してください。

1. 検証するCDIソーステーブルまたはビューと同期ウィンドウを特定します。
2. ウェアハウスのSQLエディターを開き、CDIで使用しているのと同じデータベースおよびスキーマを選択し、ソーステーブルまたはビューへの読み取りアクセス権を持つロールを使用します。
3. 一意のタイムスタンプ数クエリを実行して、そのウィンドウ内に存在する一意のUPDATED_AT値の数を測定します。
4. UPDATED_ATでグループ化して行数をカウントするクエリを実行し、異常に多い行数を持つタイムスタンプを見つけます。
5. 多くの行が同一のタイムスタンプを共有している場合、連続するバッチで段階的に新しいUPDATED_AT値を使用するようにインジェストプロセスを調整するか、タイムスタンプの精度を上げて行がより分散するようにします。
6. 集中が軽減されるまで両方のクエリを再実行し、その後同期を開始またはスケールします。
7. 開始後、CDI > Sync Logで境界タイムスタンプにおける予期しない再同期のボリュームを監視します。

ウェアハウスで次のようなチェックを使用してください。

1
2
3
4
5
6
7

SELECT
  COUNT(*) AS total_rows,
  COUNT(DISTINCT UPDATED_AT) AS distinct_timestamps,
  ROUND(COUNT(*) * 1.0 / NULLIF(COUNT(DISTINCT UPDATED_AT), 0), 2) AS avg_rows_per_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP);

1
2
3
4
5
6
7
8
9

SELECT
  UPDATED_AT,
  COUNT(*) AS rows_at_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP)
GROUP BY UPDATED_AT
ORDER BY rows_at_timestamp DESC
LIMIT 20;

ウェアハウスがLIMITをサポートしていない場合（たとえばFabric）、TOPなどの同等の構文を使用してください。

少数の行のCDI同期でも数分かかるのはなぜですか？

CDI同期には、行の処理が開始される前に固定のスタートアップ期間が含まれます。このスタートアップ時間は同期のサイズに関わらずほぼ同じであるため、少量の同期でも数分かかることがあり、1分あたりの処理行数が少なく見える場合があります。同期の合計時間は、ソースクエリの複雑さ、データの形状、およびデータウェアハウスの利用可能な容量に依存します。詳細については、データウェアハウス統合を参照してください。

同期中に、複数のレコードが同じIDを共有している場合、順序は保持されますか？

処理順序は100%予測可能ではありません。たとえば、同期中にテーブル内に同じEXTERNAL_IDを持つ複数の行がある場合、最終的なプロファイルにどの値が反映されるかは保証されません。ペイロード列で同じEXTERNAL_IDに対して異なる属性を更新している場合、同期が完了した時点ですべての変更が反映されます。

CDI同期から新しいユーザーが作成されないのはなぜですか？

CDI統合で既存ユーザーのみ更新オプションが有効になっている場合、Brazeに既に存在するユーザーのみが更新され、新しいユーザーは作成されません。つまり、同期テーブルの行が既存のBrazeユーザーと一致しないEXTERNAL_IDを参照している場合、その行はスキップされます。

CDIを通じて新しいユーザーを作成するには、統合設定で既存ユーザーのみ更新トグルをオフにしてください。データ設定 > クラウドデータ取り込みに移動し、統合を選択します。

CDIのセキュリティ対策とは？

Braze側の対策

Brazeでは、CDIに対して以下の対策を講じています。

• すべての認証情報はデータベース内で暗号化されており、認証されたアクセス権を持つ特定の従業員のみがアクセスできます。
• 暗号化された接続を使用して、顧客のデータウェアハウスにデータを送信します。
• 顧客に推奨しているものと同じAPIキーおよびTLS接続を使用して、Braze APIエンドポイントにリクエストを送信します。
• ライブラリを定期的に更新し、セキュリティパッチを適用しています。

お客様側の対策

お客様とチームの皆様には、以下のセキュリティ対策をお客様の環境で設定することをお勧めします。

• 認証情報のアクセスは、CDIの運用に必要な最小限に制限してください。CDIでは、特定のテーブルやビューに対してselect（およびcount）を実行できる必要があるためです。
• テーブルにアクセスできるIPを、公式に公開されているBraze IPに制限してください。