Partager via


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.