Microsoft Fabricのクラウドデータ取り込み

このページでは、クラウドデータ取り込み (CDI) を使用して Microsoft Fabric から Braze にデータを同期するために必要なすべての情報を説明します。Fabric で作成するリソース、Braze でソースを接続して同期を作成する方法、各データタイプのソーステーブル、Fabric 固有のトラブルシューティングについて取り上げます。

設定の概要

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

ステップ 1: 認証を設定する

Brazeは次の認証方法で Fabric ウェアハウスに接続します。

Service principal

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

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

アプリケーションを登録するには、Microsoft Entra IDでアプリ登録を作成する権限が必要です。この権限がない場合は、Entra 管理者にこのステップの実行を依頼し、認証情報を共有してもらってください。

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へのデータフローを維持するため、有効期限が切れる前に認証情報を更新してください。

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

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

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

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

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

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

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

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

このセクションの手順では、PAYLOAD 列を持つテーブルを作成します。データ定義ステップでビジュアルを使用して列をマッピングする場合や、SQL でクエリを作成する場合は、代わりに既存のテーブルまたはビューを使用できます。テーブル作成の手順をスキップし、同期するテーブルまたはビューへの読み取りアクセス権を Braze に付与してください。各オプションの比較については、データ定義オプションを選択するを参照してください。

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

ウェアハウス、スキーマ、テーブルまたはビューには任意の名前を付けられますが、列名は次のタブの定義と一致させる必要があります。

注

PAYLOAD 列を使用する場合、ソーステーブルまたはビューには、次のタブに記載されていない列 (監査用やハッシュ用など) を含めることができます。Brazeはこれらのタブで説明されている列のみを読み取ります。その他の列はクラウドデータ取り込みの同期では使用されません。

同期するデータタイプのタブを選択してください。

• ユーザー属性
• カスタムイベント
• 購入イベント
• カタログアイテム
• キャンバストリガー
• ユーザー削除

ユーザー属性、カスタムイベント、購入イベントはすべて同じ形式のソーステーブルを使用します。異なるのは PAYLOAD の内容だけです。

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 文字列です。

属性の同期では、PAYLOAD はユーザー属性オブジェクトの形式に従います。階層化カスタム属性、オブジェクトの配列、購読グループのステータスを含めることができます。ペイロードの例については、テーブルの設定を参照してください。

カスタムイベントはユーザー属性と同じソーステーブルを使用します。ユーザー属性タブに示されているテーブルを作成し、PAYLOAD にイベントオブジェクトを設定します。

イベントを同期するには、イベント名が必要です。time フィールドは ISO 8601 文字列、または yyyy-MM-dd'T'HH:mm:ss:SSSZ 形式で指定します。time フィールドがない場合、Brazeは UPDATED_AT 列の値をイベント時刻として使用します。app_id や properties などのその他のフィールドはオプションです。

1 行につき 1 つのイベントを同期できます。

1
2
3
4
5
6
7
8
9

{
    "app_id" : "your-app-id",
    "name" : "rented_movie",
    "time" : "2013-07-16T19:20:45+01:00",
    "properties": {
        "movie": "The Sad Egg",
        "director": "Alex Smith"
    }
}

購入イベントはユーザー属性と同じソーステーブルを使用します。ユーザー属性タブに示されているテーブルを作成し、PAYLOAD に購入オブジェクトを設定します。

購入イベントを同期するには、product_id、currency、price が必要です。オプションの time フィールドは ISO 8601 文字列、または yyyy-MM-dd'T'HH:mm:ss:SSSZ 形式で指定します。time フィールドがない場合、Brazeは UPDATED_AT 列の値をイベント時刻として使用します。app_id、quantity、properties などのその他のフィールドはオプションです。

1 行につき 1 つの購入イベントを同期できます。

1
2
3
4
5
6
7
8
9
10
11
12

{
    "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
    "product_id" : "Completed Order",
    "currency" : "USD",
    "price" : 219.98,
    "time" : "2013-07-16T19:20:30+01:00",
    "properties" : {
        "products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
        { "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
        ]
    }
}

カタログ同期を作成する前に、Braze で同期先のカタログを作成してください。カタログのワークフロー全体については、カタログデータの同期と削除を参照してください。

1
2
3
4
5
6
7
8

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  ID VARCHAR NOT NULL,
  DELETED BIT
)
GO

統合の名前は、Braze で作成したカタログの名前と完全に一致している必要があります。

同期を実行するたびにソーステーブルが完全に更新されるよう、カタログデータからビューを作成することをお勧めします。たとえば、id と 4 つの追加属性を持つ製品データのテーブル (product_catalog) がある場合、次のビューを同期できます。

1
2
3
4
5
6
7

CREATE VIEW [braze].[user_update_example]
AS SELECT
    id as ID,
    CURRENT_TIMESTAMP as UPDATED_AT,
    JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD

FROM [braze].[product_catalog] ;

