Udostępnij za pośrednictwem


Dodawanie niestandardowego punktu końcowego lub niestandardowego źródła aplikacji 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 źródło. Następnie możesz wysyłać zdarzenia w czasie rzeczywistym do strumienia zdarzeń z własnej aplikacji przy użyciu punktu końcowego połączenia uwidocznionego w niestandardowym punkcie końcowym lub aplikacji niestandardowej. Ponadto przy użyciu protokołu Apache Kafka dostępnego jako opcji niestandardowych punktów końcowych lub aplikacji niestandardowych można wysyłać zdarzenia w czasie rzeczywistym przy użyciu protokołu Apache Kafka.

W tym artykule pokazano, jak dodać niestandardowe źródło punktu końcowego lub niestandardowe źródło aplikacji 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ę Możliwości standardowe. 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 musisz uzyskać dostęp do obszaru roboczego Premium usługi Fabric z uprawnieniami współautora lub wyższymi uprawnieniami.

Uwaga

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

Dodawanie niestandardowych danych punktu końcowego jako źródła

  1. Utwórz nowy strumień zdarzeń:

    1. Na stronie głównej wybierz pozycję Eventstream.

    2. W oknie dialogowym Nowy strumień zdarzeń wprowadź nazwę, upewnij się, że wybrano opcję Rozszerzone możliwości (wersja zapoznawcza), a następnie wybierz pozycję Utwórz.

      Zrzut ekranu przedstawiający okno dialogowe tworzenia nowego strumienia zdarzeń.

  2. Aby dodać niestandardowe źródło punktu końcowego, na stronie wprowadzenie wybierz pozycję Użyj niestandardowego punktu końcowego.

    Zrzut ekranu przedstawiający opcję użycia niestandardowego punktu końcowego.

    Lub jeśli masz już opublikowany strumień zdarzeń i chcesz dodać niestandardowe dane punktu końcowego jako źródło, przełącz się do trybu edycji. Na wstążce wybierz pozycję Dodaj źródłowy punkt>końcowy niestandardowy.

    Zrzut ekranu przedstawiający wybieranie niestandardowego punktu końcowego jako źródła dla istniejącego strumienia zdarzeń.

  3. W oknie dialogowym Niestandardowy punkt końcowy wprowadź nazwę niestandardowego źródła w obszarze Nazwa źródła, a następnie wybierz pozycję Dodaj.

    Zrzut ekranu przedstawiający okno dialogowe dodawania niestandardowego punktu końcowego.

  4. Po utworzeniu niestandardowego źródła punktu końcowego zostanie ono dodane do strumienia zdarzeń na kanwie w trybie edycji. Aby zaimplementować nowo dodane dane ze źródła aplikacji niestandardowej, wybierz pozycję Publikuj.

    Zrzut ekranu przedstawiający strumień zdarzeń w trybie edycji z wyróżnionym przyciskiem Publikuj.

Pobieranie szczegółów punktu końcowego w okienku Szczegóły w celu wysyłania zdarzeń

Po utworzeniu niestandardowego źródła punktu końcowego jego dane są dostępne do wizualizacji w widoku na żywo.

Zrzut ekranu przedstawiający strumień zdarzeń w widoku na żywo.

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 niestandardowego punktu końcowego.

Zrzut ekranu przedstawiający podstawowe informacje w okienku Szczegóły 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 kluczowe informacje 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 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. Możesz użyć informacji o kluczach i przykładowym kodzie dla formatu protokołu Kafka, aby nawiązać połączenie ze strumieniem zdarzeń i przesyłać strumieniowo zdarzenia.

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 źródła do strumienia zdarzeń, zobacz następujące artykuły:

Wymagania wstępne

Przed rozpoczęciem musisz uzyskać 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 źródła

Jeśli chcesz połączyć własną aplikację z strumieniem zdarzeń, możesz dodać niestandardowe źródło aplikacji. Następnie wyślij dane do strumienia zdarzeń z własnej aplikacji przy użyciu punktu końcowego połączenia uwidocznionego w aplikacji niestandardowej.

Aby dodać niestandardowe źródło aplikacji:

  1. Wybierz pozycję Nowe źródło 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ę źródłową aplikacji niestandardowej, a następnie wybierz pozycję Dodaj.

    Zrzut ekranu przedstawiający okienko konfigurowania aplikacji niestandardowej jako źródła.

Pobieranie szczegółów punktu końcowego w okienku Szczegóły w celu wysyłania zdarzeń

Po pomyślnym utworzeniu aplikacji niestandardowej jako źródła możesz wyświetlić informacje w okienku Szczegóły .

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.

Zrzut ekranu przedstawiający źródło aplikacji niestandardowej.

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

Zrzut ekranu przedstawiający podstawowe informacje dotyczące 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 kluczowe informacje 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 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. Możesz użyć informacji o kluczach i przykładowym kodzie dla formatu protokołu Kafka, aby nawiązać połączenie ze strumieniem zdarzeń i przesyłać strumieniowo zdarzenia.

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.

Aby dowiedzieć się, jak dodać inne źródła do strumienia zdarzeń, zobacz następujące artykuły: