Udostępnij za pośrednictwem

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

Usługa Azure Service Bus umożliwia aplikacjom klienckim nadawcy i odbiorcy oddzielenie logiki biznesowej przy użyciu znanych semantyk punkt-punkt (Queue) i publikacja-subskrypcja (Topic-Subscription).

Uwaga

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

Eksplorator Service Bus typu open source stworzony przez społeczność jest aplikacją niezależną 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 i usuwanie przestrzeni nazw usługi Service Bus, kolejek, tematów i subskrypcji.
  • Operacje dotyczące 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.
  • Zniechęcamy do korzystania z Eksploratora usługi Service Bus w przypadku większych komunikatów, ponieważ może to spowodować przekroczenie limitu czasu, zależnie od wielkości komunikatu, opóźnień sieciowych między klientem a usługą Service Bus itd. 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.
  • Jeśli dostęp do przestrzeni nazw usługi Service Bus można uzyskać tylko za pośrednictwem prywatnego punktu końcowego, musisz uruchomić przeglądarkę internetową na hoście w sieci wirtualnej z prywatnym punktem końcowym oraz upewnić się, że na drodze nie ma żadnych bram zabezpieczeń sieciowych (NSG).
  • Jeśli użytkownik ma dostęp tylko do jednostek, a nie przestrzeni nazw, Eksplorator usługi Service Bus może nie działać zgodnie z oczekiwaniami w scenariuszach dotyczących migracji do warstwy Premium lub odzyskiwania po awarii metadanych.

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 wykonywać operacje na kolejce, wybierz pozycję Kolejki z menu nawigacji. Jeśli chcesz uruchamiać operacje względem tematu (i powiązanych z nimi subskrypcji), wybierz pozycję Tematy.

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

  2. Po wybraniu 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 menu rozwijanego. Zrzut ekranu listy rozwijanej subskrypcji tematów.

    Uwaga

    Po przejściu do Eksploratora usługi Service Bus dla jednostki w przestrzeni nazw, która ma wyłączony dostęp publiczny, zostanie wyświetlony następujący komunikat, mimo że uzyskujesz do niego dostęp z maszyny wirtualnej, która znajduje się w tej samej sieci wirtualnej co prywatny punkt końcowy. Możesz go zignorować.

    "Przestrzeń nazw ma wyłączony dostęp do sieci publicznej. Operacje na danych, takie jak Podgląd, Wysyłanie lub Odbieranie względem tego elementu Service Bus, nie działają, dopóki nie przełączysz się na wszystkie sieci lub nie zlistujesz adresu IP klienta w wybranych sieciach.

Rzut oka na wiadomość

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 odrzuconych wiadomości.

  1. Aby zajrzeć do komunikatów, wybierz pozycję Tryb Podglądu na liście rozwijanej Eksplorator Service Bus.

    Zrzut ekranu przedstawiający menu rozwijane z wybranym trybem podglądu.

  2. Sprawdź metryki, aby zobaczyć, czy istnieją aktywne komunikaty lub komunikaty w kolejce martwej wiadomości do podglądu i wybierz Kolejka/Subskrypcja lub podkolejkę DeadLetter.

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

  3. Wybierz przycisk Zobacz od początku.

    Zrzut ekranu wskazujący przycisk Podgląd od początku.

  4. Po zakończeniu operacji podglądu zostanie wyświetlonych na siatce maksymalnie 100 komunikatów, jak pokazanych 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 podglądanych wiadomości oraz zawartość ich treści.

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

    Zrzut ekranu z podglądem podejrzanych komunikatów i właściwości komunikatów widocznych dla podejrzanych komunikatów.

    Uwaga

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

    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 jest domyślnie pobierana. Zamiast tego możesz załadować treść komunikatu dla określonej wiadomości, klikając przycisk Załaduj treść komunikatu. Jeśli treść komunikatu wynosi ponad 1 MB, nie jest obcinana 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

