Esercitazione: Usare gli argomenti dello spazio dei nomi per instradare i messaggi MQTT a Hub eventi di Azure (portale di Azure)

In questa esercitazione si apprenderà come usare un argomento dello spazio dei nomi per instradare i dati dai client MQTT a Hub eventi di Azure. Ecco i passaggi principali:

Prerequisiti

• Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
• Se non si ha familiarità con Griglia di eventi, leggere la panoramica di Griglia di eventi prima di iniziare questa esercitazione.
• Registrare il provider di risorse di Griglia di eventi in base ai passaggi descritti in Registrare il provider di risorse di Griglia di eventi.
• Assicurarsi che la porta 8883 sia aperta nel firewall. L'esempio di questa esercitazione usa il protocollo MQTT, che comunica tramite la porta 8883. Questa porta potrebbe essere bloccata in alcuni ambienti di rete aziendali e didattici.

Creare uno spazio dei nomi nel portale di Azure

Uno spazio dei nomi in Griglia di eventi di Azure è un contenitore logico per uno o più argomenti, client, gruppi client, spazi di argomenti e associazioni di autorizzazioni. Fornisce uno spazio dei nomi univoco, consentendo di avere più risorse nella stessa area di Azure. Con uno spazio dei nomi di Griglia di eventi di Azure è ora possibile raggruppare le risorse correlate e gestirle come singola unità nella sottoscrizione di Azure.

Seguire le sezioni successive per creare, visualizzare e gestire uno spazio dei nomi di Griglia di eventi di Azure.

Per creare uno spazio dei nomi:

1. Accedere al portale di Azure.

2. Nella casella di ricerca immettere Spazi dei nomi di Griglia di eventi e selezionare Spazi dei nomi di Griglia di eventi dai risultati.

   

3. Nella pagina Spazi dei nomi di Griglia di eventi, selezionare + Crea sulla barra degli strumenti.

   

4. Nella pagina Informazioni di base seguire questa procedura.

   1. Selezionare la sottoscrizione di Azure in cui creare lo spazio dei nomi.

   2. Selezionare un gruppo di risorse esistente o crearne uno.

   3. Immettere un nome per lo spazio dei nomi.

   4. Selezionare l'area o l'ubicazione in cui si vuole creare lo spazio dei nomi.

   5. Selezionare Rivedi e crea nella parte inferiore della pagina.

      

5. Nella scheda Rivedi e crea esaminare le impostazioni e selezionare Crea.

6. Nella pagina Distribuzione riuscita selezionare Vai alla risorsa per passare allo spazio dei nomi.

Creare un argomento dello spazio dei nomi

1. Se non ci si trova nella pagina Spazio dei nomi di Griglia di eventi, seguire la procedura Creare, visualizzare e gestire gli spazi dei nomi per visualizzare lo spazio dei nomi da usare per creare l'argomento.

2. Nella pagina Spazio dei nomi griglia di eventi selezionare l'opzione Argomenti nella sezione Gestore eventi nel menu a sinistra.

3. Nella pagina Argomenti selezionare + Argomento nella barra dei comandi.

   

4. Nella pagina Crea argomento digitare il nome dell'argomento da creare e selezionare Crea.

   

Abilitare l'identità gestita per lo spazio dei nomi di Griglia di eventi

1. Nella pagina Spazio dei nomi di Griglia di eventi, selezionare Identità in Impostazioni nel menu a sinistra.

2. Attivare l'opzione per abilitare un'identità gestita assegnata dal sistema.

3. Selezionare Salva sulla barra degli strumenti per salvare le impostazioni.

   

4. Nel messaggio di conferma selezionare Sì.

5. Verificare di visualizzare l'ID oggetto dell'identità gestita assegnata dal sistema e visualizzare un collegamento per assegnare i ruoli.

   

   Controllare le notifiche nel portale per verificare che l'identità gestita sia abilitata per lo spazio dei nomi.

Abilitare il broker MQTT per lo spazio dei nomi di Griglia di eventi

1. Nella pagina Spazio dei nomi di Griglia di eventi, selezionare Configurazione in Impostazioni nel menu a sinistra.

