Delen via

Service Bus Explorer gebruiken om gegevensbewerkingen uit te voeren op Service Bus

  • Artikel

Met Azure Service Bus kunnen clienttoepassingen voor afzenders en ontvangers hun bedrijfslogica loskoppelen met behulp van vertrouwde punt-naar-punt -semantiek (wachtrij) en publiceren-abonneren (onderwerp-abonnement).

Notitie

In dit artikel wordt de functionaliteit van Azure Service Bus Explorer gemarkeerd die deel uitmaakt van Azure Portal.

De open source Service Bus Explorer van de community is een zelfstandige toepassing en verschilt van deze toepassing.

Bewerkingen die worden uitgevoerd op een Azure Service Bus-naamruimte zijn van twee soorten.

  • Beheerbewerkingen : Service Bus-naamruimte, wachtrijen, onderwerpen en abonnementen maken, bijwerken, verwijderen.
  • Gegevensbewerkingen : berichten verzenden naar en ontvangen van wachtrijen, onderwerpen en abonnementen.

Belangrijk

  • Service Bus Explorer biedt geen ondersteuning voor beheerbewerkingen en -sessies.
  • We raden u aan om Service Bus Explorer te gebruiken voor grotere berichten, omdat dit kan leiden tot time-outs, afhankelijk van de berichtgrootte, netwerklatentie tussen client en Service Bus-service, enzovoort. In plaats daarvan raden we u aan uw eigen client te gebruiken om te werken met grotere berichten, waar u uw eigen time-outwaarden kunt opgeven.

Vereisten

Als u het hulpprogramma Service Bus Explorer wilt gebruiken, moet u de volgende taken uitvoeren:

Service Bus Explorer gebruiken

Als u Service Bus Explorer wilt gebruiken, gaat u naar de Service Bus-naamruimte waarop u gegevensbewerkingen wilt uitvoeren.

  1. Als u bewerkingen wilt uitvoeren voor een wachtrij, selecteert u Wachtrijen in het navigatiemenu. Als u bewerkingen wilt uitvoeren op basis van een onderwerp (en dit zijn gerelateerde abonnementen), selecteert u Onderwerpen.

    Schermopname van navigatie aan de linkerkant, waar de entiteit kan worden geselecteerd.

  2. Nadat u Wachtrijen of onderwerpen hebt geselecteerd, selecteert u de specifieke wachtrij of het specifieke onderwerp.

    Schermopname van de pagina Wachtrijen met een specifieke wachtrij geselecteerd.

  3. Selecteer De Service Bus Explorer in het linkernavigatiemenu

    Schermopname van de wachtrijpagina waar Service Bus Explorer kan worden geselecteerd.

    Notitie

    Wanneer u een abonnement bekijkt of ontvangt, selecteert u eerst het specifieke abonnement in de vervolgkeuzelijstkiezer. Schermopname van vervolgkeuzelijst voor onderwerpabonnementen.

Een bericht bekijken

Met de functionaliteit voor een korte weergave kunt u de Service Bus Explorer gebruiken om de tien bovenste 100 berichten in een wachtrij, abonnement of wachtrij met dode letters weer te geven.

  1. Als u berichten wilt bekijken, selecteert u de weergavemodus in de vervolgkeuzelijst Service Bus Explorer.

    Schermopname van de vervolgkeuzelijst met De weergavemodus geselecteerd.

  2. Controleer de metrische gegevens om te zien of er actieve berichten of onbestelbare berichten zijn om een korte weergave te bekijken van wachtrij/abonnement of DeadLetter-subqueue.

    Schermopname van de tabbladen wachtrij en wachtrij en wachtrij in de wachtrij met metrische berichtgegevens.

  3. Selecteer de knop Korte weergave vanaf het startscherm .

    Schermopname die de knop Korte weergave vanaf het startscherm aangeeft.

  4. Zodra de weergavebewerking is voltooid, worden maximaal 100 berichten weergegeven in het raster, zoals wordt weergegeven in de volgende afbeelding. Als u de details van een bepaald bericht wilt weergeven, selecteert u het in het raster. U kunt ervoor kiezen om de hoofdtekst of de berichteigenschappen weer te geven.

    Schermopname met een overzicht van gekeken berichten en inhoud van de berichttekst die wordt weergegeven voor gekeken berichten.

    Ga naar het tabblad Berichteigenschappen in het onderste deelvenster om de metagegevens weer te geven.

    Schermopname met een overzicht van gekeken berichten en berichteigenschappen die worden weergegeven voor gekeken berichten.

    Notitie

    Omdat een korte weergave geen destructieve bewerking is, wordt het bericht niet uit de entiteit verwijderd.

    Notitie

    Om prestatieredenen wordt de berichttekst niet standaard opgehaald wanneer u berichten uit een wachtrij of abonnement bekijkt waarvoor de maximale berichtgrootte is ingesteld op meer dan 1 MB. In plaats daarvan kunt u de hoofdtekst van het bericht voor een specifiek bericht laden door te klikken op de knop Berichttekst laden. Als de hoofdtekst van het bericht meer dan 1 MB is, wordt deze afgekapt voordat deze wordt weergegeven. Schermopname met een overzicht van gekeken berichten en knop om de weergegeven berichttekst te laden.

