Ajouter des données personnalisées à des événements dans Azure Event Hubs
Étant donné qu’un événement se compose principalement d’un ensemble opaque d’octets, il peut être difficile pour les consommateurs de ces événements de prendre des décisions avisées sur la façon de les traiter. Pour permettre aux éditeurs d’événements d’offrir un meilleur contexte aux consommateurs, les événements peuvent également contenir des métadonnées personnalisées, sous la forme d’un ensemble de paires clé-valeur. Un scénario commun pour l’inclusion de métadonnées consiste à fournir une indication sur le type de données contenues par un événement, afin que les consommateurs comprennent son format et puissent le désérialiser de manière appropriée.
Notes
Ces métadonnées ne sont pas utilisées par le service Event Hubs, ou de quelque façon que ce soit. Elles existent uniquement pour la coordination entre les éditeurs d’événements et les consommateurs.
Les sections suivantes vous montrent comment ajouter des données personnalisées à des événements dans différents langages de programmation.
.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);
Pour obtenir l’exemple de code complet, consultez Publication d’événements avec des métadonnées personnalisées.
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);
Pour obtenir l’exemple de code complet, consultez publier des événements avec des métadonnées personnalisées.
Python
event_data = EventData('Message with properties')
event_data.properties = {'event-type': 'com.microsoft.samples.hello-event', 'priority': 1, "score": 9.0}
Pour obtenir l’exemple de code complet, consultez Envoyer un lot de données d’événements avec des propriétés.
JavaScript
let eventData = { body: "First event", properties: { "event-type": "com.microsoft.samples.hello-event", "priority": 1, "score": 9.0 } };
Étapes suivantes
Consultez les démarrages rapides et échantillons suivants.
- Démarrages rapides : .NET, Java, Python, JavaScript
- Échantillons sur GitHub : .NET, Java, Python, JavaScript, TypeScript