Dela via

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

  • Artikel

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 Portal.

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:

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.

  1. 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.

    Skärmbild av navigering på vänster sida, där entiteten kan väljas.

  2. När du har valt Köer eller Ämnen väljer du den specifika kön eller det specifika ämnet.

    Skärmbild av sidan Köer med en specifik kö markerad.

  3. Välj Service Bus Explorer på den vänstra navigeringsmenyn

    Skärmbild av kösidan där Service Bus Explorer kan väljas.

    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. Skärmbild av listrutan för ämnesprenumerationer.

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.

  1. Om du vill granska meddelanden väljer du Visningsläge i listrutan Service Bus Explorer.

    Skärmbild av listrutan med Peek Mode markerat.

  2. 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 .

    Skärmbild av underköflikar i kö och obeställbara bokstäver med meddelandemått som visas.

  3. Välj knappen Granska från start.

    Skärmbild som anger knappen Granska från start.

  4. 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.

    Skärmbild med översikt över kikade meddelanden och innehåll i meddelandetexten som visas för kikade meddelanden.

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

    Skärmbild med översikt över kikade meddelanden och meddelandeegenskaper som visas för kikade meddelanden.

    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. Skärmbild med översikt över kikade meddelanden och knapp för att läsa in meddelandetexten som 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.

  1. Om du vill granska meddelanden med avancerade alternativ väljer du Granska läge i listrutan Service Bus Explorer.

    Skärmbild av listrutan med Peek Mode valt för titt med avancerade alternativ.

  2. 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 .

    Skärmbild av underköflikar i kö och obeställbara meddelanden med meddelandemått som visas för titt med avancerade alternativ.

  3. 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 .

    Skärmbild som anger knappen Granska med alternativ och en sida där alternativen kan anges.

  4. 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.

    Skärmbild med översikt över kikade meddelanden och innehåll i meddelandetexten som visas för en titt med avancerade alternativ.

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

    Skärmbild med översiktöverde meddelanden och meddelandeegenskaper som visas för en titt med avancerade alternativ.

    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.

  1. Om du vill ta emot meddelanden väljer du Ta emot läge i listrutan Service Bus Explorer.

    Skärmbild av listrutan med mottagningsläget valt.

  2. 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.

    Skärmbild av underköflikar i kö och obeställbara bokstäver med meddelandemått som visas för mottagningsläge.

  3. 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.

    Skärmbild som anger knappen Ta emot och en sida där alternativen kan anges.

    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.

  4. 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.

    Skärmbild med översikt över mottagna meddelanden och innehåll i meddelandetexten.

    Skärmbild med översikt över mottagna meddelanden och meddelandeegenskaper som visas.

    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

  1. I rutnätet väljer du de mottagna meddelanden som vi vill slutföra.

  2. Välj knappen Slutför.

    Skärmbild som anger 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

  1. I rutnätet väljer du de mottagna meddelanden som vi vill skjuta upp.

  2. Välj knappen Skjut upp.

    Skärmbild som anger knappen Skjut upp.

Överge lås

  1. I rutnätet väljer du de mottagna meddelanden som vi vill avbryta låset för.

  2. Välj knappen Avbryt lås .

    Skärmbild som anger 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

  1. I rutnätet väljer du de mottagna meddelanden som vi vill ta bort.

  2. Välj knappen Obeställbara bokstäver.

    Skärmbild som anger 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 .

Rensa meddelanden

Om du vill rensa meddelanden väljer du knappen Rensa meddelanden i Service Bus Explorer.

Skärmbild som anger knappen rensa meddelanden.

När du anger "rensning" för att bekräfta åtgärden rensas meddelanden från respektive Service Bus-entitet.

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.

  1. Välj innehållstyp som antingen Text/Oformaterad, Program/XML eller Program/Json.

  2. För Meddelandetext lägger du till meddelandeinnehållet. Kontrollera att den matchar den tidigare uppsättningen innehållstyp .

  3. 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).

  4. Ange anpassade egenskaper (valfritt) – det kan vara alla användaregenskaper som anges mot en ordlistenyckel.

  5. 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.

  6. När meddelandet har skapats väljer du knappen Skicka .

    Skärmbild som visar funktionen skapa meddelande.

  7. 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.

  1. I rutnätet väljer du de meddelanden som vi vill skicka igen.

  2. Välj knappen Skicka markerade meddelanden igen.

    Skärmbild som anger knappen Skicka om markerade meddelanden.

  3. Du kan också välja alla meddelanden som vi vill uppdatera informationen för och göra önskade ändringar för.

  4. Välj knappen Skicka för att skicka meddelanden till entiteten.

    Skärmbild som visar funktionen skicka meddelanden igen.

    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.

Växla autentiseringstyp

När du arbetar med Service Bus Explorer är det möjligt att använda antingen åtkomstnyckel eller Microsoft Entra-ID-autentisering .

  1. Välj knappen Inställningar.

    Skärmbild som anger knappen Inställningar i Service Bus Explorer.

  2. Välj önskad autentiseringsmetod och välj knappen Spara .

    Skärmbild som anger knappen Inställningar och en sida som visar de olika autentiseringstyperna.

Nästa steg