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

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 portalで、Microsoft Entra管理センター、[アプリの登録] の順に移動します。
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ウェアハウスのテーブルとビューの両方をサポートしています。新しいウェアハウスを作成する必要がある場合は、ステップ 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つ以上のユーザー識別子カラムを含めることができます。各行には、識別子（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: ウェアハウスの接続文字列を取得する

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

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

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

• 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: クラウドデータ取り込みの同期を設定する

ソースの名前を選択し、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か月に1回までの頻度で設定できます。Brazeダッシュボードで設定したタイムゾーンを使用して、定期的な同期がスケジュールされます。

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

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

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