Microsoft Azure Event Hubs コネクタ構成ガイド
Microsoft Azure Event Hubsは、大量のイベントを受信・処理するためのクラウドサービスです。この記事では、お客様のCustomer Data Hubプロファイルでサービスを構成する方法について説明します。
コネクタアクション
| アクション名 | オーディエンスに対するトリガー | ストリームに対するトリガー |
|---|---|---|
| イベントデータをEvent Hubに送信 | ✗ | ✓ |
| 訪問データをEvent Hubに送信 | ✓ | ✗ |
| カスタマイズデータをEvent Hubに送信 | ✓ | ✓ |
必要条件
- Microsoft Azureアカウント
- Service Bus共有アクセスポリシーの認証情報
- データを送信するEvent Hubの名前
構成
コネクタマーケットプレイスに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについての記事を参照してください。
ベンダーを構成するには、以下の手順に従います：
-
構成タブでコネクタインスタンスのタイトルを入力します。
-
Azureポータルにサインインし、Event Hubs名前空間、共有アクセスポリシー名とキーを作成します。次に、Event Hubを作成します。詳細については、Azureポータルを使用してEvent Hubs名前空間とイベントハブを作成するを参照してください。
-
Event Hub名前空間、共有アクセスポリシー、共有アクセスキーを使用してコネクタを構成します。
-
接続テストをクリックして、提供された認証情報でAPI接続性を確認します。
共有アクセスポリシーはSend、Listen、Manageの3種類の権限を主張できます。提供されたポリシーは少なくともSend権限を主張する必要があります。
アクション構成 — パラメータとオプション
次へをクリックするか、アクションタブに進みます。ここでアクションのトリガーを構成します。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション — イベントデータをEvent Hubに送信
パラメータ
| パラメータ | 説明 |
|---|---|
| Event Hub | (必須): このリストからイベントハブを選択します。これらのオプションは、構成されたポリシーにManage権限が付与されている場合にのみ利用可能です。権限が付与されていない場合は、カスタム値としてイベントハブを手動で入力する必要があります。 |
| ユーザープロパティ | Toドロップダウンでメッセージユーザープロパティに属性をマッピングします（カスタム値として入力）。 |
| ブローカープロパティ | Toドロップダウンで選択したメッセージブローカープロパティに属性をマッピングします。以下のオプションを参照してください。 |
| 属性名の表示 | このボックスをチェックすると、メッセージペイロード内の各イベントデータ属性の名前が表示されます。 |
すべてのアクションはメッセージユーザーおよびブローカープロパティをサポートしています。これらはキーと値のペアを使用してメッセージに関する便利で有用な情報を提供しますが、HTTPヘッダーとして構成され、メッセージ本体内には存在しません。詳細については、メッセージユーザーおよびブローカープロパティを参照してください。
オプション — ブローカープロパティ
| オプション | 説明 |
|---|---|
| Content Type | メッセージ消費者のためのHTTPヘッダーContent-Typeを構成します |
| Correlation ID | 相関関係の一意の識別子 |
| Session ID | 特定の消費者にメッセージをパーティション分割してルーティングするために使用できます |
| Message ID | デフォルトの自動生成メッセージIDを上書きします |
| Label | アプリケーションラベル |
| Reply To | メッセージ消費者に対してレスポンスを送信する場所を指定するために使用できます |
| Time to Live in Seconds | X秒数後にメッセージを期限切れにします（Event Hubレベルを上書き） |
| To | 送信先アドレス |
| Scheduled Enqueued Time | メッセージがエンキューされる予定の日時 |
| Reply to Session ID | Reply Toと似ていますが、レスポンスの対象となるセッションをターゲットにします |
| Partition Key | パーティション分割されたイベントハブの一意の識別子 |
アクション – 訪問データをEvent Hubに送信
パラメータ
| パラメータ | 説明 |
|---|---|
| Event Hub | (必須): このリストからイベントハブを選択します。これらのオプションは、構成されたポリシーにManage権限が付与されている場合にのみ利用可能です。権限が付与されていない場合は、カスタム値としてイベントハブを手動で入力する必要があります。 |
| ユーザープロパティ | Toドロップダウンでメッセージユーザープロパティに属性をマッピングします（カスタム値として入力）。 |
| ブローカープロパティ | Toドロップダウンで選択したメッセージブローカープロパティに属性をマッピングします。利用可能なブローカープロパティオプションを参照してください。 |
| 現在の訪問データを訪問データに含める | ペイロードに現在の訪問データを追加します。これには、現在の訪問イベントデータが除外されていない場合、イベント訪問データが含まれます。 |
| 現在の訪問イベントデータを除外 | 現在の訪問データからイベントデータを除外します。 |
| 属性名の表示 | このボックスをチェックすると、メッセージペイロード内の各訪問データ属性の名前が表示されます。 |
アクション — カスタマイズデータをEvent Hubに送信 (高度)
パラメータ
| パラメータ | 説明 |
|---|---|
| Event Hub | (必須): このリストからイベントハブを選択します。これらのオプションは、構成されたポリシーにManage権限が付与されている場合にのみ利用可能です。権限が付与されていない場合は、カスタム値としてイベントハブを手動で入力する必要があります。 |
| ユーザープロパティ | Toドロップダウンでメッセージユーザープロパティに属性をマッピングします（カスタム値として入力）。 |
| ブローカープロパティ | Toドロップダウンで選択したメッセージブローカープロパティに属性をマッピングします。利用可能なブローカープロパティオプションを参照してください。 |
| メッセージデータ | (必須): カスタムメッセージ本体を構築します。属性を単一レベルのJSON形式の名前にマッピングするか、テンプレート名（二重中括弧で囲まれている）を参照し、カスタムメッセージ定義オプションを選択します。 |
| テンプレート変数 | 属性をテンプレート変数名にマッピングします。テンプレート変数は、すべてのテンプレートの置換およびレンダリングに利用可能です。詳細については、コネクターテンプレート変数を参照してください。 |
| テンプレート | 一つ以上のテンプレートを提供します。通常、メッセージデータを構築するために単一のテンプレートが使用されます。詳細については、コネクターテンプレートについてを参照してください。 |
必要に応じて、テンプレートはユーザーおよびブローカープロパティに参照され、注入することもできます。
ベンダー文書
最終更新日 :: 2025年June月13日