データウェアハウスストレージの連携

1. サービスプリンシパルを作成し、統合に使用する Fabric ワークスペースへのアクセスを許可します。
2. Fabric ワークスペースで、Braze と同期するテーブルまたはビューを設定します。
3. Braze ダッシュボードで新しい連携を作成します。
4. 連携のテストを行い、同期を開始します。

ステップ1.1：サービスプリンシパルを設定し、アクセスを許可する。

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

• Azure アカウントのテナント ID (ディレクトリとも呼ばれる)
• サービスプリンシパルのプリンシパル ID (アプリケーション ID とも呼ばれる)
• Braze が認証するためのクライアントシークレット

1. Azure portal で、[Microsoft Entra 管理センター]、[アプリの登録] の順に移動します。
2. [ID] > [アプリケーション] > [アプリの登録] で [+新規登録] を選択します。
3. 名前を入力し、サポートされているアカウントの種類としてAccounts in this organizational directory only を選択します。次に、[登録] を選択します。
4. 先ほど作成したアプリケーション（サービスプリンシパル）を選択し、証明書& secret>+ New client secretに移動する。
5. シークレットの説明を入力し、有効期限を設定します。そして、[追加] を選択します。
6. Brazeのセットアップで使用するために作成したクライアントシークレットに注意すること。

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

BrazeがFabricインスタンスに接続するためのアクセスを提供する。Fabricの管理ポータルで、「設定」>「ガバナンスとインサイト」>「管理ポータル」>「テナント設定」の順に移動する。

• 開発者設定で、[サービスプリンシパルが Fabric API を使用可能] を有効にして、Braze が Microsoft Entra ID を使用して接続できるようにします。
• OneLake の設定で、サービスプリンシパルが外部アプリからデータにアクセスできるように、[ユーザーが Fabric の外部アプリを使用して OneLake に保存されているデータにアクセス可能] を有効にします。

ステップ1.3：テーブルの設定

Braze は Fabric ウェアハウスのテーブルとビューの両方をサポートしています。新しいウェアハウスを作成する必要がある場合は、Fabric コンソールで **[作成] > [データウェアハウス] > [ウェアハウス] **と進みます。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name] 
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required  
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR,
  --If you include both email and phone, we will use the email as the primary identifier
  EMAIL VARCHAR,
  PHONE VARCHAR
)
GO

ウェアハウス、スキーマ、テーブルまたはビューには好きな名前をつけることができますが、カラム名は前述の定義と一致させる必要があります。

• UPDATED_AT - テーブルで、この行が更新された時刻、または追加された時刻。最後の同期以降に追加されたか、更新された行のみを同期します。
• ユーザー識別子カラム- テーブルには、1つ以上のユーザー識別子カラムを含めることができる。各行は、識別子 (external_id 単独か、alias_name と alias_label、braze_id、email または phone の組み合わせ) を 1 つのみ含まなければなりません。ソーステーブルには、1つ、2つ、3つ、4つ、または5つすべての識別子タイプの列が含まれる場合があります。
  • EXTERNAL_ID - 更新対象のユーザーを特定します。これは Braze で使用されている external_id 値と一致しなければなりません。
  • ALIAS_NAME および ALIAS_LABEL - この 2 列はユーザーエイリアスオブジェクトを作成します。alias_name は一意の識別子である必要があり、alias_label はエイリアスのタイプを指定します。ユーザーは、異なるラベルを持つ複数のエイリアスを持つことができますが、alias_label ごとに alias_name を 1 つしか持つことができません。
  • BRAZE_ID - Braze のユーザー識別子。これは Braze SDK によって生成されます。クラウドデータ取り込み経由で Braze ID を使用して新規ユーザーを作成することはできません。新規ユーザーを作成するには、外部ユーザー ID またはユーザーエイリアスを指定します。
  • EMAIL - ユーザーのメールアドレス。同じメールアドレスを持つプロファイルが複数存在する場合、最後に更新されたプロファイルが優先されて更新されます。メールと電話の両方が指定された場合は、メールをプライマリ識別子として使用します。
  • PHONE - ユーザの電話番号。同じ電話番号を持つプロファイルが複数存在する場合、最後に更新されたプロファイルが優先されて更新されます。
