このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

接続されたソース

接続されたソースは、Brazeのクラウドデータ取り込み (CDI) 機能を使ってデータを直接同期する方法に代わる、ゼロコピーの手段です。接続されたソースはデータウェアハウスに直接クエリを実行し、基盤となるデータをBrazeに一切コピーせずに新しいセグメントを作成します。

接続されたソースをBrazeワークスペースに追加すると、セグメントエクステンション内でCDIセグメントを作成できます。CDIセグメントエクステンションを使用すると、データウェアハウスに直接クエリを実行するSQLを記述し (CDI接続ソースを通じて利用可能になったデータを使用)、Braze内でターゲットにできるユーザーグループを作成・維持できます。

このソースでセグメントを作成する方法の詳細については、CDIセグメントエクステンションを参照してください。

警告

接続されたソースはデータウェアハウス上で直接実行されるため、これらのクエリをデータウェアハウスで実行する際に発生するすべてのコストはお客様の負担となります。接続されたソースはデータポイントを記録せず、CDIセグメントエクステンションはSQLセグメントクレジットを消費しません。

接続されたソースの統合

ステップ1：リソースを接続する

Cloud Data Ingestion の接続されたソースを使うには、Braze 側とお使いのインスタンス側の両方で設定が必要です。次の手順に従って統合を設定してください。一部の手順はデータウェアハウスで、一部の手順は Braze ダッシュボードで行います。

データウェアハウスで行う手順

ロールを作成し、スキーマ内でテーブルをクエリおよび作成する権限を付与します。
ウェアハウスを設定し、そのロールにアクセス権を付与します。
Workload Identity Federation または RSA キーペアを使用して、そのロール用のユーザーを作成します。
構成によっては、Snowflake のネットワークポリシーで Braze の IP を許可する必要があります。

Braze ダッシュボードで行う手順

Braze ダッシュボードで新しい接続されたソースを作成します。
接続されたソースの同期の詳細を設定します。
RSA キーペアの場合は、公開キーを取得します。Workload Identity Federation の場合は、認証情報フォームからステートメントをコピーします。

データウェアハウスで行う手順

RSA キーペアの場合は、公開キーを認証用の Snowflake ユーザーに追加します。Workload Identity Federation の場合は、Snowflake のワークシートでステートメントを実行します。完了したら、接続されたソースを使用して 1 つ以上の CDI セグメントエクステンションを作成できます。

Redshift 環境でソースデータと必要なリソースを設定します。
Braze ダッシュボードで新しい接続されたソースを作成します。
統合をテストします。
接続されたソースを使用して、1 つ以上の CDI セグメントエクステンションを作成します。

BigQuery 環境でソースデータと必要なリソースを設定します。
Braze が Workload Identity Federation またはサービスアカウントキーを介してアクセスするサービスアカウントを作成し、同期したいデータを含む BigQuery プロジェクトとデータセットへのアクセスを許可します。
Braze ダッシュボードで新しい接続されたソースを作成します。
統合をテストします。
接続されたソースを使用して、1 つ以上の CDI セグメントエクステンションを作成します。

Databricks 環境でソースデータと必要なリソースを設定します。
OAuth マシン間 (M2M) 認証用のサービスプリンシパル、または個人用アクセストークンを作成し、同期したいデータを含む Databricks のカタログとスキーマへのアクセスを許可します。
Braze ダッシュボードで新しい接続されたソースを作成します。
統合をテストします。
接続されたソースを使用して、1 つ以上の CDI セグメントエクステンションを作成します。

重要

Braze が Classic および Pro SQL インスタンスに接続する際、2〜5 分のウォームアップ時間が発生することがあります。これにより、接続の設定やテスト、および CDI セグメントエクステンションの作成や更新の際に遅延が生じます。サーバーレス SQL インスタンスを使用すると、ウォームアップ時間を最小限に抑え、クエリのスループットを向上できますが、統合コストがやや高くなる場合があります。

