Använda Service Bus Explorer för att köra dataåtgärder på Service Bus

Artikel
11/30/2023

Med Azure Service Bus kan avsändar- och mottagarklientprogram frikoppla sin affärslogik med hjälp av välbekant punkt-till-punkt-semantik (kö) och publiceringsprenumeration (ämnesprenumeration).

Kommentar

Den här artikeln belyser funktionerna i Azure Service Bus Explorer som ingår i Azure-portalen.

Den communityägda öppen källkod Service Bus Explorer är ett fristående program och skiljer sig från det här.

Åtgärder som körs på ett Azure Service Bus-namnområde är av två typer.

Hanteringsåtgärder – Skapa, uppdatera, ta bort Service Bus-namnrymd, köer, ämnen och prenumerationer.
Dataåtgärder – Skicka till och ta emot meddelanden från köer, ämnen och prenumerationer.

Viktigt!

Service Bus Explorer stöder inte hanteringsåtgärder och sessioner.
Vi rekommenderar att du inte använder Service Bus Explorer för större meddelanden, eftersom detta kan leda till tidsgränser, beroende på meddelandestorleken, nätverksfördröjningen mellan klienten och Service Bus-tjänsten osv. I stället rekommenderar vi att du använder din egen klient för att arbeta med större meddelanden, där du kan ange egna tidsgränsvärden.

Förutsättningar

Om du vill använda Service Bus Explorer-verktyget måste du utföra följande uppgifter:

Skapa ett Azure Service Bus-namnområde.
Skapa en kö för att skicka och ta emot meddelanden från eller ett ämne med en prenumeration för att testa funktionerna. Mer information om hur du skapar köer, ämnen och prenumerationer finns i följande artiklar:
- Snabbstart – Skapa köer
- Snabbstart – Skapa ämnen
Kommentar

Om det inte är det namnområde som du skapade kontrollerar du att du är medlem i någon av dessa roller i namnområdet:

Använda Service Bus Explorer

Om du vill använda Service Bus Explorer navigerar du till Service Bus-namnområdet där du vill utföra dataåtgärder.

Om du vill köra åtgärder mot en kö väljer du Köer på navigeringsmenyn . Om du vill köra åtgärder mot ett ämne (och det är relaterade prenumerationer) väljer du Ämnen.
När du har valt Köer eller Ämnen väljer du den specifika kön eller det specifika ämnet.
Välj Service Bus Explorer på den vänstra navigeringsmenyn

Kommentar

När du tittar på eller tar emot från en prenumeration väljer du först den specifika prenumerationen i listrutans väljare.

Granska ett meddelande

Med funktionen peek kan du använda Service Bus Explorer för att visa de 100 främsta meddelandena i en kö, prenumeration eller kö med obeställbara meddelanden.

Om du vill granska meddelanden väljer du Visningsläge i listrutan Service Bus Explorer.
Kontrollera måtten för att se om det finns aktiva meddelanden eller meddelanden med obeställbara bokstäver för att granska och välj antingen Kö/prenumeration eller DeadLetter-underfråga .
Välj knappen Granska från start.
När granskningsåtgärden är klar visas upp till 100 meddelanden i rutnätet enligt följande bild. Om du vill visa information om ett visst meddelande väljer du det från rutnätet. Du kan välja att visa brödtexten eller meddelandeegenskaperna.

Växla till fliken Meddelandeegenskaper i det nedre fönstret för att se metadata.

Kommentar

Eftersom en titt inte är en destruktiv åtgärd tas meddelandet inte bort från entiteten.

Kommentar

Av prestandaskäl, när du tittar på meddelanden från en kö eller prenumeration som har den maximala meddelandestorleken inställd på över 1 MB, hämtas inte meddelandetexten som standard. I stället kan du läsa in meddelandetexten för ett visst meddelande genom att klicka på knappen Läs in meddelandetext . Om meddelandetexten är över 1 MB trunkeras den innan den visas.

Granska ett meddelande med avancerade alternativ

Med funktionen granska med alternativ kan du använda Service Bus Explorer för att visa de viktigaste meddelandena i en kö, prenumeration eller kön med obeställbara meddelanden, ange antalet meddelanden som ska granskas och sekvensnumret för att starta granskningsåtgärden.

Om du vill granska meddelanden med avancerade alternativ väljer du Granska läge i listrutan Service Bus Explorer.
Kontrollera måtten för att se om det finns aktiva meddelanden eller meddelanden med obeställbara bokstäver för att granska och välj antingen Kö/prenumeration eller DeadLetter-underfråga .
Välj knappen Granska med alternativ. Ange det antal meddelanden som ska visas och sekvensnumret som du vill börja titta från och välj knappen Granska .
När granskningsåtgärden är klar visas meddelandena i rutnätet enligt följande bild. Om du vill visa information om ett visst meddelande väljer du det från rutnätet. Du kan välja att visa brödtexten eller meddelandeegenskaperna.

Växla till fliken Meddelandeegenskaper i det nedre fönstret för att se metadata.

