Condividi tramite

Usare Service Bus Explorer per eseguire operazioni sui dati nel bus di servizio

  • Articolo

Il bus di servizio di Azure consente alle applicazioni client mittente e ricevente di separare la logica di business tramite la familiare semantica point-to-point (coda) e di pubblicazione-sottoscrizione (argomento-sottoscrizione).

Nota

Questo articolo illustra le funzionalità di Azure Service Bus Explorer, che fa parte del portale di Azure.

Il Service Bus Explorer open source di proprietà della community è un'applicazione autonoma e diversa da questa.

Le operazioni eseguite su uno spazio dei nomi del bus di servizio di Azure sono di due tipi.

  • Operazioni di gestione: creare, aggiornare, eliminare lo spazio dei nomi, le code, gli argomenti e le sottoscrizioni del bus di servizio.
  • Operazioni sui dati: inviare e ricevere messaggi da code, argomenti e sottoscrizioni.

Importante

  • Service Bus Explorer non supporta le operazioni di gestione e le sessioni.
  • È consigliabile usare bus di servizio Explorer per messaggi di dimensioni maggiori, in quanto potrebbero verificarsi timeout, a seconda delle dimensioni del messaggio, della latenza di rete tra client e bus di servizio servizio e così via. È invece consigliabile usare il proprio client per lavorare con messaggi di dimensioni maggiori, in cui è possibile specificare valori di timeout personalizzati.
  • Se è possibile accedere allo spazio dei nomi bus di servizio solo tramite un endpoint privato, è necessario eseguire il Web browser in un host nella rete virtuale con l'endpoint privato e assicurarsi anche che non siano presenti gateway di sicurezza di rete (NSG) nel modo desiderato.

Prerequisiti

Per usare lo strumento Service Bus Explorer, è necessario eseguire le attività seguenti:

Usare Service Bus Explorer

Per usare Service Bus Explorer, passare allo spazio dei nomi del bus di servizio in cui si desidera effettuare le operazioni sui dati.

  1. Per eseguire operazioni su una coda, selezionare Code dal menu di spostamento. Se si desidera eseguire operazioni su un argomento e sulle relative sottoscrizioni correlate, selezionare Argomenti.

    Screenshot dello spostamento a sinistra, in cui è possibile selezionare l'entità.

  2. Dopo aver selezionato Code o Argomenti, selezionare la coda o l'argomento specifico.

    Screenshot della pagina Code con una coda specifica selezionata.

  3. Selezionare il Service Bus Explorer dal menu di spostamento a sinistra

    Screenshot della pagina della coda in cui è possibile selezionare Service Bus Explorer.

    Nota

    Quando si esegue la visualizzazione o la ricezione da una sottoscrizione, selezionare prima di tutto la Sottoscrizione specifica dal selettore a discesa. Screenshot dell'elenco a discesa per le sottoscrizioni di argomenti.

    Nota

    Quando si passa a bus di servizio Explorer per un'entità in uno spazio dei nomi con accesso pubblico disabilitato, viene visualizzato il messaggio seguente anche se si accede da una macchina virtuale che si trova nella stessa rete virtuale dell'endpoint privato. È possibile ignorarla.

    "Lo spazio dei nomi ha accesso alla rete pubblica disabilitato. Le operazioni sui dati, ad esempio Visualizza, Invia o Ricevi su questo bus di servizio non funzionano finché non si passa a tutte le reti o non si consente l'ip client nelle reti selezionate."

Visualizzare in anteprima un messaggio

Con la funzionalità di visualizzazione in anteprima, è possibile usare Service Bus Explorer per visualizzare i primi 100 messaggi in una coda, una sottoscrizione o una coda di messaggi non recapitabili.

  1. Per visualizzare in anteprima i messaggi, selezionare Modalità anteprima rapida nell'elenco a discesa di Service Bus Explorer.

    Screenshot dell'elenco a discesa con la Modalità anteprima rapida selezionata.

  2. Controllare le metriche per verificare se sono presenti Messaggi attivi o Messaggi non recapitabili da visualizzare in anteprima e selezionare Coda/sottoscrizione o la coda secondaria Messaggi non recapitabili.

    Screenshot delle schede della coda e della coda secondaria di messaggi non recapitabili con le metriche dei messaggi visualizzate.

  3. Selezionare il pulsante Anteprima rapida dall'inizio.

    Screenshot che indica il pulsante Anteprima rapida dall'inizio.

  4. Al termine dell'operazione di visualizzazione in anteprima, nella griglia vengono visualizzati fino a 100 messaggi, come illustrato nell'immagine seguente. Per visualizzare i dettagli di un determinato messaggio, selezionarlo nella griglia. È possibile scegliere di visualizzare il corpo o le proprietà del messaggio.

    Screenshot con la panoramica dei messaggi visualizzati e il contenuto del corpo del messaggio mostrato per i messaggi visualizzati.

    Passare alla scheda Proprietà messaggio nel riquadro inferiore per visualizzare i metadati.

    Screenshot con la panoramica dei messaggi visualizzati e le proprietà dei messaggi mostrati per i messaggi visualizzati.

    Nota

    Poiché la visualizzazione non è un'operazione distruttiva, il messaggio non verrà rimosso dall'entità.

    Nota

    Per motivi di prestazioni, quando si visualizzano messaggi da una coda o una sottoscrizione con dimensioni massime dei messaggi impostate su 1 MB, il corpo del messaggio non viene recuperato per impostazione predefinita. È invece possibile caricare il corpo del messaggio per un messaggio specifico facendo clic sul pulsante Carica corpo del messaggio. Se il corpo del messaggio è superiore a 1 MB, non viene troncato prima di essere visualizzato. Screenshot con la panoramica dei messaggi visualizzati e del pulsante per caricare il corpo del messaggio.

