Použití Service Bus Exploreru ke spouštění datových operací ve službě Service Bus

Azure Service Bus umožňuje klientským aplikacím odesílatele a příjemce oddělit obchodní logiku pomocí známé sémantiky point-to-point (fronta) a publikování (téma-odběr).

Poznámka:

Tento článek popisuje funkce Azure Service Bus Exploreru, který je součástí webu Azure Portal.

Open source Service Bus Explorer vlastněná komunitou je samostatná aplikace, která se liší od této aplikace.

Operace spuštěné v oboru názvů služby Azure Service Bus jsou dva druhy.

• Operace správy – vytvoření, aktualizace, odstranění oboru názvů služby Service Bus, front, témat a odběrů
• Operace s daty – Odesílání a příjem zpráv z front, témat a odběrů

Důležité

• Service Bus Explorer nepodporuje operace správy a relace.
• Doporučujeme použít Service Bus Explorer pro větší zprávy, protože to může vést k vypršení časových limitů v závislosti na velikosti zprávy, latenci sítě mezi klientem a službou Service Bus atd. Místo toho doporučujeme použít vlastního klienta pro práci s většími zprávami, kde můžete zadat vlastní hodnoty časového limitu.

Požadavky

Pokud chcete použít nástroj Service Bus Explorer, musíte provést následující úlohy:

• Vytvořte obor názvů služby Azure Service Bus.

• Vytvořte frontu pro odesílání a přijímání zpráv z odběru nebo tématu, abyste mohli otestovat funkčnost. Informace o vytváření front, témat a odběrů najdete v následujících článcích:

  • Rychlý start – Vytváření front
  • Rychlý start – Vytváření témat

  Poznámka:

  Ujistěte se, že jste členem jedné z těchto rolí v oboru názvů nebo entitách, u kterých chcete spouštět operace odesílání nebo přijímání (včetně operací náhledu a mazání):

  • Vlastník dat služby Service Bus; Umožňuje operace odesílání i příjmu.
  • Odesílatel dat služby Service Bus; Povoluje operace odesílání.
  • Příjemce dat služby Service Bus; Umožňuje přijímat operace.

Použití Service Bus Exploreru

Pokud chcete použít Service Bus Explorer, přejděte do oboru názvů služby Service Bus, na kterém chcete provádět datové operace.

1. Pokud chcete spouštět operace s frontou, v navigační nabídce vyberte Fronty . Pokud chcete spouštět operace s tématem (a související odběry), vyberte Témata.

   

2. Po výběru front nebo témat vyberte konkrétní frontu nebo téma.

   

3. V levé navigační nabídce vyberte Service Bus Explorer.

   

   Poznámka:

   Při náhledu nebo příjmu z předplatného nejprve vyberte konkrétní předplatné z rozevíracího seznamu.

Náhled zprávy

Pomocí funkce náhledu můžete pomocí Service Bus Exploreru zobrazit prvních 100 zpráv ve frontě, odběru nebo frontě nedoručených zpráv.

1. Pokud si chcete prohlédnout zprávy, vyberte v rozevíracím seznamu Service Bus Explorer režim náhledu.

   

2. Zkontrolujte metriky a podívejte se, jestli existují aktivní zprávy nebo nedoručené zprávy, které se mají zobrazit, a vyberte podřadnou frontu nebo odběr nebo dílčí frontu DeadLetter.

   

3. Vyberte tlačítko Náhled z nabídky Start.

   

4. Po dokončení operace náhledu se v mřížce zobrazí až 100 zpráv, jak je znázorněno na následujícím obrázku. Pokud chcete zobrazit podrobnosti konkrétní zprávy, vyberte ji v mřížce. Můžete zvolit zobrazení textu nebo vlastností zprávy.

   

   Přepněte na kartu Vlastnosti zprávy v dolním podokně a zobrazte metadata.

   

   Poznámka:

   Vzhledem k tomu, že náhled není destruktivní operací, zpráva se z entity neodebere .

   Poznámka:

   Z důvodů výkonu se při náhledu zpráv z fronty nebo odběru, které má nastavenou maximální velikost zprávy nad 1 MB, text zprávy ve výchozím nastavení nenačte. Místo toho můžete načíst text zprávy pro určitou zprávu kliknutím na tlačítko Načíst text zprávy. Pokud je text zprávy nad 1 MB, před zobrazením se zkrátí.

