Udostępnij za pośrednictwem

Uruchamianie operacji danych w usłudze Service Bus za pomocą Eksploratora usługi Service Bus

  • Artykuł

Usługa Azure Service Bus umożliwia aplikacjom klienckim nadawcy i odbiorcy oddzielenie logiki biznesowej przy użyciu znanych semantyki punkt-punkt-punkt (kolejka) i publish-subscribe (Topic-Subscription).

Uwaga

W tym artykule przedstawiono funkcje Eksploratora usługi Azure Service Bus będącego częścią witryny Azure Portal.

Eksplorator usługi Service Bus należący do społeczności jest aplikacją autonomiczną i różni się od tej aplikacji.

Operacje uruchamiane w przestrzeni nazw usługi Azure Service Bus są dwa rodzaje.

  • Operacje zarządzania — tworzenie, aktualizowanie, usuwanie przestrzeni nazw, kolejek, tematów i subskrypcji usługi Service Bus.
  • Operacje na danych — wysyłanie i odbieranie komunikatów z kolejek, tematów i subskrypcji.

Ważne

  • Eksplorator usługi Service Bus nie obsługuje operacji zarządzania i sesji.
  • Zalecamy korzystanie z Eksploratora usługi Service Bus w przypadku większych komunikatów, ponieważ może to spowodować przekroczenie limitu czasu, w zależności od rozmiaru komunikatu, opóźnienia sieci między klientem a usługą Service Bus itp. Zamiast tego zalecamy używanie własnego klienta do pracy z większymi komunikatami, gdzie można określić własne wartości limitu czasu.

Wymagania wstępne

Aby użyć narzędzia Service Bus Explorer, należy wykonać następujące zadania:

  • Utwórz przestrzeń nazw usługi Azure Service Bus.

  • Utwórz kolejkę do wysyłania i odbierania komunikatów z lub tematu z subskrypcją w celu przetestowania funkcji. Aby dowiedzieć się, jak tworzyć kolejki, tematy i subskrypcje, zobacz następujące artykuły:

    Uwaga

    Upewnij się, że jesteś członkiem jednej z tych ról w przestrzeni nazw lub jednostkach, na których chcesz wykonać operacje wysyłania lub odbierania (w tym wglądu i przeczyszczania):

    • Właściciel danych usługi Service Bus; Umożliwia zarówno operacje wysyłania, jak i odbierania.
    • Nadawca danych usługi Service Bus; Zezwala na operacje wysyłania.
    • Odbiornik danych usługi Service Bus; Umożliwia wykonywanie operacji odbierania.

Korzystanie z Eksploratora usługi Service Bus

Aby użyć Eksploratora usługi Service Bus, przejdź do przestrzeni nazw usługi Service Bus, w której chcesz wykonywać operacje na danych.

  1. Jeśli chcesz uruchamiać operacje względem kolejki, wybierz pozycję Kolejki z menu nawigacji. Jeśli chcesz uruchamiać operacje względem tematu (i jest to powiązane subskrypcje), wybierz pozycję Tematy.

    Zrzut ekranu przedstawiający nawigację po lewej stronie, w której można wybrać jednostkę.

  2. Po wybraniu pozycji Kolejki lub tematy wybierz określoną kolejkę lub temat.

    Zrzut ekranu przedstawiający stronę Kolejki z wybraną określoną kolejką.

  3. Wybierz Eksploratora usługi Service Bus z menu nawigacji po lewej stronie

    Zrzut ekranu przedstawiający stronę kolejki, na której można wybrać Eksploratora usługi Service Bus.

    Uwaga

    Podczas podglądu lub odbierania z subskrypcji najpierw wybierz określoną subskrypcję z selektora listy rozwijanej. Zrzut ekranu przedstawiający listę rozwijaną subskrypcji tematów.

Podgląd wiadomości