Visualizzare in anteprima un messaggio con opzioni avanzate

La funzionalità di visualizzazione in anteprima con opzioni consente di usare Service Bus Explorer per visualizzare i messaggi principali in una coda, in una sottoscrizione o nella coda di messaggi non recapitabili, specificando il numero di messaggi da visualizzare e il numero di sequenza per avviare l'operazione di visualizzazione in anteprima.

  1. Per visualizzare in anteprima i messaggi con opzioni avanzate, selezionare Modalità anteprima rapida nell'elenco a discesa di Service Bus Explorer.

    Screenshot dell'elenco a discesa con la Modalità anteprima rapida selezionata per visualizzare in anteprima con opzioni avanzate.

  2. Controllare le metriche per verificare se sono presenti Messaggi attivi o Messaggi non recapitabili da visualizzare in anteprima e selezionare Coda/sottoscrizione o la coda secondaria Messaggi non recapitabili.

    Screenshot delle schede della coda secondaria di messaggi non recapitabili con le metriche dei messaggi mostrate per visualizzare in anteprima con opzioni avanzate.

  3. Selezionare il pulsante Anteprima rapida con opzioni. Specificare il numero di messaggi da visualizzare e il numero di sequenza da cui iniziare la visualizzazione e selezionare il pulsante Anteprima rapida.

    Screenshot che indica il pulsante Anteprima rapida con opzioni e una pagina in cui è possibile impostare le opzioni.

  4. Al termine dell'operazione di visualizzazione in anteprima, i messaggi vengono visualizzati nella griglia, come illustrato nell'immagine seguente. Per visualizzare i dettagli di un determinato messaggio, selezionarlo nella griglia. È possibile scegliere di visualizzare il corpo o le proprietà del messaggio.

    Screenshot con la panoramica dei messaggi visualizzati e del contenuto del corpo del messaggio mostrato per la visualizzare in anteprima con opzioni avanzate.

    Passare alla scheda Proprietà messaggio nel riquadro inferiore per visualizzare i metadati.

    Screenshot con la panoramica dei messaggi visualizzati e le proprietà dei messaggi mostrate per la visualizzazione in anteprima con opzioni avanzate.

    Nota

    Poiché la visualizzazione non è un'operazione distruttiva, il messaggio non verrà rimosso dalla coda.

Ricevere un messaggio

La funzione di ricezione in Service Bus Explorer consente di ricevere messaggi da una coda o da una sottoscrizione.

  1. Per ricevere messaggi, selezionare Modalità di ricezione nell'elenco a discesa di Service Bus Explorer.

    Screenshot dell'elenco a discesa con la Modalità di ricezione selezionata.

  2. Controllare le metriche per verificare se sono presenti Messaggi attivi o Messaggi non recapitabili da ricevere e selezionare Coda/Sottoscrizione o Messaggi non recapitabili.

    Screenshot delle schede della coda e della coda secondaria di messaggi non recapitabili con le metriche dei messaggi visualizzate per la modalità di ricezione.

  3. Selezionare il pulsante Ricevi messaggi e specificare la modalità di ricezione, il numero di messaggi da ricevere e il tempo massimo di attesa per un messaggio e selezionare Ricevi.

    Screenshot che indica il pulsante Ricevi e una pagina in cui è possibile impostare le opzioni.

    Importante

    La modalità ReceiveAndDelete è una ricezione distruttiva, ovvero il messaggio viene rimosso dalla coda quando viene visualizzato nello strumento esplora bus di servizio.

    Per esplorare i messaggi senza rimuoverli dalla coda, è consigliabile usare la funzionalità Anteprima rapida o la modalità di ricezione PeekLock.

  4. Al termine dell'operazione di ricezione, i messaggi vengono visualizzati nella griglia, come illustrato nell'immagine seguente. Per visualizzare i dettagli di un messaggio specifico, selezionarlo nella griglia.

    Screenshot con la panoramica dei messaggi ricevuti e del contenuto del corpo del messaggio mostrati.

    Screenshot con la panoramica dei messaggi ricevuti e delle proprietà dei messaggi mostrati.

    Nota

    Per motivi di prestazioni, quando si ricevono messaggi da una coda o una sottoscrizione con dimensioni massime dei messaggi impostate su 1 MB, viene ricevuto un solo messaggio alla volta. Se il corpo del messaggio è superiore a 1 MB, viene troncato prima di essere visualizzato.

Dopo la ricezione di un messaggio in modalità PeekLock , è possibile eseguire varie azioni.

