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

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を選択します。

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

ステップ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によって生成されるもので、クラウドデータ取り込みではBraze IDを使用して新しいユーザーを作成することはできません。新しいユーザーを作成するには、外部ユーザーIDまたはユーザーエイリアスを指定してください。
  • EMAIL - ユーザーのメールアドレスです。同じメールアドレスを持つプロファイルが複数存在する場合は、最も最近更新されたプロファイルが優先的に更新されます。メールと電話番号の両方を含める場合は、メールがプライマリ識別子として使用されます。
  • PHONE - ユーザーの電話番号です。同じ電話番号を持つプロファイルが複数存在する場合は、最も最近更新されたプロファイルが優先的に更新されます。
• PAYLOAD - Brazeのユーザーに同期するフィールドのJSON文字列です。

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

ウェアハウスのSQLエンドポイントを取得するには、Fabricでworkspaceに移動し、項目リストのウェアハウス名にカーソルを合わせて、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の認証情報と構成を入力します。

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

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

次に、接続をテストを選択します。成功したら残りの設定を完了し、ソースに接続を選択します。接続に失敗した場合は、問題のトラブルシューティングに役立つエラーメッセージが表示されます。

注

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

ステップ3.1：同期の詳細を設定してデータを定義する

同期の名前を入力します。次に、アクティブなソースと同期データタイプを選択します。続いて、ビジュアルまたはテーブルを選択してソーステーブルを入力するか、SQLを選択してカスタムSQLクエリを記述します。最後に、プレビューと検証を選択します。

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

注

次のステップに進むには、同期の検証に成功する必要があります。同期の作成ページを閉じる必要がある場合は、下書きとして保存を選択して作業内容を保存してください。

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

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

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

このような問題には次のものがあります。

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

ステップ3.3：スケジュール

最後に、同期を非定期または定期に設定します。

非定期の同期は、ダッシュボードで今すぐ同期を選択したとき、または同期をトリガーするエンドポイントを呼び出したときにのみ実行されます。

定期的な同期は、最短で5分ごと、最長で月1回の頻度で実行できます。デフォルトでは、ダッシュボードで設定できる最短間隔は15分です。これにより、ウェアハウスのコンピューティングコストとリクエスト量を管理しやすくなります。最短5分ごとに同期するには、Brazeサポートまたはカスタマーサクセスマネージャーにお問い合わせください。Brazeは定期的な同期をUTCでスケジュールします。

Brazeでは複数の統合を設定できます。追加の同期を作成する際、同じFabricアカウントに接続する場合は既存の認証情報を再利用できます。

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

有効化すると、同期は設定時に構成したスケジュールで実行されます。スケジュール外で同期を実行したい場合や、最新のデータを取得したい場合は、今すぐ同期を選択します。この実行は、定期的にスケジュールされた今後の同期には影響しません。データの更新時に同期を自動的に開始するには、パイプラインから同期のトリガーエンドポイントを呼び出します。