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

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

ステップ1.1: サービスプリンシパルを設定しアクセスを付与する

BrazeはEntra ID認証を使用するサービスプリンシパルでFabricデータウェアハウスに接続します。Brazeが使用する新しいサービスプリンシパルを作成し、必要に応じてFabricリソースへのアクセスを付与してください。Brazeが接続するには以下の情報が必要です。

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

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

注

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

ステップ1.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を有効にして、サービスプリンシパルが外部アプリからデータにアクセスできるようにします。

ステップ1.3: 共有ワークスペースを設定しアクセスを付与する

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

1. ナビゲーションメニューでWorkspacesを選択し、+ New workspaceを選択します。
2. ワークスペースのNameを入力し、Applyを選択します。

共有ワークスペースができたら、サービスプリンシパルにアクセスを付与します。

1. ワークスペースを選択し、Manage Accessを選択します。
2. + Add people or groupsを選択します。
3. ステップ1.1で作成したサービスプリンシパルの名前を検索して選択します。表示されない場合は、ステップ1.2でService principals can use Fabric APIsの設定が有効になっていることを確認してください。
4. ロールのドロップダウンでContributorを選択します。

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

ステップ1.4: テーブルを設定する

BrazeはFabric Warehouseのテーブルとビューをサポートしています。新しいデータウェアハウスを作成する必要がある場合は、ステップ1.3の共有ワークスペース内に作成してください。FabricコンソールでCreate > Data Warehouse > Warehouseに移動します。

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つ以上のユーザー識別子カラムを含めることができます。各行には識別子を1つだけ含める必要があります（external_id、alias_nameとalias_labelの組み合わせ、braze_id、email、またはphoneのいずれか）。ソーステーブルには、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によって生成され、Cloud Data Ingestionを通じてBraze IDで新しいユーザーを作成することはできません。新しいユーザーを作成するには、外部ユーザーIDまたはユーザーエイリアスを指定してください。
  • EMAIL - ユーザーのメールアドレスです。同じメールアドレスを持つ複数のプロファイルが存在する場合、最も最近更新されたプロファイルが更新の優先対象となります。メールと電話の両方を含める場合、メールがプライマリ識別子として使用されます。
  • PHONE - ユーザーの電話番号です。同じ電話番号を持つ複数のプロファイルが存在する場合、最も最近更新されたプロファイルが更新の優先対象となります。
• PAYLOAD - Brazeのユーザーに同期するフィールドのJSON文字列です。

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

データウェアハウスのSQLエンドポイントを取得するには、Fabricのワークスペースに移動し、アイテムリストでデータウェアハウス名にカーソルを合わせ、Copy SQL connection stringを選択します。

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

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

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

Brazeダッシュボードで、Data Settings > Cloud Data Ingestion > Sourcesに移動し、Add data sourceを選択して、Microsoft Fabricを選択します。

ステップ2.1: Cloud Data Ingestion同期を設定する

ソースの名前を選択し、Microsoft Fabricの認証情報と設定を入力します。

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

ステップ2.2: 接続をテストしてソースに接続する

次に、Test connectionを選択します。成功したら、残りの設定を確定し、Connect to Sourceをクリックします。接続が失敗した場合、問題のトラブルシューティングに役立つエラーメッセージが表示されます。

注

ソースを作成する前に、正常にテストする必要があります。作成ページを閉じると、ソースは保存されません。

ステップ3.1: 同期の詳細を設定して接続をテストする

同期の名前を選択します。次に、アクティブなソースを選択し、同期用のソーステーブルを入力します。データタイプを選択してTest Connectionをクリックします。

成功すると、データのプレビューが表示されます。Next: Notificationsを選択して続行します。接続が失敗した場合、問題のトラブルシューティングに役立つエラーメッセージが表示されます。

注

次のステップに進む前に、同期のテストに成功する必要があります。同期作成ページを閉じる必要がある場合は、Save as draftをクリックして作業中の内容を保存できます。

ステップ3.2: 通知設定を追加する

同期エラー通知用の連絡先メールアドレスを入力します。Brazeはこの連絡先情報を使用して、テーブルアクセスの予期しない喪失などの統合エラーに関する通知を送信します。

連絡先メールは、テーブルの欠落、権限の問題など、グローバルまたは同期レベルのエラー通知のみを受信します。行レベルの問題は受信しません。グローバルエラーは、同期の実行を妨げる接続の重大な問題を示します。

このような問題には以下が含まれます:

• 接続の問題
• リソースの不足
• 権限の問題

（カタログ同期のみ）カタログの階層がスペース不足

ステップ3.3: スケジューリング

最後に、同期を非繰り返しまたは繰り返しとして設定します。

非繰り返し同期は、手動またはAPI経由でトリガーできます。

繰り返し同期は、15分ごとから月1回までの頻度を設定できます。Brazeは繰り返し同期をUTCタイムゾーンでスケジュールします。

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

統合間で同じユーザーを再利用する場合、そのユーザーがすべてのアクティブな同期から削除されるまで、Brazeダッシュボードでそのユーザーを削除することはできません。

有効化すると、設定時に構成されたスケジュールで同期が実行されます。通常のテストスケジュール以外で同期を実行したい場合や、最新のデータを取得したい場合は、Sync Now を選択してください。この実行は、通常スケジュールされている今後の同期には影響しません。