Nota

È possibile eseguire queste azioni solo se si dispone di un blocco sul messaggio.

Completare un messaggio

  1. Nella griglia selezionare i messaggi ricevuti da completare.

  2. Selezionare il pulsante Completa.

    Screenshot che indica il pulsante Completa.

    Importante

    Il completamento di un messaggio è una ricezione distruttiva, ovvero il messaggio viene rimosso dalla coda quando è stata selezionata l'opzione Completa nello strumento esplora bus di servizio.

Rinviare un messaggio

  1. Nella griglia selezionare uno o più messaggi ricevuti da rinviare.

  2. Selezionare il pulsante Rinviare.

    Screenshot che indica il pulsante Rinviare.

Abbandonare il blocco

  1. Nella griglia selezionare uno o più messaggi ricevuti per i quali si desidera abbandonare il blocco.

  2. Selezionare il pulsante Abbandona il blocco.

    Screenshot che indica il pulsante Abbandona il blocco.

Dopo l'abbandono del blocco, il messaggio è nuovamente disponibile per le operazioni di ricezione.

Non recapitabili

  1. Nella griglia selezionare uno o più messaggi ricevuti da recapitare.

  2. Selezionare il pulsante Messaggi non recapitabili.

    Screenshot che indica il pulsante Messaggi non recapitabili.

Dopo che un messaggio viene recapitato in un messaggio non recapitato, è disponibile dalla sottoquery Di tipo Messaggi non recapitabili.

Ripulire i messaggi

Per ripulire i messaggi, selezionare il pulsante Elimina messaggi di bus di servizio Explorer.

Screenshot che indica il pulsante Elimina messaggi.

Dopo aver immesso "ripulitura" per confermare l'operazione, i messaggi verranno eliminati dalla rispettiva entità del bus di servizio.

Inviare un messaggio a una coda o a un argomento

Per inviare un messaggio a una coda o a un argomento, selezionare il pulsante Invia messaggi di Service Bus Explorer.

  1. Selezionare il tipo di contenuto come testo/normale, applicazione/xml o applicazione/json.

  2. Per il corpo del messaggio, aggiungere il contenuto del messaggio. Assicurarsi che corrisponda al tipo di contenuto impostato in precedenza.

  3. Impostare le proprietà broker (facoltativo). Queste proprietà includono ID correlazione, ID messaggio, ReplyTo, Label/Subject, Time to Live (TTL) e Ora di accodamento pianificato (per i messaggi pianificati).

  4. Impostare le proprietà personalizzate (facoltativo). Queste proprietà possono essere qualsiasi proprietà utente impostata su una chiave del dizionario.

  5. Controllare Ripeti invio per inviare più volte lo stesso messaggio. Se non è stato impostato alcun ID messaggio, viene popolato automaticamente con valori sequenziali.

  6. Dopo aver composto il messaggio, selezionare il pulsante Invia .

    Screenshot che mostra l'esperienza di composizione del messaggio.

  7. Quando l'operazione di invio viene completata correttamente, si verifica una delle modifiche seguenti:

    • Se si invia a una coda, il contatore delle metriche messaggi attivi viene incrementato.
    • Se si invia a un argomento, il contatore delle metriche messaggi attivi viene incrementato nelle sottoscrizioni a cui è stato instradato il messaggio.

Inviare di nuovo un messaggio

Dopo aver visualizzato o ricevuto un messaggio, è possibile inviarlo nuovamente, che invia una copia del messaggio alla stessa entità, consentendo di aggiornare il contenuto e le proprietà. L'originale rimane e non viene eliminato anche quando il nuovo invio proviene dalla coda dei messaggi non recapitabili.

  1. Nella griglia selezionare uno o più messaggi da inviare di nuovo.

  2. Selezionare il pulsante Invia nuovamente i messaggi selezionati.

    Screenshot che indica il pulsante Invia di nuovo messaggi selezionati.

  3. Facoltativamente, selezionare qualsiasi messaggio per il quale si desidera aggiornarne i dettagli e apportare le modifiche desiderate.

  4. Selezionare il pulsanteInvia per inviare i messaggi all'entità.

    Screenshot che mostra l'esperienza di nuovo invio dei messaggi.

    Nota

    • L'operazione di nuovo invio invia una copia del messaggio originale. Non rimuove il messaggio originale che viene inviato di nuovo.
    • Se si invia di nuovo un messaggio in una coda di messaggi non recapitabili di una sottoscrizione, viene inviata una copia del messaggio all'argomento. Pertanto, tutte le sottoscrizioni ricevono una copia del messaggio.

Cambia tipo di autenticazione

Quando si usa Service Bus Explorer, è possibile usare la Chiave di accesso o l'Autenticazione di Microsoft Entra ID.

  1. Selezionare il pulsante Impostazioni.

    Screenshot che indica il pulsante Impostazioni in Service Bus Explorer.

  2. Scegliere il metodo di autenticazione desiderato e selezionare il pulsante Salva.

    Screenshot che indica il pulsante Impostazioni e una pagina che mostra i diversi tipi di autenticazione.

Passaggi successivi