サービスプリンシパルを作成し、統合に使用する Fabric ワークスペースへのアクセスを許可します。
Fabric ワークスペースでソースデータを設定し、サービスプリンシパルに権限を付与します。
Braze ダッシュボードで新しい接続されたソースを作成します。
統合をテストします。
接続されたソースを使用して、1 つ以上の CDI セグメントエクステンションを作成します。

ステップ2：データウェアハウスを設定する

データウェアハウス環境でソースデータと必要なリソースを設定します。接続されたソースは 1 つ以上のテーブルを参照できるため、接続されたソースに含めたいすべてのテーブルにアクセスする権限が Braze ユーザーにあることを確認してください。

ステップ2.1：ロールを作成して権限を付与する

接続されたソースで使用するロールを作成します。このロールは、CDI セグメントエクステンションで利用可能なテーブルの一覧を生成するため、およびソーステーブルをクエリして新しいセグメントを作成するために使用されます。接続されたソースが作成されると、Braze はソーススキーマ内でユーザーが利用できるすべてのテーブルの名前と説明を検出します。

スキーマ内のすべてのテーブルへのアクセスを付与することも、特定のテーブルにのみ権限を付与することもできます。Braze ロールがアクセスできるテーブルはすべて、CDI セグメントエクステンションでクエリできるようになります。

create table 権限は、Braze でセグメントを更新する前に、Braze が CDI セグメントエクステンションのクエリ結果を含むテーブルを作成できるようにするために必要です。Braze はセグメントごとに一時テーブルを作成し、そのテーブルは Braze がセグメントを更新している間だけ保持されます。

CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT CREATE TABLE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

ステップ2.2：ウェアハウスを設定し、Braze ロールにアクセス権を付与する

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

注

ウェアハウスでは auto-resume フラグをオンにする必要があります。オンになっていない場合は、クエリを実行する際に Braze がウェアハウスを起動できるよう、ウェアハウスに対する追加の OPERATE 権限を Braze に付与する必要があります。

ステップ2.3：ユーザーを設定する

Braze は Workload Identity Federation または RSA キーペアを使用して Snowflake に認証します。既存の RSA キーペアの認証情報は引き続き機能し、移行する必要はありません。いずれか 1 つの方法に従ってください。

workload identity federation
key pair

ステップ2.1とステップ2.2のロールとウェアハウスの権限付与を使用します。Snowflake アカウントでネットワークポリシーを使用している場合は、ステップ2.4の説明に従って Braze の IP アドレスを許可してください。

Snowflake の認証情報フォームからサービスユーザーを作成し、そのステートメントを Snowflake のワークシートで実行します。ステートメントの内容と実行場所については、Workload Identity Federation 用に Snowflake を設定するを参照してください。

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

後のステップで、接続情報を Braze と共有し、ユーザーに追加する公開キーを受け取ります。

注

異なるワークスペースを同じ Snowflake アカウントに接続する場合は、統合を作成する Braze ワークスペースごとに一意のユーザーを作成する必要があります。1 つのワークスペース内では同じユーザーを複数の統合で再利用できますが、同じ Snowflake アカウントのユーザーが複数のワークスペースで重複していると、統合の作成は失敗します。

ステップ2.4：Snowflake のネットワークポリシーで Braze の IP を許可する (オプション)

Snowflake アカウントの構成によっては、Snowflake のネットワークポリシーで次の IP アドレスを許可する必要があります。この方法の詳細については、ネットワークポリシーの変更に関する Snowflake の関連ドキュメントを参照してください。

インスタンスUS-01、US-02、US-03、US-04、US-05、US-06、US-07の場合、関連するIPアドレスは次のとおりです。

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

インスタンスUS-08の場合、関連するIPアドレスは次のとおりです。

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

インスタンスUS-10の場合、関連するIPアドレスは次のとおりです。

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

インスタンスEU-01とEU-02の場合、関連するIPアドレスは次のとおりです。

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

