Udostępnij za pośrednictwem


Dodawanie niestandardowego punktu końcowego lub miejsca docelowego aplikacji niestandardowej do strumienia zdarzeń

Jeśli chcesz połączyć własną aplikację z strumieniem zdarzeń, możesz dodać niestandardowy punkt końcowy lub aplikację niestandardową jako miejsce docelowe. Następnie możesz korzystać ze zdarzeń w czasie rzeczywistym z strumienia zdarzeń do własnej aplikacji z punktem końcowym połączenia uwidocznionych w niestandardowym punkcie końcowym lub aplikacji niestandardowej. Ponadto przy użyciu protokołu Apache Kafka dostępnego jako opcja dla niestandardowych punktów końcowych lub aplikacji niestandardowych można korzystać ze zdarzeń w czasie rzeczywistym przy użyciu protokołu Apache Kafka.

W tym artykule przedstawiono sposób dodawania niestandardowego miejsca docelowego punktu końcowego lub niestandardowego miejsca docelowego aplikacji do strumieni zdarzeń w usłudze Microsoft Fabric.

Uwaga

Rozszerzone możliwości są domyślnie włączone podczas tworzenia strumieni zdarzeń. Jeśli masz strumienie zdarzeń utworzone przy użyciu standardowych możliwości, te strumienie zdarzeń będą nadal działać. Nadal możesz edytować i używać ich jak zwykle. Zalecamy utworzenie nowego strumienia zdarzeń w celu zastąpienia standardowych strumieni zdarzeń, dzięki czemu można korzystać z dodatkowych możliwości i korzyści z rozszerzonych strumieni zdarzeń.

Wymagania wstępne

Przed rozpoczęciem musisz uzyskać dostęp do obszaru roboczego w trybie licencji pojemności sieci szkieletowej (lub) tryb licencji wersji próbnej 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ń:

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

    Zrzut ekranu przedstawiający przycisk Edytuj, który umożliwia przełączenie do trybu edycji.

  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, wybierz pozycję Niestandardowy punkt końcowy, a następnie połącz punkt końcowy z domyślnym strumieniem lub strumieniem pochodnym.

      Zrzut ekranu przedstawiający wybór niestandardowego punktu końcowego jako miejsca docelowego na wstążce.

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

      Zrzut ekranu przedstawiający wybór niestandardowego punktu końcowego w edytorze.

  3. W polu Nazwa docelowa wprowadź nazwę niestandardowego punktu końcowego. Następnie wybierz opcję Zapisz.

    Zrzut ekranu przedstawiający okienko służące do wprowadzania nazwy niestandardowego punktu końcowego.

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

    Zrzut ekranu przedstawiający połączenie z niestandardowym kafelkiem punktu końcowego.

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

    Zrzut ekranu przedstawiający przycisk Publikuj.

Uzyskiwanie szczegółów punktu końcowego w okienku Szczegóły do korzystania ze zdarzeń

W widoku na żywo wybierz kafelek niestandardowego punktu końcowego. Wyświetlone okienko Szczegóły zawiera trzy karty protokołu: Event Hub, AMQP i Kafka.

Zrzut ekranu przedstawiający okienko Szczegóły dla niestandardowego punktu końcowego.

Każda karta protokołu ma trzy strony: Podstawowy, Klucze i Przykładowy kod. Te strony oferują szczegóły punktu końcowego z odpowiednim protokołem do nawiązywania połączenia.

W warstwie Podstawowa wyświetlana jest nazwa, typ i stan niestandardowego punktu końcowego.

Zrzut ekranu przedstawiający podstawowe szczegóły niestandardowego punktu końcowego w widoku na żywo transmisji zdarzeń.

Klucze zawierają informacje o kluczach połączenia. Przykładowy kod zawiera przykładowy kod z osadzonymi kluczami, którego można użyć do przesyłania strumieniowego zdarzeń do strumienia zdarzeń. Informacje na tych stronach różnią się w zależności od protokołu.

Centrum zdarzeń

Strona Klucze na karcie Centrum zdarzeń zawiera informacje dotyczące parametry połączenia centrum zdarzeń. Informacje obejmują nazwę centrum zdarzeń, nazwę klucza dostępu współdzielonego, klucz podstawowy i parametry połączenia — klucz podstawowy.

Zrzut ekranu przedstawiający klucze centrum zdarzeń w okienku Szczegóły widoku na żywo transmisji zdarzeń.

Format centrum zdarzeń jest domyślny dla parametry połączenia i współdziała z zestawem SDK usługi Azure Event Hubs. Ten format umożliwia nawiązywanie połączenia z strumieniem zdarzeń za pośrednictwem protokołu usługi Event Hubs.

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_xxxxxxx

Strona Przykładowy kod na karcie Centrum zdarzeń zawiera gotowy do użycia kod zawierający wymagane informacje o kluczach połączenia w centrum zdarzeń. Wystarczy skopiować i wkleić go do aplikacji do użycia.

Zrzut ekranu przedstawiający przykładowy kod centrum zdarzeń w okienku Szczegóły widoku na żywo transmisji zdarzeń.

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. Aby nawiązać połączenie ze strumieniem zdarzeń i korzystać z zdarzeń, możesz użyć informacji o kluczach i przykładowym kodzie dla formatu protokołu Kafka.

Zrzut ekranu przedstawiający klucze platformy Kafka w okienku Szczegóły widoku na żywo transmisji strumieniowej zdarzeń.

Przykładowa strona kodu na karcie Kafka zawiera gotowy kod, w tym niezbędne klucze połączenia w formacie platformy Kafka. Wystarczy skopiować go do użycia.