Korzystając z funkcji podglądu, możesz użyć Eksploratora usługi Service Bus, aby wyświetlić 100 pierwszych komunikatów w kolejce, subskrypcji lub kolejce utraconych komunikatów.

  1. Aby zajrzeć do komunikatów, wybierz pozycję Podgląd trybu na liście rozwijanej Eksplorator usługi Service Bus.

    Zrzut ekranu przedstawiający listę rozwijaną z wybraną funkcją Podgląd trybu.

  2. Sprawdź metryki, aby sprawdzić, czy istnieją aktywne komunikaty lub komunikaty z utraconymi literami, aby wyświetlić i wybrać podzapytę Kolejka/subskrypcja lub DeadLetter.

    Zrzut ekranu przedstawiający karty kolejki i kolejki utraconych komunikatów z wyświetlonymi metrykami komunikatów.

  3. Wybierz przycisk Zobacz od początku.

    Zrzut ekranu wskazujący przycisk Zobacz od początku.

  4. Po zakończeniu operacji podglądu na siatce zostanie wyświetlonych maksymalnie 100 komunikatów, jak pokazano na poniższej ilustracji. Aby wyświetlić szczegóły określonego komunikatu, wybierz go z siatki. Możesz wyświetlić treść lub właściwości komunikatu.

    Zrzut ekranu przedstawiający przegląd wyświetlanych komunikatów i zawartości treści wiadomości pod kątem podglądu komunikatów.

    Przejdź do karty Właściwości komunikatu w dolnym okienku, aby wyświetlić metadane.

    Zrzut ekranu przedstawiający przegląd wyświetlonych komunikatów i właściwości komunikatów dotyczących podglądu komunikatów.

    Uwaga

    Ponieważ przeglądanie nie jest operacją destrukcyjną, komunikat nie zostanie usunięty z jednostki.

    Uwaga

    Ze względu na wydajność podczas podglądu komunikatów z kolejki lub subskrypcji, która ma maksymalny rozmiar komunikatu ustawiony na 1 MB, treść komunikatu nie zostanie domyślnie pobrana. Zamiast tego możesz załadować treść komunikatu dla określonej wiadomości, klikając przycisk Załaduj treść komunikatu. Jeśli treść komunikatu jest ponad 1 MB, zostanie obcięta przed wyświetleniem. Zrzut ekranu przedstawiający przegląd wyświetlonych komunikatów i przycisków w celu załadowania wyświetlanej treści komunikatu.

Zobacz komunikat z opcjami zaawansowanymi

Podgląd funkcji opcji umożliwia wyświetlanie najważniejszych komunikatów w kolejce, subskrypcji lub kolejce utraconych komunikatów przy użyciu Eksploratora usługi Service Bus, określając liczbę komunikatów do zajrzeć oraz numer sekwencji, aby rozpocząć operację podglądu.

  1. Aby zajrzeć do komunikatów z opcjami zaawansowanymi, wybierz pozycję Podgląd trybu na liście rozwijanej Eksplorator usługi Service Bus.

    Zrzut ekranu przedstawiający listę rozwijaną z wybraną opcją Zobacz tryb podglądu z opcjami zaawansowanymi.

  2. Sprawdź metryki, aby sprawdzić, czy istnieją aktywne komunikaty lub komunikaty z utraconymi literami, aby wyświetlić i wybrać podzapytę Kolejka/subskrypcja lub DeadLetter.

    Zrzut ekranu przedstawiający karty kolejki i kolejki utraconych komunikatów z wyświetlonymi metrykami komunikatów, aby wyświetlić zaawansowane opcje.

  3. Wybierz przycisk Zobacz z opcjami. Podaj liczbę komunikatów, z których chcesz zajrzeć, oraz numer sekwencji, z których chcesz zacząć się zajrzeć, a następnie wybierz przycisk Zobacz .

    Zrzut ekranu przedstawiający przycisk Zobacz z opcjami i stronę, na której można ustawić opcje.

  4. Po zakończeniu operacji podglądu komunikaty są wyświetlane w siatce, jak pokazano na poniższej ilustracji. Aby wyświetlić szczegóły określonego komunikatu, wybierz go z siatki. Możesz wyświetlić treść lub właściwości komunikatu.

    Zrzut ekranu przedstawiający przegląd wyświetlanych komunikatów i zawartości treści wiadomości w celu wglądu w opcje zaawansowane.

    Przejdź do karty Właściwości komunikatu w dolnym okienku, aby wyświetlić metadane.

    Zrzut ekranu przedstawiający przegląd wyświetlanych komunikatów i właściwości komunikatów, aby wyświetlić zaawansowane opcje.

    Uwaga

    Ponieważ podgląd nie jest operacją destrukcyjną, komunikat nie zostanie usunięty z kolejki.

Odbieranie komunikatu

Funkcja receive w Eksploratorze usługi Service Bus umożliwia odbieranie komunikatów z kolejki lub subskrypcji.

  1. Aby odbierać komunikaty, wybierz pozycję Tryb odbierania na liście rozwijanej Eksplorator usługi Service Bus.

    Zrzut ekranu przedstawiający listę rozwijaną z wybranym trybem odbierania.

  2. Sprawdź metryki, aby sprawdzić, czy istnieją aktywne komunikaty lub komunikaty z utraconymi literami, które mają zostać odebrane, i wybierz pozycję Kolejka/subskrypcja lub DeadLetter.

    Zrzut ekranu przedstawiający karty kolejki i kolejki utraconych komunikatów z metrykami komunikatów wyświetlanymi w trybie odbierania.

  3. Wybierz przycisk Odbierz komunikaty i określ tryb odbierania, liczbę komunikatów do odebrania oraz maksymalny czas oczekiwania na komunikat i wybierz pozycję Odbierz.

    Zrzut ekranu przedstawiający przycisk Odbierz i stronę, na której można ustawić opcje.

    Ważne

    Należy pamiętać, że tryb ReceiveAndDelete jest destrukcyjnym odbieraniem, tj. komunikat jest usuwany z kolejki, gdy jest wyświetlany w narzędziu Service Bus Explorer.

    Aby przeglądać komunikaty bez usuwania ich z kolejki, rozważ użycie funkcji Podgląd lub tryb odbierania PeekLock .

  4. Po zakończeniu operacji odbierania komunikaty są wyświetlane w siatce, jak pokazano na poniższej ilustracji. Aby wyświetlić szczegóły określonego komunikatu, wybierz go w siatce.

    Zrzut ekranu przedstawiający przegląd wyświetlanych komunikatów i treści wiadomości.

    Zrzut ekranu przedstawiający przegląd odebranych komunikatów i właściwości komunikatów.

    Uwaga

    Ze względu na wydajność podczas odbierania komunikatów z kolejki lub subskrypcji, która ma maksymalny rozmiar komunikatu ustawiony na 1 MB, w danym momencie zostanie odebrany tylko jeden komunikat. Jeśli treść komunikatu jest ponad 1 MB, zostanie obcięta przed wyświetleniem.

Po odebraniu komunikatu w trybie PeekLock istnieją różne akcje, które możemy wykonać.

Uwaga

Możemy wykonać te działania tylko tak długo, jak mamy blokadę komunikatu.

Ukończ komunikat

  1. W siatce wybierz odebrane komunikaty, które chcemy ukończyć.

  2. Wybierz przycisk Zakończ.

    Zrzut ekranu wskazujący przycisk Zakończ.

    Ważne

    Pamiętaj, że ukończenie komunikatu jest destrukcyjnym odbieraniem, tj. komunikat jest usuwany z kolejki po wybraniu opcji Ukończono w narzędziu Service Bus Explorer.

Odroczenie komunikatu

  1. W siatce wybierz odebrane komunikaty, które chcemy odroczyć.

  2. Wybierz przycisk Odroczenie.

    Zrzut ekranu wskazujący przycisk Odroczenie.

Porzucanie blokady

  1. W siatce wybierz odebrane komunikaty, dla których chcemy porzucić blokadę.

  2. Wybierz przycisk Porzuć blokadę.

    Zrzut ekranu wskazujący przycisk Porzuć blokadę.

Po porzuceniu blokady komunikat będzie ponownie dostępny dla operacji odbierania.

Utracony list

  1. W siatce wybierz odebrane wiadomości, których chcemy użyć.

  2. Wybierz przycisk Utracony list.

    Zrzut ekranu wskazujący przycisk Utracony list.

Po tym, jak wiadomość została martwa, będzie dostępna z podzapytania Dead-letter .