Kommentar

Eftersom en titt inte är en destruktiv åtgärd tas meddelandet inte bort från kön.

Ta emot ett meddelande

Funktionen ta emot i Service Bus Explorer tillåter att meddelanden tas emot från en kö eller prenumeration.

Om du vill ta emot meddelanden väljer du Ta emot läge i listrutan Service Bus Explorer.
Kontrollera måtten för att se om det finns aktiva meddelanden eller meddelanden med obeställbara meddelanden att ta emot och välj antingen Kö/Prenumeration eller DeadLetter.
Välj knappen Ta emot meddelanden och ange mottagningsläget, antalet meddelanden som ska ta emot och den maximala tiden att vänta på ett meddelande och välj Ta emot.

Viktigt!

Observera att läget ReceiveAndDelete är en destruktiv mottagning, dvs. meddelandet tas bort från kön när det visas i Service Bus Explorer-verktyget.

Om du vill bläddra bland meddelanden utan att ta bort dem från kön kan du använda funktionen Peek eller använda PeekLock-mottagningsläget.
När mottagningsåtgärden är klar visas meddelandena i rutnätet enligt följande bild. Om du vill visa information om ett visst meddelande väljer du det i rutnätet.

Kommentar

Av prestandaskäl tas endast ett meddelande emot i taget när du tar emot meddelanden från en kö eller prenumeration som har den maximala meddelandestorleken inställd på över 1 MB. Om meddelandetexten är över 1 MB trunkeras den innan den visas.

När ett meddelande har tagits emot i PeekLock-läge kan vi vidta olika åtgärder.

Kommentar

Vi kan bara vidta dessa åtgärder så länge vi har ett lås på meddelandet.

Slutför ett meddelande

I rutnätet väljer du de mottagna meddelanden som vi vill slutföra.
Välj knappen Slutför.

Viktigt!

Observera att slutförandet av ett meddelande är en destruktiv mottagning, dvs. meddelandet tas bort från kön när Slutför har valts i Service Bus Explorer-verktyget.

Skjut upp ett meddelande

I rutnätet väljer du de mottagna meddelanden som vi vill skjuta upp.
Välj knappen Skjut upp.

Överge lås

I rutnätet väljer du de mottagna meddelanden som vi vill avbryta låset för.
Välj knappen Avbryt lås .

När låset har avbrutits kommer meddelandet att vara tillgängligt för mottagningsåtgärder igen.

Obeställbara bokstäver

I rutnätet väljer du de mottagna meddelanden som vi vill ta bort.
Välj knappen Obeställbara bokstäver.

När ett meddelande har fått ett obeställt brev kommer det att vara tillgängligt från underfrågan Obeställbara bokstäver .

Skicka ett meddelande till en kö eller ett ämne

Om du vill skicka ett meddelande till en kö eller ett ämne väljer du knappen Skicka meddelanden i Service Bus Explorer.

Välj innehållstyp som antingen Text/Oformaterad, Program/XML eller Program/Json.
För Meddelandetext lägger du till meddelandeinnehållet. Kontrollera att den matchar den tidigare uppsättningen innehållstyp .
Ange egenskaperna Broker (valfritt) – dessa inkluderar korrelations-ID, meddelande-ID, ReplyTo, etikett/ämne, time to live (TTL) och schemalagd kötid (för schemalagda meddelanden).
Ange anpassade egenskaper (valfritt) – det kan vara alla användaregenskaper som anges mot en ordlistenyckel.
Kontrollera Upprepa skicka för att skicka samma meddelande flera gånger. Om inget meddelande-ID har angetts fylls det automatiskt i med sekventiella värden.
När meddelandet har skapats väljer du knappen Skicka .
När sändningsåtgärden har slutförts sker något av följande:
- Om du skickar till en kö ökar räknaren för mått för aktiva meddelanden .
- Om du skickar till ett ämne ökar räknaren för mått för aktiva meddelanden på de prenumerationer där meddelandet dirigerades till.

Skicka ett meddelande igen

När vi har tittat på eller tagit emot ett meddelande kan vi skicka det igen, vilket skickar en kopia av meddelandet till samma entitet, samtidigt som vi kan uppdatera dess innehåll och egenskaper. Originalet kommer att finnas kvar och tas inte bort även när den skickas igen från deadletter-kön.

I rutnätet väljer du de meddelanden som vi vill skicka igen.
Välj knappen Skicka markerade meddelanden igen.
Du kan också välja alla meddelanden som vi vill uppdatera informationen för och göra önskade ändringar för.
Välj knappen Skicka för att skicka meddelanden till entiteten.
Kommentar
- Åtgärden skickar en kopia av det ursprungliga meddelandet. Det tar inte bort det ursprungliga meddelandet som du skicka på nytt.
- Om du skickar ett meddelande igen i en kö med obeställbara meddelanden för en prenumeration skickas en kopia av meddelandet till ämnet. Därför får alla prenumerationer en kopia av meddelandet.