Aangepaste gegevens toevoegen aan gebeurtenissen in Azure Event Hubs
Omdat een gebeurtenis voornamelijk bestaat uit een ondoorzichtige set bytes, kan het voor gebruikers van deze gebeurtenissen moeilijk zijn om weloverwogen beslissingen te nemen over de verwerking ervan. Om gebeurtenisuitgevers in staat te stellen consumenten betere context te bieden, kunnen gebeurtenissen ook aangepaste metagegevens bevatten, in de vorm van een set sleutel-waardeparen. Een veelvoorkomend scenario voor het opnemen van metagegevens is het geven van een hint over het type gegevens dat een gebeurtenis bevat, zodat consumenten de indeling ervan begrijpen en deze op de juiste manier kunnen deserialisatie uitvoeren.
Notitie
Deze metagegevens worden niet gebruikt door of op enigerlei wijze zinvol voor de Event Hubs-service; het bestaat alleen voor coördinatie tussen uitgevers en consumenten van gebeurtenissen.
In de volgende secties ziet u hoe u aangepaste gegevens toevoegt aan gebeurtenissen in verschillende programmeertalen.
.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);
Zie Gebeurtenissen publiceren met aangepaste metagegevens voor het volledige codevoorbeeld.
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);
Zie Gebeurtenissen met aangepaste metagegevens publiceren voor het volledige codevoorbeeld.
Python
event_data = EventData('Message with properties')
event_data.properties = {'event-type': 'com.microsoft.samples.hello-event', 'priority': 1, "score": 9.0}
Zie Gebeurtenisgegevensbatch met eigenschappen verzenden voor het volledige codevoorbeeld.
JavaScript
let eventData = { body: "First event", properties: { "event-type": "com.microsoft.samples.hello-event", "priority": 1, "score": 9.0 } };
Volgende stappen
Zie de volgende quickstarts en voorbeelden.
- Quickstarts: .NET, Java, Python, JavaScript
- Voorbeelden op GitHub: .NET, Java, Python, JavaScript, TypeScript