Náhled zprávy s rozšířenými možnostmi

Náhled s funkcemi možností umožňuje pomocí Service Bus Exploreru zobrazit hlavní zprávy ve frontě, odběru nebo frontě nedoručených zpráv, zadat počet zpráv, které se mají zobrazit, a pořadové číslo pro spuštění operace náhledu.

1. Pokud chcete zobrazit náhled zpráv s rozšířenými možnostmi, vyberte v rozevíracím seznamu Service Bus Explorer režim náhledu.

   

2. Zkontrolujte metriky a podívejte se, jestli existují aktivní zprávy nebo nedoručené zprávy, které se mají zobrazit, a vyberte podřadnou frontu nebo odběr nebo dílčí frontu DeadLetter.

   

3. Vyberte tlačítko Náhled s možnostmi. Zadejte počet zpráv, ze které chcete nahlédnout, a pořadové číslo, ze které chcete začít nahlédnout, a vyberte tlačítko Náhled .

   

4. Po dokončení operace náhledu se zprávy zobrazí v mřížce, jak je znázorněno na následujícím obrázku. Pokud chcete zobrazit podrobnosti konkrétní zprávy, vyberte ji v mřížce. Můžete zvolit zobrazení textu nebo vlastností zprávy.

   

   Přepněte na kartu Vlastnosti zprávy v dolním podokně a zobrazte metadata.

   

   Poznámka:

   Vzhledem k tomu, že náhled není destruktivní operací, zpráva se z fronty neodebere .

Přijetí zprávy

Funkce příjmu v Service Bus Exploreru umožňuje přijímat zprávy z fronty nebo odběru.

1. Pokud chcete přijímat zprávy, vyberte v rozevíracím seznamu Service Bus Explorer režim příjmu.

   

2. Zkontrolujte metriky, abyste zjistili, jestli se mají přijímat aktivní zprávy nebo nedoručené zprávy, a vyberte frontu nebo odběr nebo DeadLetter.

   

3. Vyberte tlačítko Přijmout zprávy a zadejte režim příjmu, počet přijatých zpráv a maximální dobu čekání na zprávu a vyberte Přijmout.

   

   Důležité

   Upozorňujeme, že režim ReceiveAndDelete je destruktivní příjem, tj. zpráva se odebere z fronty, když se zobrazí v nástroji Service Bus Explorer.

   Pokud chcete procházet zprávy, aniž byste je odebrali z fronty, zvažte použití funkce Náhled nebo režim příjmu PeekLock .

4. Po dokončení operace příjmu se zprávy zobrazí v mřížce, jak je znázorněno na následujícím obrázku. Pokud chcete zobrazit podrobnosti konkrétní zprávy, vyberte ji v mřížce.

   

   

   Poznámka:

   Z důvodů výkonu se při příjmu zpráv z fronty nebo odběru, u kterého je nastavená maximální velikost zprávy nad 1 MB, přijme se najednou jenom jedna zpráva. Pokud je text zprávy nad 1 MB, před zobrazením se zkrátí.

Po přijetí zprávy v režimu PeekLock existují různé akce, které s ní můžete provést.

Poznámka:

Tyto akce můžete provést jenom za předpokladu, že zprávu zamknete.

Dokončení zprávy

1. V mřížce vyberte přijaté zprávy, které chcete dokončit.

2. Vyberte tlačítko Dokončit.

   

   Důležité

   Upozorňujeme, že dokončení zprávy je destruktivní příjem, tj. zpráva se odebere z fronty, když je v nástroji Service Bus Explorer vybrána možnost Dokončeno.

Odložit zprávu

1. V mřížce vyberte jednu nebo více přijatých zpráv, které chcete odložit.