• PAYLOAD - Braze 内のユーザーと同期するフィールドの JSON 文字列。

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

Brazeを接続するには、倉庫のSQLエンドポイントが必要である。これを取得するには、Fabric でワークスペースに移動し、項目の一覧でウェアハウスの名前にカーソルを合わせ、 [SQL 接続文字列をコピー] を選択します。

!ユーザーがSQL接続文字列を取得する必要がある。

ステップ1.5:ファイアウォールで Braze IP を許可する（オプション）

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

• united states (us)
• european union (eu)
• australia (au)

ステップ 2.1: クラウドデータ取り込みの同期を設定する

Microsoft Fabric 用の新しいデータ同期を作成します。Braze ダッシュボードで [データ設定] > [クラウドデータ取り込み] > の順に移動し、［新しいデータ同期を作成] を選択し ［Microsoft Fabricks のインポート] を選択します。

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

Microsoft Fabric ウェアハウスの認証情報とソーステーブルの情報を入力して、次のステップに進みます。

• 認証情報名は、Braze におけるこれらの認証情報のラベルであり、ここでわかりやすい値を設定することができます。
• テナント ID、プリンシパル ID、クライアントシークレット、および接続文字列を取得する方法の詳細については、セクション1のステップを参照してください。

!BrazeダッシュボードのMicrosoftの “Create new import sync “ページをステップ1に設定する：「接続設定」だ。

ステップ 2.3:同期の詳細の設定

次に、同期のために以下の詳細を設定する：

• 同期名
• データタイプ - サポートされるデータタイプは、カスタム属性、カスタムイベント、購入イベント、カタログ、およびユーザー削除である。同期のデータ型は、作成後に変更できません。
• 同期の頻度 - 頻度の範囲は 15 分間隔から 1 か月に 1 回までです。Braze ダッシュボードで設定したタイムゾーンを使用して、定期的な同期がスケジュールされます。
  • 定期的でない同期は、手動または API 経由でトリガーできます。

!BrazeダッシュボードのMicrosoft Fabricの “Create new import sync “ページをステップ2に設定する：「同期の詳細を設定する」。

ステップ 2.4:通知設定を行う

次に、コンタクトメールを入力します。この連絡先情報を使用して、テーブルへのアクセスが予期せず削除された場合などの統合エラーを通知したり、特定の行の更新に失敗した場合に警告を発したりする。

デフォルトでは、連絡先のメールアドレスは、テーブルや権限の欠落など、グローバルまたは同期レベルのエラーの通知のみを受け取ります。グローバルエラーは、同期の実行を妨げる接続の重大な問題を示します。このような問題として、次のようなものがあります。

• 接続の問題
• リソース不足
• 権限の問題
• (カタログ同期のみ) カタログ層の容量不足

行レベルの問題に対するアラートを設定することもできるし、同期が正常に実行されるたびにアラートを受け取るようにすることもできる。

!BrazeダッシュボードのMicrosoft Fabricの “Create new import sync “ページで、ステップ3に設定する：「通知の設定をする」。

同期の設定の詳細をすべて入力したら、[テスト接続] をクリックします。成功すると、データのプレビューが表示されます。何らかの理由で接続できない場合、問題のトラブルシューティングに役立つエラーメッセージが表示されます。

!BrazeダッシュボードのMicrosoft Fabricの “Create new import sync “ページで、ステップ4に設定する：「テスト接続」である。

Braze との連携を複数設定することもできますが、各連携で異なるテーブルを同期するように設定する必要があります。追加の同期を作成するときに同じ Fabric アカウントに接続している場合は、既存の認証情報を再利用できます。

複数の連携にわたって同じユーザーを再利用している場合、すべてのアクティブな同期から削除されるまで、Braze ダッシュボードでそのユーザーを削除することはできません。

有効にすると、セットアップ時に設定したスケジュールで同期が実行される。通常のテストスケジュール以外で同期を実行したい場合や、最新のデータを取得したい場合は、「今すぐ同期」を選択する。この実行は、定期的にスケジュールされている将来の同期には影響しません。