インスタンスAU-01の場合、関連するIPアドレスは次のとおりです。

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

インスタンスID-01の場合、関連するIPアドレスは次のとおりです。

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

インスタンスJP-01の場合、関連するIPアドレスは次のとおりです。

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

インスタンスKR-01の場合、関連するIPアドレスは次のとおりです。

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

ステップ2.1：ユーザーを作成して権限を付与する

CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT CREATE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

接続されたソースで使用するユーザーを作成します。このユーザーは、CDI セグメントエクステンションで利用可能なテーブルの一覧を生成するため、およびソーステーブルをクエリして新しいセグメントを作成するために使用されます。接続されたソースが作成されると、Braze はソーススキーマ内でユーザーが利用できるすべてのテーブルの名前と説明を検出します。複数の CDI 統合を作成する場合は、スキーマに権限を付与するか、グループを使用して権限を管理するとよいでしょう。

スキーマ内のすべてのテーブルへのアクセスを付与することも、特定のテーブルにのみ権限を付与することもできます。Braze ロールがアクセスできるテーブルはすべて、CDI セグメントエクステンションでクエリできるようになります。新しいテーブルを作成したときは必ずユーザーにアクセス権を付与するか、ユーザーにデフォルトの権限を設定してください。

ステップ2.2：Braze の IP へのアクセスを許可する

ファイアウォールやその他のネットワークポリシーを使用している場合は、Redshift インスタンスへのネットワークアクセスを Braze に許可する必要があります。Braze ダッシュボードのリージョンに対応する次の IP からのアクセスを許可してください。

また、Braze が Redshift のデータにアクセスできるよう、セキュリティグループを変更する必要がある場合もあります。次のセクションに記載されている IP と、Redshift クラスターのクエリに使用するポート (デフォルトは 5439) でのインバウンドトラフィックを明示的に許可してください。インバウンドルールが「すべて許可」に設定されている場合でも、このポートでの Redshift の TCP 接続を明示的に許可する必要があります。さらに、Braze がクラスターに接続するためには、Redshift クラスターのエンドポイントがパブリックにアクセス可能であることが重要です。

Redshift クラスターをパブリックにアクセス可能にしたくない場合は、VPC と EC2 インスタンスを設定し、SSH トンネルを使用して Redshift のデータにアクセスできます。詳細については、AWS: How do I access a private Amazon Redshift cluster from my local machine? を参照してください。

インスタンスUS-01、US-02、US-03、US-04、US-05、US-06、US-07の場合、関連するIPアドレスは次のとおりです。

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

インスタンスUS-08の場合、関連するIPアドレスは次のとおりです。

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

インスタンスUS-10の場合、関連するIPアドレスは次のとおりです。

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

インスタンスEU-01とEU-02の場合、関連するIPアドレスは次のとおりです。

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

インスタンスAU-01の場合、関連するIPアドレスは次のとおりです。

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

インスタンスID-01の場合、関連するIPアドレスは次のとおりです。

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

インスタンスJP-01の場合、関連するIPアドレスは次のとおりです。

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

インスタンスKR-01の場合、関連するIPアドレスは次のとおりです。

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

ステップ2.1：Braze 用の認証情報を作成する

Braze がテーブルに接続してデータを読み取るために使用するサービスアカウントを GCP で作成します。サービスアカウントには、次の権限が必要です。

BigQuery Connection User: Braze が接続を確立できるようにします。
BigQuery User: クエリの実行、データセットのメタデータの読み取り、テーブルの一覧表示を行うためのアクセス権を Braze に付与します。
BigQuery Data Viewer: データセットとその内容を表示するためのアクセス権を Braze に付与します。
BigQuery Job User: ジョブを実行するためのアクセス権を Braze に付与します。
bigquery.tables.create セグメントの更新中に一時テーブルを作成するためのアクセス権を Braze に付与します。

