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:

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.

    Screenshot of left side navigation, where entity can be selected.

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

    Screenshot of the Queues page with a specific queue selected.

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

    Screenshot of queue page where Service Bus Explorer can be selected.

    Uwaga

    Podczas podglądu lub odbierania z subskrypcji najpierw wybierz określoną subskrypcję z selektora listy rozwijanej. Screenshot of dropdown for topic subscriptions.

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.

    Screenshot of dropdown with Peek Mode selected.

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

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed.

  3. Wybierz przycisk Zobacz od początku.

    Screenshot indicating the Peek from start button.

  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.

    Screenshot with overview of peeked messages and message body content shown for peeked messages.

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

    Screenshot with overview of peeked messages and message properties shown for peeked messages.

    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. Screenshot with overview of peeked messages and button to load message body shown.

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.

    Screenshot of dropdown with Peek Mode selected for peek with advanced options.

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

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed for peek with advanced options.

  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 .

    Screenshot indicating the Peek with options button, and a page where the options can be set.

  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.

    Screenshot with overview of peeked messages and message body content shown for peek with advanced options.

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

    Screenshot with overview of peeked messages and message properties shown for peek with advanced options.

    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.

    Screenshot of dropdown with Receive Mode selected.

  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.

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed for receive mode.

  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.

    Screenshot indicating the Receive button, and a page where the options can be set.

    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.

    Screenshot with overview of received messages and message body content shown.

    Screenshot with overview of received messages and message properties shown.

    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.

    Screenshot indicating the Complete button.

    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.

    Screenshot indicating the Defer button.

Porzucanie blokady

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

  2. Wybierz przycisk Porzuć blokadę.

    Screenshot indicating the Abandon Lock button.

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.

    Screenshot indicating the Dead-letter button.

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

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 .

    Screenshot showing the compose message experience.

  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.

    Screenshot indicating the Resend selected messages button.

  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.

    Screenshot showing the resend messages experience.

    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.

    Screenshot indicating the Settings button in Service Bus Explorer.

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

    Screenshot indicating the Settings button and a page showing the different authentication types.

Następne kroki