Share via

Azure Event Hubs のイベントにカスタム データを追加する

  • [アーティクル]

イベントは主に不透明なバイトのセットで構成されるため、その処理方法について、これらのイベントのコンシューマーが、情報に基づいた決定を行うことが困難な場合があります。 イベントの発行元がより優れたコンテキストをコンシューマーに提供できるようにするために、イベントに、一連のキーと値のペアの形式でカスタム メタデータを含めることもできます。 メタデータを含める一般的なシナリオの 1 つは、イベントに含まれるデータの種類に関するヒントを提供して、コンシューマーがその形式を理解し、適切に逆シリアル化できるようにすることです。

注意

このメタデータは、Event Hubs サービスによって使用されることも、何らかの方法で解釈されることもありません。これは、イベントの発行元とコンシューマーの間で調整を行うためだけに存在します。

以下のセクションでは、さまざまなプログラミング言語でイベントにカスタム データを追加する方法について説明します。

.NET

var eventBody = new BinaryData("Hello, Event Hubs!");
var eventData = new EventData(eventBody);
eventData.Properties.Add("EventType", "com.microsoft.samples.hello-event");
eventData.Properties.Add("priority", 1);
eventData.Properties.Add("score", 9.0);

完全なコード サンプルについては、「カスタム メタデータとともにイベントを発行する」を参照してください。

Java

EventData firstEvent = new EventData("EventData Sample 1".getBytes(UTF_8));
firstEvent.getProperties().put("EventType", "com.microsoft.samples.hello-event");
firstEvent.getProperties().put("priority", 1);
firstEvent.getProperties().put("score", 9.0);

完全なコード サンプルについては、「カスタム メタデータとともにイベントを発行する」を参照してください。

Python

event_data = EventData('Message with properties')
event_data.properties = {'event-type': 'com.microsoft.samples.hello-event', 'priority': 1, "score": 9.0}

完全なコード サンプルについては、イベント データ バッチとプロパティの送信に関するページを参照してください。

JavaScript

let eventData = { body: "First event", properties: { "event-type": "com.microsoft.samples.hello-event", "priority": 1, "score": 9.0  } };

次のステップ

次のクイック スタートおよびサンプルを参照してください。