キャンバストリガーは、ゼロコピーパーソナライゼーションを実現します。送信先キャンバスの設定と考慮事項については、ゼロコピーパーソナライゼーションを参照してください。

1
2
3
4
5
6
7
8
9
10
11

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PROPERTIES VARCHAR NOT NULL,
  --at least one of external_id or alias_name and alias_label is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR
)
GO

キャンバストリガーの同期は、他のユーザーデータの同期と次の3点で異なります。

• external ID またはユーザーエイリアスの識別子のみがサポートされています。メールアドレスと電話番号は識別子としてサポートされていません。
• 同期できるのは既存の Braze ユーザーのみです。新しいユーザーを作成することはできません。
• PAYLOAD 列の代わりに PROPERTIES 列を使用します。これは、パーソナライゼーション用のキャンバスエントリプロパティとして使用するフィールドの JSON 文字列です。

キャンバストリガーテーブルには、次の列が必要です。

• UPDATED_AT - この行がテーブルで更新または追加された時刻です。Brazeは、UPDATED_AT が最後に同期された値よりも後の行を同期します。境界となるタイムスタンプとまったく同じタイムスタンプを持つ行は、新しい行が同じタイムスタンプを持つ場合に再同期されることがあります。
• ユーザー識別子の列として、EXTERNAL_ID、または ALIAS_NAME と ALIAS_LABEL のいずれか。これらの列は、キャンバスメッセージングをトリガーする対象のユーザーを識別します。
  • EXTERNAL_ID - キャンバスにエントリさせるユーザーを識別します。この値は、Brazeで使用される external_id の値と一致する必要があります。
  • ALIAS_NAME と ALIAS_LABEL - これらの列はユーザーエイリアスオブジェクトを作成します。alias_name は一意の識別子である必要があり、alias_label はエイリアスのタイプを指定します。ユーザーは異なるラベルを持つ複数のエイリアスを持つことができますが、1つの alias_label につき alias_name は1つのみです。
• PROPERTIES - キャンバスでパーソナライゼーションプロパティとして使用できるようにするフィールドの JSON 文字列です。ユーザー固有の情報を含める必要があります。

注

プロパティは、すべての行やユーザーに必須というわけではありません。ただし、プロパティの値は有効な JSON 文字列である必要があります。行にプロパティがない場合は、空の {} 文字列を入力してください。

サービスプリンシパルを作成し、権限を付与します。別の同期の認証情報がすでにある場合は再利用できますが、キャンバストリガーのテーブルへのアクセス権があることを確認してください。

開始するには、新しい同期の作成時にキャンバストリガーデータタイプを選択します。

ユーザー削除用のソーステーブルには、1つ以上のユーザー識別子タイプと UPDATED_AT タイムスタンプを含める必要があります。ユーザー削除データでは、ペイロード列はサポートされていません。

• UPDATED_AT - この行がテーブルで更新または追加された時刻です。Braze は、UPDATED_AT が最後に同期された値よりも後の行を同期します。新しい行が境界のタイムスタンプとまったく同じタイムスタンプを持つ場合、その境界タイムスタンプの行が再同期されることがあります。
• ユーザー識別子列 - 各行には識別子を1つだけ含める必要があります。external_id、alias_name と alias_label の組み合わせ、または braze_id のいずれかです。ソーステーブルには、1つ、2つ、または3つすべての識別子タイプの列を含めることができます。
  • 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 またはユーザーエイリアスを指定してください。

重要

ユーザー削除用のテーブルには PAYLOAD 列を含めないでください。ユーザーが誤って完全に削除されるのを防ぐため、ソーステーブルにペイロード列が含まれている場合、同期は失敗します。その他の列は含めてもかまいませんが、Braze では無視されます。

1
2
3
4
5
6
7
8
9
10
11
12

CREATE OR ALTER TABLE [warehouse].[schema].[users_deletes]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  --at least one of external_id, alias_name and alias_label, 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
)
GO

インポート同期を作成ページで、データタイプをユーザーを削除に設定し、統合の実行時に適切なアクションが実行されるようにします。詳細については、クラウドデータ取り込みでユーザーを削除するを参照してください。

警告

ユーザープロファイルの削除は元に戻せません。削除アクションはユーザーを完全に削除するため、データに不整合が生じる可能性があります。詳細については、ユーザープロファイル削除の影響を参照してください。

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

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

ステップ 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)

ステップ 7: Braze ダッシュボードで新しいソースを作成する

Braze ダッシュボードで、データ設定 > クラウドデータ取り込み > ソースに移動し、データソースを追加を選択してから、Microsoft Fabric を選択します。

ステップ 7.1: Microsoft Fabricの接続情報を追加する

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

• 認証情報名は、Braze でこの認証情報を識別するためのラベルです。わかりやすい値を設定できます。
• ステップ 1 で設定した認証方法の認証情報を入力します。Tenant ID, Principal ID, and Client Secretを入力します。
• 接続文字列については、ステップ 5 を参照してください。

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

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

注

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

