Compartir a través de

Agregar datos personalizados a eventos en Azure Event Hubs

  • Artículo

Dado que un evento se compone principalmente de un conjunto opaco de bytes, puede ser difícil para los consumidores de esos eventos tomar decisiones informadas sobre cómo procesarlos. Para permitir que los publicadores de eventos ofrezcan mejor contexto a los consumidores, los eventos también pueden contener metadatos personalizados, en forma de un conjunto de pares clave-valor. Un escenario común para la inclusión de metadatos es proporcionar una sugerencia sobre el tipo de datos que contiene un evento, para que los consumidores sepan su formato y puedan deserializarlo adecuadamente.

Nota

Estos metadatos no se usan en el servicio Event Hubs, o de forma que sea significativo. solo existe para la coordinación entre los publicadores de eventos y los consumidores.

En las secciones siguientes se muestra cómo agregar datos personalizados a eventos en diferentes lenguajes de programación.

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

Para obtener el ejemplo de código completo, consulte publicación de eventos con metadatos personalizados.

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

Para obtener el ejemplo de código completo, vea publicar eventos con metadatos personalizados.

Python

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

Para obtener el ejemplo de código completo, consulte Enviar un lote de datos de eventos con propiedades.

JavaScript

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

Pasos siguientes

Consulte las guías de inicio rápido y los ejemplos siguientes.