接続されたソースで使用するサービスアカウントを作成します。このユーザーは、CDI セグメントエクステンションで利用可能なテーブルの一覧を生成するため、およびソーステーブルをクエリして新しいセグメントを作成するために使用されます。接続されたソースが作成されると、Braze はソーススキーマ内でユーザーが利用できるすべてのテーブルの名前と説明を検出します。

データセット内のすべてのテーブルへのアクセスを付与することも、特定のテーブルにのみ権限を付与することもできます。Braze ロールがアクセスできるテーブルはすべて、CDI セグメントエクステンションでクエリできるようになります。

Braze は Workload Identity Federation またはサービスアカウントキーを使用してサービスアカウントにアクセスできます。既存のサービスアカウントキーの認証情報は引き続き機能し、移行する必要はありません。1 つの Workload Identity Federation の認証情報で、BigQuery と Google Cloud Storage の両方のソースに対応できます。

workload identity federation
service account key

Workload Identity プール、プロバイダー、サービスアカウントを設定し、Braze のプリンシパルをサービスアカウントにバインドします。手順については、Workload Identity Federation 用に Google Cloud を設定するを参照してください。別の BigQuery または Google Cloud Storage のソース用にすでに Workload Identity Federation を設定している場合は、繰り返す必要はありません。既存のサービスアカウントに、このステップに記載されている権限を付与してください。

サービスアカウントを作成して権限を付与したら、JSON キーを生成します。詳細については、Google Cloud: Create and delete service account keys を参照してください。このキーは後で Braze ダッシュボードにアップロードします。

ステップ2.2：Braze の IP へのアクセスを許可する

ネットワークポリシーを設定している場合は、BigQuery インスタンスへのネットワークアクセスを Braze に許可する必要があります。Braze ダッシュボードのリージョンに対応する次の IP からのアクセスを許可してください。

インスタンスUS-01、US-02、US-03、US-04、US-05、US-06、US-07の場合、関連するIPアドレスは次のとおりです。

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

インスタンスUS-08の場合、関連するIPアドレスは次のとおりです。

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

インスタンスUS-10の場合、関連するIPアドレスは次のとおりです。

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

インスタンスEU-01とEU-02の場合、関連するIPアドレスは次のとおりです。

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

インスタンスAU-01の場合、関連するIPアドレスは次のとおりです。

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

インスタンスID-01の場合、関連するIPアドレスは次のとおりです。

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

インスタンスJP-01の場合、関連するIPアドレスは次のとおりです。

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

インスタンスKR-01の場合、関連するIPアドレスは次のとおりです。

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

ステップ2.1：Braze 用の認証情報を作成する

Braze は、サービスプリンシパルを使用した OAuth マシン間 (M2M) 認証、または個人用アクセストークンを使用して Databricks に接続できます。Braze では OAuth M2M を推奨しています。既存の個人用アクセストークンの認証情報は引き続き機能し、移行する必要はありません。

どちらの方法を選択した場合でも、Braze はこれらの認証情報を使用して、CDI セグメントエクステンションで利用可能なテーブルの一覧を生成し、ソーステーブルをクエリして新しいセグメントを作成します。接続されたソースが作成されると、Braze はソーススキーマ内でユーザーが利用できるすべてのテーブルの名前と説明を検出します。

CREATE TABLE 権限は、Braze でセグメントを更新する前に、Braze が CDI セグメントエクステンションのクエリ結果を含むテーブルを作成できるようにするために必要です。Braze はセグメントごとに一時テーブルを作成し、そのテーブルは Braze がセグメントを更新している間だけ保持されます。

oauth m2m
personal access token

サービスプリンシパルを作成し、クライアントシークレットを生成して、SQL ウェアハウスに対する Can use 権限をサービスプリンシパルに付与します。手順については、Braze 用の認証情報を作成するを参照してください。
接続されたソースに使用するスキーマへのアクセス権 (CREATE TABLE を含む) をサービスプリンシパルに付与します。付与先には、サービスプリンシパルのアプリケーション ID (クライアント ID と同じ値) を使用します。

