Udostępnij za pośrednictwem

Dodawanie danych niestandardowych do zdarzeń w Azure Event Hubs

  • Artykuł

Ponieważ zdarzenie składa się głównie z nieprzezroczystego zestawu bajtów, może być trudne dla konsumentów tych zdarzeń do podejmowania świadomych decyzji dotyczących sposobu ich przetwarzania. Aby umożliwić wydawcom zdarzeń oferowanie lepszego kontekstu dla konsumentów, zdarzenia mogą również zawierać metadane niestandardowe w postaci zestawu par klucz-wartość. Jednym z typowych scenariuszy włączenia metadanych jest dostarczenie wskazówek dotyczących typu danych zawartych w zdarzeniu, dzięki czemu konsumenci rozumieją jego format i mogą odpowiednio je deserializować.

Uwaga

Te metadane nie są używane ani w żaden sposób zrozumiały dla usługi Event Hubs; istnieje tylko w celu koordynacji między wydawcami zdarzeń i użytkownikami.

W poniższych sekcjach pokazano, jak dodać dane niestandardowe do zdarzeń w różnych językach programowania.

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

Aby zapoznać się z pełnym przykładem kodu, zobacz Publikowanie zdarzeń z niestandardowymi metadanymi.

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

Aby zapoznać się z pełnym przykładem kodu, zobacz Publikowanie zdarzeń z niestandardowymi metadanymi.

Python

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

Aby zapoznać się z pełnym przykładem kodu, zobacz Wysyłanie partii danych zdarzeń z właściwościami.

JavaScript

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

Następne kroki

Zapoznaj się z poniższymi przewodnikami Szybki start i przykładami.