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 | デフォルトの自動生成されるMessage 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ドロップダウンにカスタム値として入力します。 |
| ブローカープロパティ | 属性を選択したメッセージブローカープロパティにマッピングします。利用可能なブローカープロパティオプションを参照してください。 |
| 現在の訪問データを含める | このボックスをチェックすると、メッセージペイロードに現在の訪問データが含まれます。 |
| 属性名を表示 | このボックスをチェックすると、メッセージペイロード内の各訪問データ属性の名前が表示されます。 |
アクション - カスタマイズデータをEvent Hubに送信（高度）
パラメータ
| パラメータ | 説明 |
|---|---|
| Event Hub | (必須): このリストからイベントハブを選択します。これらのオプションは、構成したポリシーがManage権限を付与されている場合のみ利用可能です。権限が付与されていない場合、イベントハブをカスタム値として手動で入力する必要があります。 |
| ユーザープロパティ | 属性をメッセージユーザープロパティにマッピングします。Toドロップダウンにカスタム値として入力します。 |
| ブローカープロパティ | 属性を選択したメッセージブローカープロパティにマッピングします。利用可能なブローカープロパティオプションを参照してください。 |
| メッセージデータ | (必須): カスタムメッセージ本体を構築します。属性を名前にマッピングしてシンプルな1レベルのJSON形式を作成するか、テンプレート名を参照して（二重中括弧で囲む）カスタムメッセージ定義オプションを選択します。 |
| テンプレート変数 | 属性をテンプレート変数名にマッピングします。テンプレート変数はすべてのテンプレートの置換とレンダリングに利用可能です。詳細については、テンプレート変数ガイドを参照してください。 |
| テンプレート | レンダリングするテンプレートを1つ以上提供します。通常、メッセージデータを構築するために1つのテンプレートが使用されます。一般的な構文と拡張については、テンプレートガイドを参照してください。 |
必要に応じて、テンプレートはユーザーとブローカープロパティにも参照され、注入することができます。
ベンダーのドキュメンテーション
最終更新日 :: 2020年January月23日