Een bericht met geavanceerde opties bekijken

Met de korte weergave met opties kunt u de Service Bus Explorer gebruiken om de belangrijkste berichten in een wachtrij, abonnement of wachtrij met dode letters weer te geven, het aantal berichten op te geven dat u wilt bekijken en het volgnummer om de korte weergavebewerking te starten.

  1. Als u berichten met geavanceerde opties wilt bekijken, selecteert u De weergavemodus in de vervolgkeuzelijst Service Bus Explorer.

    Schermopname van de vervolgkeuzelijst met de weergavemodus geselecteerd voor een korte weergave met geavanceerde opties.

  2. Controleer de metrische gegevens om te zien of er actieve berichten of onbestelbare berichten zijn om een korte weergave te bekijken van wachtrij/abonnement of DeadLetter-subqueue.

    Schermopname van tabbladen met wachtrijen en dode letters met metrische berichtgegevens die worden weergegeven voor een korte weergave met geavanceerde opties.

  3. Selecteer de knop Korte weergave met opties . Geef het aantal berichten op dat u wilt bekijken en het volgnummer waaruit u wilt gaan kijken en selecteer de knop Korte weergave.

    Schermopname die de knop Weergeven met opties aangeeft en een pagina waar de opties kunnen worden ingesteld.

  4. Zodra de korte weergave is voltooid, worden de berichten weergegeven in het raster, zoals wordt weergegeven in de volgende afbeelding. Als u de details van een bepaald bericht wilt weergeven, selecteert u het in het raster. U kunt ervoor kiezen om de hoofdtekst of de berichteigenschappen weer te geven.

    Schermopname met een overzicht van gekeken berichten en inhoud van de berichttekst die wordt weergegeven voor een korte weergave met geavanceerde opties.

    Ga naar het tabblad Berichteigenschappen in het onderste deelvenster om de metagegevens weer te geven.

    Schermopname met een overzicht van gekeken berichten en berichteigenschappen die worden weergegeven voor een korte weergave met geavanceerde opties.

    Notitie

    Omdat een korte weergave geen destructieve bewerking is, wordt het bericht niet uit de wachtrij verwijderd.

Een bericht ontvangen

De ontvangstfunctie in Service Bus Explorer staat het ontvangen van berichten uit een wachtrij of abonnement toe.

  1. Als u berichten wilt ontvangen, selecteert u De ontvangstmodus in de vervolgkeuzelijst Service Bus Explorer.

    Schermopname van vervolgkeuzelijst met Ontvangstmodus geselecteerd.

  2. Controleer de metrische gegevens om te zien of er actieve berichten of onbestelbare berichten moeten worden ontvangen en selecteer Wachtrij/Abonnement of DeadLetter.

    Schermopname van tabbladen wachtrij- en wachtrijen in de wachtrij, met metrische berichtgegevens die worden weergegeven voor de ontvangstmodus.

  3. Selecteer de knop Berichten ontvangen en geef de ontvangstmodus, het aantal te ontvangen berichten en de maximale tijd om te wachten op een bericht en selecteer Ontvangen.

    Schermopname die de knop Ontvangen aangeeft en een pagina waar de opties kunnen worden ingesteld.

    Belangrijk

    Houd er rekening mee dat de modus ReceiveAndDelete een destructief ontvangen is, dat wil weten dat het bericht uit de wachtrij wordt verwijderd wanneer het wordt weergegeven in het hulpprogramma Service Bus Explorer.

    Als u door berichten wilt bladeren zonder ze uit de wachtrij te verwijderen, kunt u de functie Peek gebruiken of de modus PeekLock-ontvangst gebruiken.

  4. Zodra de ontvangstbewerking is voltooid, worden de berichten weergegeven in het raster, zoals weergegeven in de volgende afbeelding. Als u de details van een bepaald bericht wilt weergeven, selecteert u het in het raster.

    Schermopname met een overzicht van ontvangen berichten en berichttekstinhoud weergegeven.

    Schermopname met een overzicht van ontvangen berichten en berichteigenschappen weergegeven.

    Notitie

    Om prestatieredenen wordt bij het ontvangen van berichten uit een wachtrij of abonnement waarvoor de maximale berichtgrootte is ingesteld op meer dan 1 MB, slechts één bericht tegelijk ontvangen. Als de hoofdtekst van het bericht meer dan 1 MB is, wordt deze afgekapt voordat deze wordt weergegeven.

Nadat een bericht is ontvangen in de PeekLock-modus , zijn er verschillende acties die we hierop kunnen uitvoeren.

Notitie

We kunnen deze acties alleen uitvoeren zolang we een vergrendeling op het bericht hebben.