GRANT USE CATALOG ON CATALOG `BRAZE-CLOUD-PRODUCTION` TO `APPLICATION_ID`;
GRANT USE SCHEMA, CREATE TABLE ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;
GRANT SELECT ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;

APPLICATION_ID をサービスプリンシパルのアプリケーション ID に置き換えてください。

認証情報の作成ステップで Braze ダッシュボードに入力するまで、クライアント ID とシークレットを安全な場所に保管してください。

Databricks ワークスペースで、上部のバーにある Databricks のユーザー名を選択し、ドロップダウンから User Settings を選択します。
接続されたソースに使用するスキーマに対して、サービスアカウントが CREATE TABLE 権限を持っていることを確認します。
Access tokens タブで、Generate new token を選択します。
このトークンを識別しやすいコメント (「Braze CDI」など) を入力し、Lifetime (days) ボックスを空欄のままにして、トークンの有効期限を無期限に変更します。
Generate を選択します。
表示されたトークンをコピーし、Done を選択します。

認証情報の作成ステップで Braze ダッシュボードに入力するまで、トークンを安全な場所に保管してください。

ステップ2.2：Braze の IP へのアクセスを許可する

ネットワークポリシーを設定している場合は、Databricks インスタンスへのネットワークアクセスを Braze に許可する必要があります。Braze ダッシュボードのリージョンに対応する次の IP からのアクセスを許可してください。

インスタンスUS-01、US-02、US-03、US-04、US-05、US-06、US-07の場合、関連するIPアドレスは次のとおりです。

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

インスタンスUS-08の場合、関連するIPアドレスは次のとおりです。

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

インスタンスUS-10の場合、関連するIPアドレスは次のとおりです。

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

インスタンスEU-01とEU-02の場合、関連するIPアドレスは次のとおりです。

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

インスタンスAU-01の場合、関連するIPアドレスは次のとおりです。

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

インスタンスID-01の場合、関連するIPアドレスは次のとおりです。

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

インスタンスJP-01の場合、関連するIPアドレスは次のとおりです。

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

インスタンスKR-01の場合、関連するIPアドレスは次のとおりです。

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

ステップ2.1：Fabric リソースへのアクセスを許可する

Braze は、Entra ID 認証を使用するサービスプリンシパルで Fabric ウェアハウスに接続します。Braze が使用する新しいサービスプリンシパルを作成し、必要に応じて Fabric リソースへのアクセスを許可します。Braze が接続するには、次の詳細が必要です。

AzureアカウントのテナントID（ディレクトリとも呼ばれます）
サービスプリンシパルのプリンシパルID（アプリケーションIDとも呼ばれます）
Brazeが認証に使用するクライアントシークレット

Azureポータルで、Microsoft Entra管理センターに移動し、App Registrationsを選択します。
Identity > Applications > App registrationsの下にある+ New registrationを選択します。
名前を入力し、サポートされるアカウントの種類としてAccounts in this organizational directory onlyを選択します。次に、Registerを選択します。
作成したアプリケーション（サービスプリンシパル）を選択し、Certificates & secrets > + New client secretに移動します。
シークレットの説明を入力し、シークレットの有効期限を設定します。次に、Addを選択します。
作成されたクライアントシークレットをメモしておき、Brazeの設定で使用します。

注

Azure では、サービスプリンシパルのシークレットに無期限の有効期限を設定できません。Braze へのデータの流れを維持するため、認証情報の有効期限が切れる前に必ず更新してください。

ステップ2.2：Fabric リソースへのアクセスを許可する

Braze が Fabric インスタンスに接続するためのアクセス権を付与します。Fabric の管理ポータルで、Settings > Governance and insights > Admin portal > Tenant settings に移動します。