Funkcjonalność podglądu z opcjami umożliwia użycie Eksploratora usługi Service Bus do przeglądania najważniejszych komunikatów w kolejce, subskrypcji lub kolejce martwych listów, określając liczbę komunikatów do podglądu oraz numer sekwencyjny, od którego rozpocznie się operacja podglądu.

  1. Aby zajrzeć do komunikatów z opcjami zaawansowanymi, wybierz Tryb podglądu w Eksploratorze usługi Service Bus na liście rozwijanej.

    Zrzut ekranu przedstawiający listę rozwijaną z wybranym Trybem podglądu i opcjami zaawansowanymi.

  2. Sprawdź metryki, aby zobaczyć, czy istnieją aktywne komunikaty lub komunikaty w kolejce martwej wiadomości do podglądu i wybierz Kolejka/Subskrypcja lub podkolejkę DeadLetter.

    Zrzut ekranu przedstawiający zakładki kolejki i kolejki listy martwych z wyświetlonymi metrykami komunikatów do podglądu z zaawansowanymi opcjami.

  3. Wybierz przycisk Podgląd z opcjami. Podaj liczbę komunikatów do podejrzenia oraz numer sekwencji, od którego chcesz rozpocząć podglądanie, a następnie wybierz przycisk Podejrzyj.

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

  4. Gdy tylko operacja podglądu zostanie zakończona, komunikaty są wyświetlane na 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 odbierania 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 zobaczyć, czy istnieją aktywne komunikaty lub wiadomości w kolejce dead-letter do odebrania, i wybierz pozycję kolejka/subskrypcja lub DeadLetter.

    Zrzut ekranu przedstawiający karty kolejki i podkolejki nieobsłużonych wiadomości z metrykami wiadomości 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

    Tryb ReceiveAndDelete jest destrukcyjnym odbieraniem, czyli komunikat jest usuwany z kolejki po wyświetleniu go 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, tylko jeden komunikat jest odbierany jednocześnie. Jeśli treść komunikatu wynosi ponad 1 MB, zostanie obcięta przed wyświetleniem.

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

Uwaga

Te akcje można wykonać tylko tak długo, jak masz blokadę komunikatu.

Ukończ komunikat

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

  2. Wybierz przycisk Zakończ.

    Zrzut ekranu wskazujący przycisk Zakończ.

    Ważne

    Kończenie komunikatu jest destrukcyjnym odbieraniem, czyli komunikat jest usuwany z kolejki po wybraniu opcji Complete (Ukończono) w narzędziu Service Bus Explorer.

Odroczyć wiadomość

  1. W siatce wybierz co najmniej jeden odebrany komunikat, który chcesz odroczyć.

  2. Wybierz przycisk 'Odłóż'.

    Zrzut ekranu wskazujący przycisk Odłóż.

Porzucanie blokady

  1. W siatce wybierz jedną lub więcej odebranych wiadomości, dla których chcesz porzucić blokadę.

  2. Wybierz przycisk Porzuć blokadę.

    Zrzut ekranu wskazujący przycisk Porzuć blokadę.

Po porzuceniu blokady komunikat jest ponownie dostępny do obsługi operacji odbierania.

Niedoręczony list

  1. W siatce wybierz jedną lub więcej odebranych wiadomości, które chcesz przekazać do kolejki wiadomości nieudanych.

  2. Wybierz przycisk Dead-letter.

    Zrzut ekranu pokazujący przycisk do nieodebranych wiadomości.

Po tym, jak wiadomość trafi do podkolejki błędów, jest dostępna z podkolejki błędów.

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 wpisaniu 'purge' w celu potwierdzenia operacji, komunikaty zostaną usunięte 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 Content Type, aby ustawić na 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). Te właściwości obejmują identyfikator korelacji, identyfikator wiadomości, ReplyTo, etykietę/temat wiadomości, czas życia (TTL) i zaplanowany czas umieszczenia w kolejce (dla zaplanowanych komunikatów).

  4. Ustaw właściwości niestandardowe (opcjonalnie). Te właściwości mogą być dowolnymi właściwościami użytkownika ustawionymi 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. Gdy wiadomość jest gotowa, wybierz przycisk Wyślij.

    Zrzut ekranu przedstawiający redagowanie wiadomości.

  7. Po pomyślnym zakończeniu operacji wysyłania następuje jedna z następujących zmian:

    • W przypadku wysyłania do kolejki licznik metryk Aktywne komunikaty jest zwiększany.
    • W przypadku wysyłania do tematu licznik metryk Aktywnych komunikatów jest zwiększany w subskrypcjach, do których komunikat został dostarczony.

Wyślij ponownie wiadomość

Po wyświetleniu lub odebraniu komunikatu możesz wysłać ją ponownie, wysyłając kopię wiadomości do tej samej jednostki, umożliwiając nam zaktualizowanie jej zawartości i właściwości. Oryginał pozostaje i nie jest usuwany, nawet gdy ponownie wysłane dane pochodzą z kolejki wiadomości błędnych.

  1. W siatce wybierz jedną lub więcej wiadomości, które chcesz 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 chcesz zaktualizować jego szczegóły i wprowadź żądane zmiany.

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

    Zrzut ekranu przedstawiający proces ponownego wysyłania wiadomości.

    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 martwych listów subskrypcji, kopia komunikatu zostanie wysłana do tematu. W związku z tym wszystkie subskrypcje otrzymują 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 Microsoft Entra.

  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