Dodawanie niestandardowego miejsca docelowego punktu końcowego do strumienia zdarzeń

W tym artykule przedstawiono sposób dodawania niestandardowego punktu końcowego (tj. niestandardowej aplikacji w standardowej możliwości) do strumieni zdarzeń w strumieniach zdarzeń usługi Microsoft Fabric.

Uwaga

Jeśli chcesz użyć rozszerzonych możliwości dostępnych w wersji zapoznawczej, wybierz pozycję Rozszerzone możliwości u góry. W przeciwnym razie wybierz pozycję Standardowe możliwości. Aby uzyskać informacje o rozszerzonych możliwościach dostępnych w wersji zapoznawczej, zobacz Wprowadzenie do strumieni zdarzeń usługi Fabric.

Wymagania wstępne

Przed rozpoczęciem należy spełnić następujące wymagania wstępne:

• Uzyskaj dostęp do obszaru roboczego w warstwie Premium z uprawnieniami współautora lub wyższymi uprawnieniami, w których znajduje się strumień zdarzeń.

Uwaga

Maksymalna liczba źródeł i miejsc docelowych dla jednego strumienia zdarzeń wynosi 11.

Dodawanie niestandardowego punktu końcowego jako miejsca docelowego

Jeśli chcesz kierować dane zdarzeń do aplikacji, możesz dodać niestandardowy punkt końcowy jako miejsce docelowe strumienia zdarzeń. Wykonaj następujące kroki, aby dodać niestandardową lokalizację docelową punktu końcowego:

1. Jeśli jesteś w widoku na żywo, przejdź do trybu edycji, wybierając pozycję Edytuj na wstążce.

   

2. W trybie edycji dodaj miejsce docelowe niestandardowego punktu końcowego w jeden z następujących sposobów:

   • Wybierz pozycję Dodaj miejsce docelowe na wstążce, a następnie wybierz pozycję Niestandardowy punkt końcowy i połącz go ze strumieniem domyślnym lub strumieniem pochodnym.

     

   • W edytorze wybierz pozycję Przekształć zdarzenia lub dodaj miejsce docelowe, a następnie wybierz pozycję Niestandardowy punkt końcowy.

     

3. Wprowadź nazwę docelową niestandardowego punktu końcowego i wybierz pozycję Zapisz.

   

4. Połącz domyślny kafelek strumienia z niestandardowym kafelkiem punktu końcowego, jeśli nie ma już połączenia.

   

5. Aby wyświetlić szczegółowe informacje o niestandardowym punkcie końcowym, wybierz pozycję Publikuj.

   

6. W widoku na żywo wybierz kafelek niestandardowego punktu końcowego. Następnie zobacz okienko Szczegóły w dolnej części strony. Aby uzyskać więcej informacji, zapoznaj się z następną sekcją.

   

Okienko Szczegóły

Okienko Szczegóły zawiera trzy karty protokołu: Eventhub, AMQP i Kafka. Każda karta protokołu ma trzy strony: Podstawowe, Klucze i Przykładowy kod.

Podstawy

Na stronie Podstawowe przedstawiono następujące informacje:

• Nazwa — nazwa niestandardowego punktu końcowego.
• Typ — jest ustawiona na CustomAppwartość .
• Grupa konsumentów — globalnie unikatowy identyfikator (GUID) dla grupy odbiorców.
• Stan — stan niestandardowego punktu końcowego.

Klucze

Strona Klucze ma następujące typowe pola w trzech protokołach: Nazwa klucza dostępu współdzielonego, klucz podstawowy, klucz pomocniczy, parametry połączenia z kluczem podstawowym i parametry połączenia z kluczem pomocniczym.

Na karcie Event Hubs zostanie wyświetlona nazwa centrum zdarzeń. Na karcie AMQP zostanie wyświetlona nazwa jednostki. Na karcie Kafka są widoczne następujące informacje: Bootstrap server, Security protocol, SASL mechanism, SASL JASS config i nazwa tematu.

Przykładowy kod

Przedstawia przykładowy kod, którego można użyć do odbierania zdarzeń z niestandardowego miejsca docelowego punktu końcowego z aplikacji.

Centrum zdarzeń

Parametry połączenia jest zgodna z usługą Event Hubs parametry połączenia i można jej używać w aplikacji do odbierania zdarzeń ze strumienia zdarzeń. W poniższym przykładzie pokazano, jak wygląda parametry połączenia w formacie centrum zdarzeń: Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxxx.

Format centrum zdarzeń jest domyślnym formatem parametry połączenia i jest zgodny z zestawem SDK usługi Azure Event Hubs. Możesz użyć tego formatu, aby nawiązać połączenie z strumieniem zdarzeń przy użyciu protokołu usługi Event Hubs.

AMQP

Format AMQP jest zgodny z protokołem AMQP 1.0, który jest standardowym protokołem obsługi komunikatów obsługującym współdziałanie między różnymi platformami i językami. Możesz użyć tego formatu, aby nawiązać połączenie z strumieniem zdarzeń przy użyciu protokołu AMQP.

Kafka

Format platformy Kafka jest zgodny z protokołem Apache Kafka, który jest popularną rozproszoną platformą przesyłania strumieniowego, która obsługuje przetwarzanie danych o wysokiej przepływności i małych opóźnieniach. Możesz użyć tego formatu, aby nawiązać połączenie z strumieniem zdarzeń przy użyciu protokołu Kafka.