Developer settings で「Service principals can use Fabric APIs」を有効にし、Braze が Microsoft Entra ID を使用して接続できるようにします。
OneLake settings で「Users can access data stored in OneLake with apps external to Fabric」を有効にし、サービスプリンシパルが外部アプリからデータにアクセスできるようにします。

ステップ2.3：ウェアハウスの接続文字列を取得する

Braze が接続するには、ウェアハウスの SQL エンドポイントが必要です。SQL エンドポイントを取得するには、Fabric の workspace に移動し、アイテムの一覧でウェアハウス名にカーソルを合わせて Copy SQL connection string を選択します。この値は、ステップ3 の認証情報の設定で使用できるよう手元に控えておいてください。

ステップ2.4：ファイアウォールで Braze の IP を許可する (オプション)

Microsoft Fabric アカウントの構成によっては、Braze からのトラフィックを許可するために、ファイアウォールで次の IP アドレスを許可する必要があります。この設定を有効にする方法の詳細については、Entra Conditional Access に関する関連ドキュメントを参照してください。

インスタンスUS-01、US-02、US-03、US-04、US-05、US-06、US-07の場合、関連するIPアドレスは次のとおりです。

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

インスタンスUS-08の場合、関連するIPアドレスは次のとおりです。

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

インスタンスUS-10の場合、関連するIPアドレスは次のとおりです。

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

インスタンスEU-01とEU-02の場合、関連するIPアドレスは次のとおりです。

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

インスタンスAU-01の場合、関連するIPアドレスは次のとおりです。

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

インスタンスID-01の場合、関連するIPアドレスは次のとおりです。

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

インスタンスJP-01の場合、関連するIPアドレスは次のとおりです。

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

インスタンスKR-01の場合、関連するIPアドレスは次のとおりです。

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

ステップ3：Braze ダッシュボードで接続されたソースを作成する

ステップ3.1：Snowflake の接続情報とソーステーブルを追加する

Braze ダッシュボードで接続されたソースを作成します。データ設定 > クラウドデータ取り込み > 接続されたソース に移動し、データソースを追加 を選択してから、Snowflake を選択します。

ソースの設定 で、次の情報を入力します。

認証情報名 と認証方法 (Workload Identity Federation または キーペア)
認証情報: アカウントロケーター、ユーザー名、ロール
構成: ウェアハウス、データベース、スキーマ

Workload Identity Federation の場合は、ステートメントをコピー を選択して Snowflake のワークシートで実行し、認証情報を保存 を選択します。キーペアの場合は、接続をテストする前に 認証情報を保存してRSAキーを生成 を選択します。

ステップ3.2：同期の詳細を設定する

接続されたソースの名前を選択します。この名前は、新しい CDI セグメントエクステンションを作成する際に、利用可能なソースの一覧で使用されます。

このソースの最大実行時間を設定します。Braze は、最大実行時間を超えたクエリを自動的に中止します。設定できる最大実行時間は 60 分です。実行時間を短くすると、Snowflake アカウントで発生するコストを削減できます。この設定は、このソースを通じて実行されるクエリ (このソースを使用する同期や CDI セグメントエクステンションを含む) に適用されます。

注

クエリが常にタイムアウトし、最大実行時間を 60 分に設定している場合は、クエリの実行時間の最適化を試みるか、Braze ユーザー専用により大きなウェアハウスを割り当てることを検討してください。

ステップ3.3：公開キーを控える (キーペア)

接続をテスト ステップで、RSA 公開キーを控えておいてください。Snowflake で統合を完了するために必要です。

ステップ3.1：Redshift の接続情報とソーステーブルを追加する

Braze ダッシュボードで接続されたソースを作成します。データ設定 > クラウドデータ取り込み > 接続されたソース に移動し、データソースを追加 を選択してから、Amazon Redshift を選択します。

ソースの設定 で、次の情報を入力します。

認証情報: Redshift ホストURL、ユーザー名、パスワード、ポート
構成: データベース、スキーマ