Een bericht voltooien

  1. Selecteer in het raster de ontvangen berichten die we willen voltooien.

  2. Selecteer de knop Voltooien .

    Schermopname die de knop Voltooien aangeeft.

    Belangrijk

    Houd er rekening mee dat het voltooien van een bericht een destructief ontvangen is, d.w. het bericht wordt verwijderd uit de wachtrij wanneer Voltooid is geselecteerd in het hulpprogramma Service Bus Explorer.

Een bericht uitstellen

  1. Selecteer in het raster de ontvangen berichten die we willen uitstellen.

  2. Selecteer de knop Uitstellen .

    Schermopname die de knop Uitstellen aangeeft.

Vergrendeling verlaten

  1. Selecteer in het raster de ontvangen berichten waarvoor we de vergrendeling willen afbreken.

  2. Selecteer de knop Afsluiten .

    Schermopname die de knop Vergrendelen afbreken aangeeft.

Nadat de vergrendeling is verlaten, is het bericht weer beschikbaar voor ontvangstbewerkingen.

Onbestelbaar

  1. Selecteer in het raster de ontvangen berichten die we als dode letter willen ontvangen.

  2. Selecteer de knop Dode letter .

    Schermopname die de knop Dode letter aangeeft.

Nadat een bericht dood is geschreven, is het beschikbaar in de subquee van de dode letter .

Berichten leegmaken

Als u berichten wilt leegmaken, selecteert u de knop Berichten opschonen van Service Bus Explorer.

Schermopname die de knop berichten opschonen aangeeft.

Zodra u 'leegmaken' invoert om te bevestigen dat de bewerking wordt uitgevoerd, worden berichten verwijderd uit de respectieve Service Bus-entiteit.

Een bericht verzenden naar een wachtrij of onderwerp

Als u een bericht naar een wachtrij of een onderwerp wilt verzenden, selecteert u de knop Berichten verzenden van Service Bus Explorer.

  1. Selecteer het inhoudstype als tekst/tekst zonder opmaak, toepassing/xml of toepassing/Json.

  2. Voeg voor de hoofdtekst van het bericht de inhoud van het bericht toe. Zorg ervoor dat deze overeenkomt met de inhoudstypeset die u eerder hebt ingesteld.

  3. Stel de brokereigenschappen in (optioneel): deze omvatten correlatie-id, bericht-id, antwoordto, label/onderwerp, TTL (Time to Live) en geplande enqueue-tijd (voor geplande berichten).

  4. Stel de aangepaste eigenschappen in (optioneel): dit kunnen gebruikerseigenschappen zijn die zijn ingesteld op basis van een woordenlijstsleutel.

  5. Schakel Verzenden herhalen in om hetzelfde bericht meerdere keren te verzenden. Als er geen bericht-id is ingesteld, wordt deze automatisch gevuld met opeenvolgende waarden.

  6. Zodra het bericht is samengesteld, selecteert u de knop Verzenden .

    Schermopname van de ervaring voor het opstellen van berichten.

  7. Wanneer de verzendbewerking is voltooid, gebeurt er een van de volgende handelingen:

    • Als u naar een wachtrij verzendt, worden de metrische gegevens van Active Messages verhoogd.
    • Als u naar een onderwerp verzendt, worden de metrische gegevens van Active Messages verhoogd op de abonnementen waarnaar het bericht is gerouteerd.

Een bericht opnieuw verzenden

Na het bekijken of ontvangen van een bericht, kunnen we het opnieuw verzenden, waardoor een kopie van het bericht naar dezelfde entiteit wordt verzonden, terwijl we de inhoud en eigenschappen van het bericht kunnen bijwerken. Het origineel blijft behouden en wordt niet verwijderd, zelfs niet wanneer het opnieuw wordt verzonden uit de wachtrij voor deadletters.

  1. Selecteer in het raster de berichten die we opnieuw willen verzenden.

  2. Selecteer de knop Geselecteerde berichten opnieuw verzenden.

    Schermopname die de knop Geselecteerde berichten opnieuw verzenden aangeeft.

  3. Selecteer desgewenst een bericht waarvoor we de details willen bijwerken en breng de gewenste wijzigingen aan.

  4. Selecteer de knop Verzenden om de berichten naar de entiteit te verzenden.

    Schermopname van de ervaring voor het opnieuw verzenden van berichten.

    Notitie

    • Met de bewerking opnieuw verzenden wordt een kopie van het oorspronkelijke bericht verzonden. Het oorspronkelijke bericht dat u opnieuw verzendt, wordt niet verwijderd.
    • Als u een bericht opnieuw verzendt in een wachtrij met dode brieven van een abonnement, wordt er een kopie van het bericht naar het onderwerp verzonden. Daarom ontvangen alle abonnementen een kopie van het bericht.

Verificatietype wisselen

Wanneer u met Service Bus Explorer werkt, is het mogelijk om toegangssleutel of Microsoft Entra ID-verificatie te gebruiken.

  1. Selecteer de knop Instellingen .

    Schermopname die de knop Instellingen in Service Bus Explorer aangeeft.

  2. Kies de gewenste verificatiemethode en selecteer de knop Opslaan .

    Schermopname van de knop Instellingen en een pagina met de verschillende verificatietypen.

Volgende stappen