2. Vyberte tlačítko Odložit.

   

Opustit zámek

1. V mřížce vyberte jednu nebo více přijatých zpráv, pro které chcete zámek opustit.

2. Vyberte tlačítko Opustit zámek.

   

Po opuštění zámku bude zpráva opět k dispozici pro operace příjmu.

Nedoručených dopisů

1. V mřížce vyberte jednu nebo více přijatých zpráv, které chcete nedoručit.

2. Vyberte tlačítko Nedoručených dopisů.

   

Po nedoručených zprávách bude tato zpráva k dispozici v podkateře Nedoručené písmeno .

Vyprázdnění zpráv

Pokud chcete zprávy vyprázdnit, vyberte tlačítko Vyprázdnit zprávy v Průzkumníku služby Service Bus.

Po zadání "vyprázdnění" pro potvrzení operace by se zprávy vyprázdnily z příslušné entity služby Service Bus.

Odeslání zprávy do fronty nebo tématu

Pokud chcete zprávu odeslat do fronty nebo tématu, vyberte tlačítko Odeslat zprávy v Service Bus Exploreru.

1. Vyberte typ obsahu, který má být text,prostý, application/xml nebo application/json.

2. V textu zprávy přidejte obsah zprávy. Ujistěte se, že odpovídá dříve nastavenému typu obsahu.

3. Nastavte vlastnosti zprostředkovatele (volitelné). Mezi tyto vlastnosti patří ID korelace, ID zprávy, ReplyTo, Label/Subject, Time to Live (TTL) a Scheduled Enqueue Time (for Scheduled Messages).

4. Nastavte vlastní vlastnosti (volitelné). Tyto vlastnosti můžou být libovolné vlastnosti uživatele nastavené pro klíč slovníku.

5. Pokud chcete stejnou zprávu odeslat několikrát, zaškrtněte políčko Opakovat odeslání . Pokud se nenastavilo žádné ID zprávy, automaticky se vyplní sekvenčními hodnotami.

6. Jakmile se zpráva složí, vyberte tlačítko Odeslat .

   

7. Po úspěšném dokončení operace odeslání dojde k jedné z následujících změn:

   • Pokud odesíláte do fronty, zvýší se čítač metrik aktivních zpráv .
   • Pokud odesíláte do tématu, zvýší se čítač metrik aktivních zpráv u odběrů, do kterých byla zpráva směrována.

Opětovné odeslání zprávy

Po zobrazení náhledu nebo přijetí zprávy ji můžete znovu odeslat, což pošle kopii zprávy stejné entitě a zároveň nám umožní aktualizovat její obsah a vlastnosti. Původní zůstane a neodstraní se ani v případě, že se znovu odešle z fronty deadletter.

1. V mřížce vyberte jednu nebo více zpráv, které chcete znovu odeslat.

2. Vyberte tlačítko Znovu odeslat vybrané zprávy.

   

3. Volitelně vyberte libovolnou zprávu, pro kterou chcete aktualizovat podrobnosti, a proveďte požadované změny.

4. Vyberte tlačítko Odeslat a odešlete zprávy do entity.

   

   Poznámka:

   • Operace opětovného odeslání odešle kopii původní zprávy. Neodebere původní zprávu, kterou znovu odešlete.
   • Pokud zprávu odešlete znovu ve frontě nedoručených zpráv odběru, odešle se do tématu kopie zprávy. Všechna předplatná proto obdrží kopii zprávy.

Přepnout typ ověřování

Při práci s Service Bus Explorerem je možné použít buď přístupový klíč , nebo ověřování Microsoft Entra ID .

1. Vyberte tlačítko Nastavení.

   

2. Zvolte požadovanou metodu ověřování a vyberte tlačítko Uložit .

   

Další kroky

• Další informace o frontách a tématech služby Service Bus
• Další informace o vytváření front Service Bus prostřednictvím webu Azure Portal
• Další informace o vytváření témat a odběrů služby Service Bus prostřednictvím webu Azure Portal