必要に応じて SSH トンネルで接続 を有効にし、トンネルホスト、トンネルポート、トンネルユーザー名 を入力します。

ステップ3.2：同期の詳細を設定する

このソースの最大実行時間を設定します。Braze は、最大実行時間を超えたクエリを自動的に中止します。設定できる最大実行時間は 60 分です。実行時間を短くすると、Redshift アカウントで発生するコストを削減できます。この設定は、このソースを通じて実行されるクエリ (このソースを使用する同期や CDI セグメントエクステンションを含む) に適用されます。

注

ステップ3.3：公開キーを控える (オプション)

認証情報で SSH トンネルで接続 を選択している場合は、接続をテスト ステップで RSA 公開キーを控えておいてください。Redshift で統合を完了するために必要です。

ステップ3.1：BigQuery の接続情報とソーステーブルを追加する

Braze ダッシュボードで接続されたソースを作成します。データ設定 > クラウドデータ取り込み > 接続されたソース に移動し、データソースを追加 を選択してから、Google BigQuery を選択します。

ソースの設定 で、次の情報を入力します。

認証情報: 認証情報名 と認証方法に加え、プロジェクト番号、ワークロードアイデンティティプールID、プロバイダーID、サービスアカウントのメールアドレス (Workload Identity Federation の場合)、またはアップロードした JSONキー (サービスアカウントキーの場合)
構成: プロジェクト、データセット

ステップ3.2：同期の詳細を設定する

このソースの最大実行時間を設定します。Braze は、最大実行時間を超えたクエリを自動的に中止します。設定できる最大実行時間は 60 分です。実行時間を短くすると、BigQuery アカウントで発生するコストを削減できます。この設定は、このソースを通じて実行されるクエリ (このソースを使用する同期や CDI セグメントエクステンションを含む) に適用されます。

注

ステップ3.3：接続をテストする

接続をテスト を選択して、ユーザーに表示されるテーブルの一覧が想定どおりであることを確認し、完了を選択します。これで接続されたソースが作成され、CDI セグメントエクステンションで使用できるようになりました。

ステップ3.1：Databricks の接続情報とソーステーブルを追加する

Braze ダッシュボードで接続されたソースを作成します。データ設定 > クラウドデータ取り込み > 接続されたソース に移動し、データソースを追加 を選択してから、Databricks を選択します。

ソースの設定 で、次の情報を入力します。

認証情報: 認証情報名、認証方法、ホスト名、HTTPパス に加え、クライアントID と クライアントシークレット (OAuth M2M の場合)、または アクセストークン (個人用アクセストークンの場合)
構成: カタログ、スキーマ

ステップ3.2：同期の詳細を設定する

このソースの最大実行時間を設定します。Braze は、最大実行時間を超えたクエリを自動的に中止します。設定できる最大実行時間は 60 分です。実行時間を短くすると、Databricks アカウントで発生するコストを削減できます。この設定は、このソースを通じて実行されるクエリ (このソースを使用する同期や CDI セグメントエクステンションを含む) に適用されます。

注

ステップ3.3：接続をテストする

ステップ3.1：Microsoft Fabric の接続情報とソーステーブルを追加する

Braze ダッシュボードで接続されたソースを作成します。データ設定 > クラウドデータ取り込み > 接続されたソース に移動し、データソースを追加 を選択してから、Microsoft Fabric を選択します。

ソースの設定 で、次の情報を入力します。

認証情報: 認証情報名、テナントID、プリンシパルID、クライアントシークレット、接続文字列
構成: データベース、スキーマ

ワークスペースで SSH トンネルで接続 が利用可能で、設定に必要な場合は、トンネルホスト、トンネルポート、トンネルユーザー名 も入力します。

ステップ3.2：同期の詳細を設定する

