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

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

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

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

• Tenant ID (also called directory) for your Azure account
• Principal ID (also called application ID) for the service principal
• Client secret for Braze to authenticate

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ごとに1つのalias_nameのみです。
  • 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条件付きアクセスに関する関連ドキュメントを参照してください。

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

Brazeダッシュボードで、データ設定 > クラウドデータ取り込み > ソースに移動し、データソースを追加を選択してから、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回までの頻度で設定できます。Brazeは定期同期をUTCタイムゾーンでスケジュールします。

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

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

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