接続されたソース
接続されたソースは、Brazeのクラウドデータ取り込み (CDI) 機能を使ってデータを直接同期する方法に代わる、ゼロコピーの手段です。接続されたソースはデータウェアハウスに直接クエリを実行し、基盤となるデータをBrazeに一切コピーせずに新しいセグメントを作成します。
接続されたソースをBrazeワークスペースに追加すると、セグメントエクステンション内でCDIセグメントを作成できます。CDIセグメントエクステンションを使用すると、データウェアハウスに直接クエリを実行するSQLを記述し (CDI接続ソースを通じて利用可能になったデータを使用)、Braze内でターゲットにできるユーザーグループを作成・維持できます。
このソースでセグメントを作成する方法の詳細については、CDIセグメントエクステンションを参照してください。
接続されたソースはデータウェアハウス上で直接実行されるため、これらのクエリをデータウェアハウスで実行する際に発生するすべてのコストはお客様の負担となります。接続されたソースはデータポイントを記録せず、CDIセグメントエクステンションはSQLセグメントクレジットを消費しません。
サポートされているソース
接続ソースは、データウェアハウスソースでのみ利用できます。ファイルストレージソースは接続ソースに対応していません。
| ソース | 設定手順 |
|---|---|
| Snowflake | Snowflakeを接続ソースとして使用する |
| Amazon Redshift | Redshiftを接続ソースとして使用する |
| Google BigQuery | BigQueryを接続ソースとして使用する |
| Databricks | Databricksを接続ソースとして使用する |
| Microsoft Fabric | Microsoft Fabricを接続ソースとして使用する |
接続ソースを設定する
接続ソースの設定は、どのデータウェアハウスでも同じ4つの段階で進めます。認証情報、権限、SQL はソースごとに異なるため、正確なコマンドは各ソースのページを参照してください。
- データウェアハウスを設定します。 Braze が認証に使用する認証情報を作成し、クエリを実行したいテーブルへのアクセス権を付与します。接続ソースは1つ以上のテーブルを参照できるため、接続ソースに含めたいすべてのテーブルにアクセスする権限が Braze ユーザーにあることを確認してください。
- Braze で接続ソースを作成します。 データ設定 > クラウドデータ取り込み > 接続されたソース に移動し、データソースを追加 を選択してから、使用するソースを選択します。そのソースの認証情報と設定を入力します。
- ソースの詳細を設定します。 名前と最大実行時間を選択します。
- ウェアハウスの設定を完了してテストします。 Snowflake の場合、および SSH トンネルを使用する Redshift の場合は、Braze が生成する公開キーをウェアハウスのユーザーに追加します。その後、テスト接続、完了 の順に選択します。
ソースを「下書き」から「アクティブ」状態に移行するには、テストを正常に完了する必要があります。作成ページを閉じる必要がある場合でも統合は保存されるため、後で詳細ページに戻って変更やテストを行えます。
付与する権限
どのソースを使用する場合でも、Braze の認証情報には次の2種類のアクセス権が必要です。
- CDI セグメントエクステンションで使用したいテーブルまたはビューに対する読み取りアクセス権。スキーマまたはデータセット内のすべてのテーブルへのアクセス権を付与することも、特定のテーブルにのみ権限を付与することもできます。Braze がアクセスできるテーブルはすべて、CDI セグメントエクステンションでクエリに使用できます。
- スキーマに対するテーブル作成権限。これにより、Braze でセグメントを更新する前に、Braze が CDI セグメントエクステンションのクエリ結果をテーブルに書き込めるようになります。Braze はセグメントごとに一時テーブルを作成し、そのテーブルは Braze がセグメントを更新している間のみ保持されます。
接続ソースが作成されると、Braze はソーススキーマ内で認証情報がアクセスできるすべてのテーブルの名前と説明を検出します。
最大実行時間
接続ソースごとに最大実行時間を設定します。Braze は、この時間を超えたクエリを自動的に中止します。設定できる最大実行時間は60分です。実行時間を短くすると、ウェアハウスアカウントで発生するコストを削減できます。この設定は、このソースを通じて実行されるクエリ (このソースを使用する同期や CDI セグメントエクステンションを含む) に適用されます。
最大実行時間を60分に設定していてもクエリのタイムアウトが続く場合は、クエリの実行時間を最適化するか、Braze ユーザーにより多くのコンピューティングリソース (より大きなウェアハウスなど) を割り当てることを検討してください。
追加のソースを設定する (オプション)
Brazeでは複数の接続ソースを設定できますが、各ソースはそれぞれ異なるスキーマまたはデータセットに接続するように設定する必要があります。追加のソースを作成する際、同じデータウェアハウスアカウントに接続する場合は既存の認証情報を再利用できます。
Snowflakeの場合、統合間で同じユーザーとロールを再利用するのであれば、公開キーを再度追加する必要はありません。
接続されたソースの使用
ソースの作成後、そのソースを使用して1つ以上のCDIセグメントエクステンションを作成できます。このソースを使用したセグメントの作成について詳しくは、CDIセグメントエクステンションのドキュメントを参照してください。