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

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管理ポータルで、設定 > ガバナンスとインサイト > 管理ポータル > テナント設定に移動します。

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

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

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

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

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

ウェアハウスのSQLエンドポイントを取得するには、Fabricのワークスペースに移動し、アイテムリストでウェアハウス名にカーソルを合わせ、SQL接続文字列をコピーを選択します。

ステップ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ダッシュボードで、データ設定 > Cloud Data Ingestion > ソースに移動し、データソースを追加を選択してから、Microsoft Fabricを選択します。

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

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

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

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

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

注

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

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

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

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

注

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

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

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

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

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

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

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

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

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

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

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

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

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