Hinzufügen von benutzerdefinierten Daten zu Ereignissen in Azure Event Hubs

  • Artikel

Da ein Ereignis hauptsächlich aus einer undurchsichtigen Menge von Bytes besteht, ist es für Consumer dieser Ereignisse unter Umständen schwierig fundierte Entscheidungen hinsichtlich ihrer Verarbeitung zu treffen. Damit Ereignisherausgeber Consumern einen besseren Kontext bieten können, können Ereignisse auch benutzerdefinierte Metadaten in Form von mehreren Schlüssel-Wert-Paaren enthalten. Ein typisches Szenario für die Einbindung von Metadaten ist das Bereitstellen eines Hinweises zu dem in einem Ereignis enthaltenen Datentyp, sodass Consumer das Format erkennen und entsprechend deserialisieren können.

Hinweis

Diese Metadaten werden vom Event Hubs-Dienst nicht verwendet und sind für diesen nicht von Bedeutung. Sie dienen lediglich der Koordination zwischen Ereignisherausgebern und Consumern.

In den folgenden Abschnitten erfahren Sie, wie Sie benutzerdefinierte Daten in verschiedenen Programmiersprachen zu Ereignissen hinzufügen.

.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);

Das vollständige Codebeispiel finden Sie unter Publishing events with custom metadata (Veröffentlichen von Ereignissen mit benutzerdefinierten Metadaten).

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);

Das vollständige Codebeispiel finden Sie unter Publish events with custom metadata (Veröffentlichen von Ereignissen mit benutzerdefinierten Metadaten).

Python

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

Das vollständige Codebeispiel finden Sie unter Send Event Data batch with properties (Senden von Ereignisdatenbatches mit Eigenschaften).

JavaScript

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

Nächste Schritte

Weitere Informationen finden Sie in den folgenden Schnellstartanleitungen und Beispielen.