Zrzut ekranu przedstawiający przykładowy kod platformy Kafka w okienku Szczegóły widoku na żywo transmisji zdarzeń.

AMQP

Format AMQP jest zgodny z protokołem AMQP 1.0, który jest standardowym protokołem obsługi komunikatów, który obsługuje 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.

Zrzut ekranu przedstawiający klucze amQP w okienku Szczegóły widoku na żywo transmisji zdarzeń.

Przykładowa strona kodu na karcie AMQP zawiera gotowy do użycia kod z informacjami o kluczu połączenia w formacie AMQP.

Zrzut ekranu przedstawiający przykładowy kod protokołu AMQP w okienku Szczegóły widoku na żywo transmisji zdarzeń.

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 lub skopiować go na stronie Przykładowy kod , który pokazuje, jak wysyłać lub odbierać zdarzenia przy użyciu różnych protokołów.

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

Wymagania wstępne

Przed rozpoczęciem musisz uzyskać dostęp do obszaru roboczego strumienia zdarzeń w trybie licencji pojemności sieci szkieletowej (lub) w trybie licencji wersji próbnej z uprawnieniami współautora lub wyższymi uprawnieniami.

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ń:

  1. Wybierz pozycję Nowe miejsce docelowe na wstążce lub znak plus (+) na kanwie edytora głównego, a następnie wybierz pozycję Aplikacja niestandardowa.

  2. W okienku Aplikacja niestandardowa wprowadź nazwę docelową aplikacji niestandardowej, a następnie wybierz pozycję Dodaj.

    Zrzut ekranu przedstawiający okienko służące do konfigurowania aplikacji niestandardowej jako miejsca docelowego.

Uzyskiwanie szczegółów punktu końcowego w okienku Szczegóły do korzystania ze zdarzeń

Po pomyślnym utworzeniu aplikacji niestandardowej jako lokalizacji docelowej możesz wyświetlić informacje w okienku Szczegóły .

Zrzut ekranu przedstawiający okienko Szczegóły dla niestandardowego miejsca docelowego aplikacji.

Okienko Szczegóły zawiera trzy karty protokołu: Centrum zdarzeń, AMQP i Kafka. Każda karta protokołu ma trzy strony: Podstawowe, Klucze i Przykładowy kod. Te strony oferują szczegóły punktu końcowego z odpowiednim protokołem do nawiązywania połączenia.

W warstwie Podstawowa wyświetlana jest nazwa, typ i stan aplikacji niestandardowej.

Zrzut ekranu przedstawiający podstawowe szczegóły aplikacji niestandardowej w okienku Szczegóły strumienia zdarzeń.

Klucze zawierają informacje o kluczach połączenia. Przykładowy kod zawiera przykładowy kod z osadzonymi kluczami, którego można użyć do przesyłania strumieniowego zdarzeń do strumienia zdarzeń. Informacje na tych stronach różnią się w zależności od protokołu.

Centrum zdarzeń

Strona Klucze na karcie Centrum zdarzeń zawiera informacje dotyczące parametry połączenia centrum zdarzeń. Informacje obejmują nazwę centrum zdarzeń, nazwę klucza dostępu współdzielonego, klucz podstawowy i parametry połączenia — klucz podstawowy.

Zrzut ekranu przedstawiający klucze centrum zdarzeń w okienku Szczegóły strumienia zdarzeń.

Format centrum zdarzeń jest domyślny dla parametry połączenia i współdziała z zestawem SDK usługi Azure Event Hubs. Ten format umożliwia nawiązywanie połączenia z strumieniem zdarzeń za pośrednictwem protokołu usługi Event Hubs.

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_xxxxxxx

Strona Przykładowy kod na karcie Centrum zdarzeń zawiera gotowy do użycia kod zawierający wymagane informacje o kluczach połączenia w centrum zdarzeń. Wystarczy skopiować i wkleić go do aplikacji do użycia.

Zrzut ekranu przedstawiający przykładowy kod centrum zdarzeń w okienku Szczegóły strumienia zdarzeń.

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. Aby nawiązać połączenie ze strumieniem zdarzeń i korzystać z zdarzeń, możesz użyć informacji o kluczach i przykładowym kodzie dla formatu protokołu Kafka.

Zrzut ekranu przedstawiający klucze platformy Kafka w okienku Szczegóły strumienia zdarzeń.

Przykładowa strona kodu na karcie Kafka zawiera gotowy kod, w tym niezbędne klucze połączenia w formacie platformy Kafka. Wystarczy skopiować go do użycia.

Zrzut ekranu przedstawiający przykładowy kod platformy Kafka w okienku Szczegóły strumienia zdarzeń.

AMQP

Format AMQP jest zgodny z protokołem AMQP 1.0, który jest standardowym protokołem obsługi komunikatów, który obsługuje 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.

Zrzut ekranu przedstawiający klucze protokołu AMQP w okienku Szczegóły strumienia zdarzeń.

Przykładowa strona kodu na karcie AMQP zawiera gotowy do użycia kod z informacjami o kluczu połączenia w formacie AMQP.

Zrzut ekranu przedstawiający przykładowy kod protokołu AMQP w okienku Szczegóły strumienia zdarzeń.

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 lub skopiować go na stronie Przykładowy kod , który pokazuje, jak wysyłać lub odbierać zdarzenia przy użyciu różnych protokołów.

Zarządzanie miejscem docelowym

Możesz edytować (za pomocą polecenia Edytuj ) lub usunąć (za pomocą polecenia Usuń ) miejsce docelowe strumienia zdarzeń za pośrednictwem okienka Dane lub kanwy.

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

Zrzut ekranu pokazujący, gdzie wybrać opcje modyfikowania i usuwania miejsc docelowych na kanwie.

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