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 } };
次のステップ
次のクイック スタートおよびサンプルを参照してください。
- クイックスタート: .NET、Java、Python、JavaScript
- GitHub のサンプル: .NET、Java、Python、JavaScript、TypeScript