よくある質問

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

「Row errors in your CDI sync」(CDI 同期の行エラー) というメールが届いた理由は何ですか?

この種のメールは通常、CDIの設定に問題があることを意味する。ここでは、よくある問題とその解決方法を紹介する：

CDI がお客様の認証情報を使用してデータウェアハウスやテーブルにアクセスできない

CDI の認証情報が正しくないか、データウェアハウスの設定が正しくない可能性があります。詳細については、データウェアハウスの連携を参照してください。

テーブルが見つからない

正しいデータベース構成を使用して連携を更新するか、データウェアハウスに database/table などの一致するリソースを作成してください。

カタログが見つからない

統合で設定されたカタログは、Braze カタログには存在しません。カタログは、連携の設定後に削除できます。この問題を解決するには、別のカタログを使用するように統合を更新するか、統合のカタログ名と一致する新しいカタログを作成する。

「Row errors in your CDI sync」(CDI 同期の行エラー) というメールが届いた理由は何ですか?

この種のメールは、同期中にデータの一部が処理できなかったことを意味する。具体的なエラーを調べるために、Braze の [CDI] > [同期ログ] でログを確認できます。

テスト接続とサポート・メールのエラーを修正するには？

• snowflake
• redshift
• bigquery
• databricks

CDI統合のメールアラート設定を更新するには？

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

将来的に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クエリの実行タイミングによっては、レコードがピックアップされないレースコンディションが発生する可能性がある。

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

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

CDIのセキュリティ対策はどうなっているのか？

当社の取り組み

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

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

お客様の対策

お客様と社内チームで、御社側に以下のセキュリティ対策を講じることをお勧めします。

• 認証情報へのアクセスを、CDI の運用に必要な最小限に制限します。これは、特定のテーブルとビューに対してセレクト（とカウント）を実行できるようにする必要があるからだ。
• テーブルにアクセスできる IP を、正式に公開されたBraze IP に制限します。