2. Selezionare la casella di controllo accanto a Abilita broker MQTT.

3. Selezionare Applica nella parte inferiore della pagina.

   

   Controllare le notifiche nel portale per verificare che il broker MQTT sia abilitato per lo spazio dei nomi.

In una scheda separata del Web browser o in una finestra separata usare il portale di Azure per creare uno spazio dei nomi di Hub eventi con un hub eventi.

Creare uno spazio dei nomi di Hub eventi

Uno spazio dei nomi di Hub eventi fornisce un contenitore con ambito univoco in cui creare uno o più hub eventi. Per creare uno spazio dei nomi nel gruppo di risorse usando il portale, eseguire le azioni seguenti:

1. Nel portale di Azure selezionare Tutti i servizi nel menu a sinistra e scegliere la stella (*) accanto a Hub eventi nella categoria Analytics. Verificare che Hub eventi venga aggiunto a PREFERITI nel menu di spostamento a sinistra.

   

2. Selezionare Hub eventi sotto PREFERITI nel menu di spostamento a sinistra e scegliere Crea sulla barra degli strumenti.

   

3. Nella pagina Crea spazio dei nomi seguire questa procedura:

   1. Selezionare la sottoscrizione in cui creare lo spazio dei nomi.

   2. Selezionare il gruppo di risorse creato nel passaggio precedente.

   3. Immettere un nome per lo spazio dei nomi. Verrà effettuato immediatamente un controllo sulla disponibilità del nome.

   4. Selezionare una località per lo spazio dei nomi.

   5. Selezionare Basic come piano tariffario. Se si prevede di usare lo spazio dei nomi di app Apache Kafka, usare il livello Standard. Il livello Basic non supporta i carichi di lavoro Apache Kafka. Per informazioni sulle differenze tra i livelli, vedere gli articoli Quote e limiti, Hub eventi Premiume Hub eventi Dedicato.

   6. Lasciare le unità di velocità effettiva (per il livello Standard) o unità di elaborazione (per il livello Premium) così come sono. Per altre informazioni sulle unità di velocità effettiva o di elaborazione, vedere Scalabilità di Hub eventi.

   7. Selezionare Rivedi e crea nella parte inferiore della pagina.

      

   8. Nella pagina Rivedi e crea controllare le impostazioni e selezionare Crea. Attendere il completamento della distribuzione.

4. Nella pagina Distribuzione selezionare Vai alla risorsa per passare alla pagina relativa allo spazio dei nomi.

   

5. Verificare che la pagina the Spazio dei nomi di Hub eventi sia simile all'esempio seguente:

   

Creare un hub eventi

Per creare un hub eventi all'interno dello spazio dei nomi, eseguire le azioni seguenti:

1. Nella pagina Panoramica, selezionare + Hub eventi sulla barra dei comandi.

   

2. Digitare un nome per l'hub eventi e quindi selezionare Rivedi e crea.

   

3. Nella pagina Rivedi e crea selezionare Crea.

4. È possibile controllare lo stato della creazione dell'hub eventi negli avvisi. Dopo aver creato l'hub eventi, è possibile vederlo nell'elenco corrispondente.

   

Concedere allo spazio dei nomi di Griglia di eventi l'accesso per inviare eventi all'hub eventi

1. Nella pagina Spazio dei nomi di Hub eventi, selezionare Controllo di accesso (IAM) nel menu a sinistra.

2. Nella pagina Controllo di accesso selezionare + Aggiungi nella barra dei comandi e quindi selezionare Aggiungi assegnazione di ruolo.

   

3. Nella pagina Aggiungi assegnazione di ruolo selezionare Mittente dati di Hub eventi di Azure dall'elenco dei ruoli e quindi selezionare Avanti nella parte inferiore della pagina.

   

4. Nella pagina Membri seguire questa procedura:

   1. Nel campo Assegna accesso a selezionare Identità gestita.

   2. Scegliere + Seleziona membri.

      

