Condividi tramite

Aggiungere dati personalizzati agli eventi in Hub eventi di Azure

  • Articolo

Poiché un evento è costituito principalmente da un set opaco di byte, può essere difficile per gli utenti di tali eventi prendere decisioni informate su come elaborarle. Per consentire agli editori di eventi di offrire un contesto migliore per i consumer, gli eventi possono contenere anche metadati personalizzati, sotto forma di un set di coppie chiave-valore. Uno scenario comune per l'inclusione dei metadati consiste nel fornire un suggerimento sul tipo di dati contenuti in un evento, in modo che i consumer comprendano il formato e possano deserializzarlo in modo appropriato.

Nota

Questi metadati non vengono usati né in alcun modo significativi per il servizio Hub eventi; esiste solo per il coordinamento tra editori di eventi e consumer.

Le sezioni seguenti illustrano come aggiungere dati personalizzati agli eventi in linguaggi di programmazione diversi.

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

Per l'esempio di codice completo, vedere Pubblicazione di eventi con metadati personalizzati.

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

Per l'esempio di codice completo, vedere Pubblicare eventi con metadati personalizzati.

Python

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

Per l'esempio di codice completo, vedere Inviare un batch di dati eventi con proprietà.

JavaScript

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

Passaggi successivi

Vedere le guide introduttive e gli esempi seguenti.