よくある質問

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

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

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

「Error in CDI Sync」というメールが届いたのはなぜですか？

この種類のメールは通常、CDIの設定に問題があることを示しています。よくある問題とその解決方法を以下に示します。

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

CDIの認証情報が正しくないか、データウェアハウス側で誤って設定されている可能性があります。詳細については、ソースページの設定ステップを参照してください。

テーブルが見つからない

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

カタログが見つからない

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

「Row errors in your CDI sync」というメールが届いたのはなぜですか？

このメールは、同期中に一部のデータを処理できなかったことを示しています。具体的なエラーを確認するには、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 のテーブル設定を参照してください。

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

テスト接続はデータウェアハウス上で実行されるため、ウェアハウスの容量を増やすと速度が向上する場合があります。サーバーレス SQL インスタンスを使用すると、ウォームアップ時間が最小限に抑えられ、クエリのスループットが向上しますが、インテグレーションのコストがわずかに高くなる可能性があります。

ソースに固有のエラーメッセージについては、各ソースのページにあるトラブルシューティングのセクションを参照してください。

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 > 同期ログで、境界タイムスタンプにおける予期しない再同期量を監視します。

ウェアハウスでは次のようなチェックを使用します。

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に対して以下の対策を講じています。

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

お客様の対策

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

• 認証情報のアクセス権限は、CDIの動作に必要な最小限に制限してください。CDIでは、特定のテーブルとビューに対してselect（およびcount）を実行できる必要があります。
• テーブルにアクセスできるIPを、Brazeが公式に公開しているIPに制限してください。各ソースページに、そのソースで許可するIPが記載されています。