5. Alla pagina Selezionare identità gestite, seguire questi passaggi:

   1. Selezionare la sottoscrizione di Azure.

   2. Per Identità gestita, selezionare Spazio dei nomi di Griglia di eventi.

   3. Selezionare l'identità gestita con lo stesso nome dello spazio dei nomi di Griglia di eventi.

   4. Scegliere Seleziona nella parte inferiore della pagina.

      

6. Nella pagina Aggiungi assegnazione di ruolo, selezionare Rivedi e assegna in fondo.

7. Nella pagina Rivedi + assegna, selezionare Rivedi + assegna.

Creare una sottoscrizione di eventi con Hub eventi come endpoint

1. Passare alla scheda della finestra del Web browser con lo spazio dei nomi Griglia di eventi aperto.

2. Nella pagina Spazio dei nomi Griglia di eventi, selezionare Argomenti nel menu a sinistra.

3. Nella pagina Argomenti selezionare l'argomento dello spazio dei nomi creato in precedenza.

   

4. Nella pagina Argomento dello spazio dei nomi di Griglia di eventi selezionare + Sottoscrizione nella barra dei comandi nella parte superiore.

   

5. Nella pagina Crea sottoscrizione procedere come segue:

   1. Immettere un nome per la sottoscrizione di eventi.

   2. Per Modalità di recapito, selezionare Push.

   3. Verificare che Tipo di endpoint sia impostato su Hub eventi.

   4. Selezionare Configura un endpoint.

      

   5. In Seleziona hub eventi, seguire questa procedura:

      1. Selezionare la sottoscrizione di Azure con l'hub eventi.

      2. Selezionare il gruppo di risorse che contiene l'hub eventi.

      3. Selezionare lo spazio dei nomi di Hub eventi.

      4. Selezionare l'hub eventi nello spazio dei nomi Hub eventi.

      5. Quindi, selezionare Conferma selezione.

         

   6. Nella pagina Crea sottoscrizione. selezionare Assegnata dal sistema come Tipo di identità gestita.

   7. Selezionare Crea nella parte inferiore della pagina.

      

Configurare il routing nello spazio dei nomi di Griglia di eventi

1. Tornare alla pagina Spazio dei nomi di Griglia di eventi selezionando lo spazio dei nomi nella sezione Informazioni essenziali della pagina Argomento dello spazio dei nomi di Griglia di eventi oppure selezionando il nome dello spazio dei nomi nel menu di navigazione nella parte superiore.

2. Nella pagina Spazio dei nomi di Griglia di eventi selezionare Routing nel menu a sinistra nella sezione Broker MQTT.

3. Nella pagina Routing selezionare Abilita routing.

4. Per Tipo di argomento, selezionare argomento Spazio dei nomi.

5. Per Argomentoselezionare l'argomento dello spazio dei nomi Griglia di eventi creato in cui verranno instradati tutti i messaggi MQTT.

6. Selezionare Applica.

   

   Controllare le notifiche per verificare che lo spazio dei nomi sia abilitato con le informazioni di routing.

Creare client, spazi argomenti e associazioni di autorizzazioni

Seguire i passaggi della guida introduttiva: Pubblicare e sottoscrivere un argomento MQTT per:

1. Creare un client. Se lo si desidera, è possibile creare il secondo client.

2. Creare uno spazio di argomenti.

3. Creare associazioni di autorizzazioni per server di pubblicazione e sottoscrittore.

4. Usare MQTTX per inviare alcuni messaggi.

5. Verificare che l'hub eventi abbia ricevuto tali messaggi nella pagina Panoramica per lo spazio dei nomi di Hub eventi.

   

Visualizzare i messaggi MQTT indirizzati in Hub eventi usando una query di Analisi di flusso

Passare all'istanza di Hub eventi (hub eventi) all'interno della sottoscrizione di eventi nel portale di Azure. Elaborare i dati dall'hub eventi usando Analisi di flusso. Per altre informazioni, vedere Elaborare i dati da Hub eventi di Azure usando Analisi di flusso - Hub eventi di Azure | Microsoft Learn. È possibile visualizzare i messaggi MQTT nella query.

Passaggi successivi

Per gli esempi di codice, passare a questo repository GitHub.