Przeczyszczanie komunikatów

Aby przeczyścić komunikaty, wybierz przycisk Przeczyść komunikaty w Eksploratorze usługi Service Bus.

Zrzut ekranu wskazujący przycisk przeczyszczania komunikatów.

Po wprowadzeniu "przeczyszczania", aby potwierdzić operację, komunikaty będą czyszczone z odpowiedniej jednostki usługi Service Bus.

Wysyłanie komunikatu do kolejki lub tematu

Aby wysłać komunikat do kolejki lub tematu, wybierz przycisk Wyślij komunikaty w Eksploratorze usługi Service Bus.

  1. Wybierz typ zawartości, aby mieć wartość Text/Plain, Application/Xml lub Application/Json.

  2. W polu Treść wiadomości dodaj zawartość wiadomości. Upewnij się, że jest on zgodny z ustawionym wcześniej typem zawartości.

  3. Ustaw właściwości brokera (opcjonalnie) — obejmują one identyfikator korelacji, identyfikator wiadomości, odpowiedźto, etykietę/temat, czas wygaśnięcia (TTL) i zaplanowany czas kolejkowania (dla zaplanowanych komunikatów).

  4. Ustaw właściwości niestandardowe (opcjonalnie) — mogą to być dowolne właściwości użytkownika ustawione względem klucza słownika.

  5. Zaznacz pole Wyboru Powtarzaj wysyłanie, aby wysłać tę samą wiadomość wielokrotnie. Jeśli nie ustawiono identyfikatora komunikatu, zostanie on automatycznie wypełniony wartościami sekwencyjnymi.

  6. Po skomponowanym komunikacie wybierz przycisk Wyślij .

    Zrzut ekranu przedstawiający środowisko komunikatu redagowania.

  7. Po pomyślnym zakończeniu operacji wysyłania zostanie wykonana jedna z następujących czynności:

    • W przypadku wysyłania do kolejki licznik metryk aktywnych komunikatów zwiększa się.
    • W przypadku wysyłania do tematu licznik metryk Aktywne komunikaty zwiększa się w subskrypcjach, do których został przekierowany komunikat.

Wyślij ponownie wiadomość

Po wyświetleniu lub odebraniu komunikatu możemy wysłać ją ponownie, co spowoduje wysłanie kopii wiadomości do tej samej jednostki, umożliwiając nam zaktualizowanie jej zawartości i właściwości. Oryginał pozostanie i nie zostanie usunięty nawet wtedy, gdy ponowna baza danych pochodzi z kolejki deadletter.

  1. W siatce wybierz komunikaty, które chcemy ponownie wysłać.

  2. Wybierz przycisk Wyślij ponownie wybrane komunikaty.

    Zrzut ekranu wskazujący przycisk Wyślij ponownie wybrane komunikaty.

  3. Opcjonalnie wybierz dowolny komunikat, dla którego chcemy zaktualizować jego szczegóły, i wprowadź żądane zmiany.

  4. Wybierz przycisk Wyślij, aby wysłać komunikaty do jednostki.

    Zrzut ekranu przedstawiający środowisko ponownego wysyłanie komunikatów.

    Uwaga

    • Operacja ponownego wysyłania wysyła kopię oryginalnej wiadomości. Nie powoduje usunięcia oryginalnej wiadomości, którą przesyłasz ponownie.
    • Jeśli ponownie wyślesz komunikat w kolejce utraconych komunikatów subskrypcji, kopia komunikatu zostanie wysłana do tematu. W związku z tym wszystkie subskrypcje otrzymają kopię komunikatu.

Przełącz typ uwierzytelniania

Podczas pracy z Eksploratorem usługi Service Bus można użyć uwierzytelniania za pomocą klucza dostępu lub identyfikatora entra firmy Microsoft.

  1. Wybierz przycisk Ustawienia.

    Zrzut ekranu przedstawiający przycisk Ustawienia w Eksploratorze usługi Service Bus.

  2. Wybierz żądaną metodę uwierzytelniania i wybierz przycisk Zapisz .

    Zrzut ekranu przedstawiający przycisk Ustawienia i stronę z różnymi typami uwierzytelniania.

Następne kroki