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

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

ステップ 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. 作成したアプリケーション（サービスプリンシパル）を選択し、[証明書とシークレット] > [+ 新しいクライアントシークレット] に移動します。
5. シークレットの説明を入力し、有効期限を設定します。次に、[追加] を選択します。
6. Braze のセットアップで使用するために、作成したクライアントシークレットをメモしてください。

ステップ 1.2: Fabric リソースへのアクセスの許可

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

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

ステップ 1.3: 共有ワークスペースの設定とアクセスの許可

Braze に接続する Fabric リソースは、共有ワークスペースに配置する必要があります。デフォルトの My Workspace のみを使用している場合は、新しい共有ワークスペースを作成してください。

1. ナビゲーションメニューで [ワークスペース] を選択し、[+ 新しいワークスペース] を選択します。
2. ワークスペースの名前を入力し、[適用] を選択します。

共有ワークスペースを作成したら、サービスプリンシパルにアクセスを許可します。

1. ワークスペースを選択し、[アクセスの管理] を選択します。
2. [+ ユーザーまたはグループの追加] を選択します。
3. ステップ 1.1 で作成したサービスプリンシパルの名前を検索して選択します。表示されない場合は、ステップ 1.2 で [サービスプリンシパルが Fabric API を使用可能] の設定が有効になっていることを確認してください。
4. ロールのドロップダウンで [共同作成者] を選択します。

これで、サービスプリンシパルは SQL エンドポイントを通じてこのワークスペース内の Fabric ウェアハウスリソース（Braze で使用するウェアハウスを含む）にアクセスできるようになります。

ステップ 1.4: テーブルの設定

Braze は Fabric ウェアハウスのテーブルとビューの両方をサポートしています。新しいウェアハウスを作成する必要がある場合は、ステップ 1.3 の共有ワークスペース内に作成してください。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, email is used as the primary identifier
  EMAIL VARCHAR,
  PHONE VARCHAR
)
GO

ウェアハウス、スキーマ、テーブルまたはビューには任意の名前を付けることができますが、列名は上記の定義と一致する必要があります。

• UPDATED_AT - テーブルでこの行が更新された時刻、または追加された時刻です。Braze は 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.5: ウェアハウスの接続文字列を取得する

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

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

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

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)

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

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

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

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

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

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

次に、同期のために以下の詳細を設定します。

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

ステップ 2.4: 通知設定の構成

次に、連絡先のメールアドレスを入力します。この連絡先情報を使用して、テーブルへのアクセスが予期せず削除された場合などの連携エラーの通知や、特定の行の更新に失敗した場合のアラートを送信します。

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

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

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

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

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

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

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