ステップ 8: Braze ダッシュボードで新しい同期を作成する

データ設定 > クラウドデータ取り込み > 同期に移動し、データ同期を作成を選択します。

同期の詳細を設定してデータを定義する

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

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

注

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

通知設定を追加する

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

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

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

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

スケジュールを設定する

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

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

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

注

統合を下書きからアクティブ状態に移行するには、統合の検証を正常に完了する必要があります。作成ページを閉じても統合は保存されるため、詳細ページに戻って変更や検証を行うことができます。

同期を実行する

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

追加の統合またはユーザーを設定する (オプション)

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

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

Microsoft Fabric を接続ソースとして使用する

接続ソースは、Braze にデータを同期する方法に代わるゼロコピーの選択肢です。Brazeは、基盤となるデータをコピーすることなく、Fabric ウェアハウスに直接クエリを実行して CDI セグメントを作成します。概念、制限事項、コストへの影響については、接続ソースを参照してください。

ステップ 1: 認証を設定してアクセス権を付与する

ステップ 1、ステップ 2、ステップ 3 で説明したのと同じ設定を行います。次に、ステップ 5 の説明に従ってウェアハウスの接続文字列を取得し、ステップ 6 の説明に従って BrazeのIPを許可します。

Fabric ワークスペースでソースデータを設定し、サービスプリンシパルに権限を付与します。接続ソースは 1 つ以上のテーブルを参照する可能性があるため、接続ソースに含めるすべてのテーブルへのアクセス権が Brazeのサービスプリンシパルにあることを確認してください。

ステップ 2: Braze で接続ソースを作成する

データ設定 > クラウドデータ取り込み > 接続ソースに移動し、データソースを追加を選択してから、Microsoft Fabric を選択します。

ソースのセットアップで、次の情報を入力します。

• 認証情報: 認証情報名、接続文字列、および認証方法のフィールド。Tenant ID, Principal ID, and Client Secretを入力します。
• 設定: データベースとスキーマ

ワークスペースで SSH トンネルで接続が利用可能で、設定に必要な場合は、トンネルホスト、トンネルポート、トンネルユーザー名も入力します。

接続ソースの名前を決めます。この名前は、新しい CDI セグメントエクステンションを作成する際に、利用可能なソースのリストに表示されます。

このソースの最大実行時間を設定します。Brazeは、最大実行時間を超えたクエリを自動的に中止します。設定できる最大実行時間は 60 分です。実行時間を短くすると、Microsoft Fabric アカウントで発生するコストを削減できます。この設定は、このソースを使用する同期や CDI セグメントエクステンションを含め、このソースを通じて実行されるクエリに適用されます。

注

最大実行時間を 60 分に設定してもクエリが継続的にタイムアウトする場合は、クエリの実行時間を最適化するか、Fabricの容量をスケーリングすることを検討してください。

接続をテストを選択して、ユーザーに表示されるテーブルのリストが想定どおりであることを確認し、完了を選択します。これで接続ソースが作成され、CDI セグメントエクステンションで使用できるようになりました。

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

既存の列からペイロードをフォーマットする

社内で各属性を個別の列に保存したい場合は、Brazeとの同期にデータを設定するために、それらの列を JSON 文字列に変換する必要があります。Microsoft Fabric で次のクエリを使用して、ソース列を CDI フィールドにフォーマットします。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

CREATE TABLE [braze].[users] (
    attribute_1 VARCHAR,
    attribute_2 VARCHAR,
    attribute_3 VARCHAR,
    attribute_4 VARCHAR,
    user_id VARCHAR
)
GO

CREATE VIEW [braze].[user_update_example]
AS SELECT
    user_id as EXTERNAL_ID,
    CURRENT_TIMESTAMP as UPDATED_AT,
    JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD

FROM [braze].[users] ;

最適化に関するその他のガイダンスについては、クラウドデータ取り込みのベストプラクティスを参照してください。

トラブルシューティング

「接続をテスト」の実行が遅い

「接続をテスト」はデータウェアハウス上で実行されるため、容量を増やすと速度が向上する場合があります。

サービスプリンシパルのシークレットの有効期限が切れた

Azure では、サービスプリンシパルのシークレットに無期限の有効期限を設定することはできません。認証エラーで同期が失敗し始めた場合は、Microsoft Entra ID でクライアントシークレットを更新し、Brazeの認証情報を更新してください。

SQL チェックの実行場所

検証チェックは、CDI 統合で使用しているのと同じテーブルまたはビューに対して、Fabric SQL クエリエディターで直接実行してください。Fabricは LIMIT をサポートしていないため、TOP などの同等の構文を使用してください。

関連ページ

• 必須の列とペイロードの形式については、テーブルの設定を参照してください。
• 同期のスケジュール設定とデータポイントの効率化については、ベストプラクティスを参照してください。
• 同期実行のモニタリングについては、同期ログとオブザーバビリティを参照してください。
• すべてのソースに共通する質問については、よくある質問を参照してください。