Możesz wybrać format protokołu odpowiadający potrzebom i preferencjom aplikacji, a następnie skopiować i wkleić parametry połączenia do aplikacji. Możesz również odwołać się do przykładowego kodu podanego na karcie Przykładowy kod lub skopiować go, który pokazuje sposób wysyłania lub odbierania zdarzeń przy użyciu różnych protokołów.

Powiązana zawartość

Aby dowiedzieć się, jak dodać inne miejsca docelowe do strumienia zdarzeń, zobacz następujące artykuły:

• Strumień pochodny   
• Baza danych KQL  
• Lakehouse
• Odruch

Wymagania wstępne

Przed rozpoczęciem należy spełnić następujące wymagania wstępne:

• Uzyskaj dostęp do obszaru roboczego w warstwie Premium z uprawnieniami współautora lub wyższymi uprawnieniami, w których znajduje się strumień zdarzeń.

Uwaga

Maksymalna liczba źródeł i miejsc docelowych dla jednego strumienia zdarzeń wynosi 11.

Dodawanie aplikacji niestandardowej jako miejsca docelowego

Jeśli chcesz kierować dane zdarzeń do aplikacji, możesz dodać aplikację niestandardową jako miejsce docelowe strumienia zdarzeń. Wykonaj następujące kroki, aby dodać lokalizację docelową aplikacji niestandardowej:

1. Wybierz pozycję Nowe miejsce docelowe na wstążce lub "+" na kanwie edytora głównego, a następnie wybierz pozycję Aplikacja niestandardowa. Zostanie wyświetlony ekran Konfiguracja docelowa aplikacji niestandardowej.

2. Wprowadź nazwę docelową aplikacji niestandardowej i wybierz pozycję Dodaj.

   

3. Po pomyślnym utworzeniu lokalizacji docelowej aplikacji niestandardowej możesz przełączyć i wyświetlić następujące informacje na karcie Szczegóły w dolnym okienku:

   

   • Podstawowe: przedstawia nazwę, opis, typ i stan aplikacji niestandardowej.
   • Klucze: pokazuje parametry połączenia dla aplikacji niestandardowej, którą można skopiować i wkleić do aplikacji.
   • Przykładowy kod: przedstawia przykładowy kod, do którego można odwołać się lub skopiować, aby wypchnąć dane zdarzenia do tego strumienia zdarzeń lub ściągnąć dane zdarzenia z tego strumienia zdarzeń.

   Dla każdej karty (przykładowy kod kluczy / podstawowych / ) można również przełączać trzy karty protokołów: Eventhub, **AMQP i Kafka, aby uzyskać dostęp do różnych informacji o formatach protokołu:

   Parametry połączenia jest parametry połączenia zgodnym z centrum zdarzeń i można go użyć w aplikacji do odbierania zdarzeń z strumienia zdarzeń. Parametry połączenia ma wiele formatów protokołu, które można przełączać i wybierać na karcie Klucze. W poniższym przykładzie pokazano, jak wygląda parametry połączenia w formacie centrum zdarzeń:

   Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxxx

   Format centrum zdarzeń jest domyślnym formatem parametry połączenia i jest zgodny z zestawem SDK usługi Azure Event Hubs. Możesz użyć tego formatu, aby nawiązać połączenie z strumieniem zdarzeń przy użyciu protokołu usługi Event Hubs.

   

   Pozostałe dwa formaty protokołów to AMQP i Kafka, które można wybrać, klikając odpowiednie karty na karcie Klucze.

   Format AMQP jest zgodny z protokołem AMQP 1.0, który jest standardowym protokołem obsługi komunikatów obsługującym współdziałanie między różnymi platformami i językami. Możesz użyć tego formatu, aby nawiązać połączenie z strumieniem zdarzeń przy użyciu protokołu AMQP.

   Format platformy Kafka jest zgodny z protokołem Apache Kafka, który jest popularną rozproszoną platformą przesyłania strumieniowego, która obsługuje przetwarzanie danych o wysokiej przepływności i małych opóźnieniach. Możesz użyć tego formatu, aby nawiązać połączenie z strumieniem zdarzeń przy użyciu protokołu Kafka.

Możesz wybrać format protokołu odpowiadający potrzebom i preferencjom aplikacji, a następnie skopiować i wkleić parametry połączenia do aplikacji. Możesz również odwołać się do przykładowego kodu podanego na karcie Przykładowy kod lub skopiować go, który pokazuje sposób wysyłania lub odbierania zdarzeń przy użyciu różnych protokołów.

Zarządzanie miejscem docelowym

Edytuj/usuń: możesz edytować lub usunąć miejsce docelowe strumienia zdarzeń za pośrednictwem okienka nawigacji lub kanwy.

Po wybraniu pozycji Edytuj okienko edycji zostanie otwarte po prawej stronie edytora głównego. Konfigurację można zmodyfikować zgodnie z życzeniem, w tym logikę przekształcania zdarzeń za pośrednictwem edytora procesora zdarzeń.

Powiązana zawartość

Aby dowiedzieć się, jak dodać inne miejsca docelowe do strumienia zdarzeń, zobacz następujące artykuły:

• Baza danych KQL  
• Lakehouse
• Odruch