このソースの最大実行時間を設定します。Braze は、最大実行時間を超えたクエリを自動的に中止します。設定できる最大実行時間は 60 分です。実行時間を短くすると、Microsoft Fabric アカウントで発生するコストを削減できます。この設定は、このソースを通じて実行されるクエリ (このソースを使用する同期や CDI セグメントエクステンションを含む) に適用されます。

注

クエリが常にタイムアウトし、最大実行時間を 60 分に設定している場合は、クエリの実行時間の最適化を試みるか、Fabric の容量のスケーリングを検討してください。

ステップ3.3：接続をテストする

前のステップで、認証情報フォームのステートメントをすでに実行しています。Braze で 接続をテスト を選択し、完了を選択します。これで接続されたソースが作成され、CDI セグメントエクステンションで使用できるようになりました。

前のステップで控えた公開キーを、Snowflake のユーザーに追加します。これにより、Braze が Snowflake に接続できるようになります。詳細については、Snowflake のキーペア認証を参照してください。

ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='{INSERT_YOUR_KEY}';

後でキーをローテーションするには、データ設定 > クラウドデータ取り込み > 認証情報 に移動し、Snowflake データアクセス認証情報 の下にある認証情報を開いて、認証情報をローテーション を選択します。詳細モーダルについては、Snowflake の認証情報を確認するを参照してください。

Snowflake のユーザーにキーを追加したら、Braze で 接続をテスト を選択し、完了を選択します。これで接続されたソースが作成され、CDI セグメントエクステンションで使用できるようになりました。

SSH トンネルで接続する場合は、前のステップで控えた公開キーを SSH トンネルのユーザーに追加します。

ユーザーにキーを追加したら、Braze で 接続をテスト を選択し、完了を選択します。これで接続されたソースが作成され、CDI セグメントエクステンションで使用できるようになりました。

このステップは BigQuery には該当しません。

このステップは Databricks には該当しません。

このステップは Microsoft Fabric には該当しません。

注

ソースを「下書き」状態から「アクティブ」状態に移行するには、テストに成功する必要があります。作成ページを閉じる必要がある場合でも統合は保存されるため、詳細ページに戻って変更やテストを行うことができます。

追加の統合またはユーザーの設定 (オプション)

Brazeとの統合は複数設定できますが、各統合はそれぞれ異なるスキーマに接続するように設定する必要があります。追加の接続を作成する際、同じSnowflakeアカウントに接続する場合は、既存の認証情報を再利用できます。

複数の統合で同じキーペアユーザーとロールを再利用する場合、公開キーを再度追加する必要はありません。Workload Identity Federationの認証情報には、追加する公開キーはありません。

Brazeとのソースは複数設定できますが、各ソースはそれぞれ異なるスキーマに接続するように設定する必要があります。追加のソースを作成する際、同じRedshiftアカウントに接続する場合は、既存の認証情報を再利用できます。

Brazeとのソースは複数設定できますが、各ソースはそれぞれ異なるデータセットに接続するように設定する必要があります。追加のソースを作成する際、同じBigQueryアカウントに接続する場合は、既存の認証情報を再利用できます。

Brazeとのソースは複数設定できますが、各ソースはそれぞれ異なるスキーマに接続するように設定する必要があります。追加のソースを作成する際、同じDatabricksアカウントに接続する場合は、既存の認証情報を再利用できます。

Brazeとのソースは複数設定できますが、各ソースはそれぞれ異なるスキーマに接続するように設定する必要があります。追加のソースを作成する際、同じAzureアカウントに接続する場合は、既存の認証情報を再利用できます。

接続済みソースの使用

ソースの作成後、そのソースを使用して1つ以上のCDIセグメントエクステンションを作成できます。このソースを使用したセグメントの作成について詳しくは、CDIセグメントエクステンションのドキュメントを参照してください。

注

クエリが常にタイムアウトし、最大実行時間を60分に設定している場合は、クエリの実行時間を最適化するか、Brazeユーザーにより多くのコンピューティングリソース (より大きなウェアハウスなど) を割り当てることを検討してください。

New Stuff!