Självstudie: Använda namnområdesavsnitt för att dirigera MQTT-meddelanden till Azure Event Hubs (Azure-portalen)

I den här självstudien får du lära dig hur du använder ett namnområdesavsnitt för att dirigera data från MQTT-klienter till Azure Event Hubs. Här är de övergripande stegen:

Förutsättningar

• Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
• Om du inte har använt Event Grid tidigare läser du Översikt över Event Grid innan du påbörjar den här självstudien.
• Registrera Event Grid-resursprovidern enligt stegen i Registrera Event Grid-resursprovidern.
• Kontrollera att port 8883 är öppen i brandväggen. Exemplet i den här självstudien använder MQTT-protokollet, som kommunicerar via port 8883. Den här porten kan blockeras i vissa företags- och utbildningsnätverksmiljöer.

Skapa ett namnområde i Azure Portal

Ett namnområde i Azure Event Grid är en logisk container för ett eller flera ämnen, klienter, klientgrupper, ämnesutrymmen och behörighetsbindningar. Det ger ett unikt namnområde så att du kan ha flera resurser i samma Azure-region. Med ett Azure Event Grid-namnområde kan du gruppera nu relaterade resurser och hantera dem som en enda enhet i din Azure-prenumeration.

Följ nästa avsnitt för att skapa, visa och hantera ett Azure Event Grid-namnområde.

Så här skapar du ett namnområde:

1. Logga in på Azure-portalen.

2. I sökrutan anger du Event Grid-namnområden och väljer Event Grid-namnområden i resultatet.

   

3. På sidan Event Grid-namnområden väljer du + Skapa i verktygsfältet.

   

4. Följ dessa steg på sidan Grundläggande .

   1. Välj den Azure-prenumeration där du vill skapa namnområdet.

   2. Välj en befintlig resursgrupp eller skapa en resursgrupp.

   3. Ange ett namn för namnrymden.

   4. Välj den region eller plats där du vill skapa namnområdet.

   5. Välj Granska + skapa längst ned på sidan.

      

5. På fliken Granska + skapa granskar du inställningarna och väljer Skapa.

6. På sidan Distributionen lyckades väljer du Gå till resurs för att navigera till ditt namnområde.

Skapa ett namnområdesavsnitt

1. Om du inte är på sidan Event Grid-namnområde följer du stegen skapa, visa och hantera namnområden för att visa det namnområde som du vill använda för att skapa ämnet.

2. På sidan Event Grid-namnområde väljer du Alternativet Ämnen i avsnittet Händelseutjämning på den vänstra menyn.

3. På sidan Ämnen väljer du knappen + Ämne i kommandofältet.

   

4. På sidan Skapa ämne skriver du namnet på det ämne som du vill skapa och väljer Skapa.

   

Aktivera hanterad identitet för Event Grid-namnområdet

1. På sidan Event Grid-namnområde väljer du Identitet under Inställningar på den vänstra menyn.

2. Aktivera växeln för att aktivera en systemtilldelad hanterad identitet.

3. Spara inställningen genom att välja Spara i verktygsfältet.

   

4. Välj Ja i bekräftelsemeddelandet.

5. Bekräfta att du ser objekt-ID för den systemtilldelade hanterade identiteten och se en länk för att tilldela roller.

   

   Kontrollera meddelanden i portalen för att bekräfta att den hanterade identiteten är aktiverad för namnområdet.

Aktivera MQTT-asynkron meddelandekö för Event Grid-namnområdet

1. På sidan Event Grid-namnområde väljer du Konfiguration under Inställningar på den vänstra menyn.

2. Markera kryssrutan bredvid Aktivera MQTT-koordinator.

3. Välj Använd längst ned på sidan.

   

   Kontrollera meddelanden i portalen för att bekräfta att MQTT-koordinatorn är aktiverad för namnområdet.

På en separat flik i webbläsaren eller i ett separat fönster använder du Azure-portalen för att skapa ett Event Hubs-namnområde med en händelsehubb.

Skapa ett Event Hubs-namnområde

Ett Event Hubs-namnområde tillhandahåller en unik omfångscontainer där du skapar en eller flera händelsehubbar. Gör följande om du vill skapa ett namnområde i din resursgrupp med Portal:

1. I Azure-portalen väljer du Alla tjänster på den vänstra menyn och väljer stjärna (*) bredvid Event Hubs i kategorin Analys . Bekräfta att Event Hubs läggs till i FAVORITER på den vänstra navigeringsmenyn.

   

2. Välj Event Hubs under FAVORITER i den vänstra navigeringsmenyn och välj Skapa i verktygsfältet.

   

3. Gör följande på sidan Skapa namnområde:

   1. Välj den prenumeration som du vill skapa namnområdet i.

   2. Välj den resursgrupp som du skapade i föregående steg.

   3. Ange ett namn för namnrymden. Systemet kontrollerar omedelbart om namnet är tillgängligt.

   4. Välj en plats för namnområdet.

   5. Välj Basic för prisnivån. Om du planerar att använda namnområdet från Apache Kafka-appar använder du standardnivån . Den grundläggande nivån stöder inte Apache Kafka-arbetsbelastningar. Mer information om skillnader mellan nivåer finns i artiklarna Kvoter och gränser, Event Hubs Premium och Event Hubs Dedicated .

   6. Lämna inställningarna för dataflödesenheter (för standardnivå) eller bearbetningsenheter (för premiumnivå) som de är. Om du vill veta mer om dataflödesenheter eller bearbetningsenheter: Event Hubs-skalbarhet.

   7. Välj Granska + Skapa längst ned på sidan.

      

   8. På sidan Granska + skapa granskar du inställningarna och väljer Skapa. Vänta tills distributionen har slutförts.

4. På sidan Distribution väljer du Gå till resurs för att navigera till sidan för ditt namnområde.

   

5. Bekräfta att sidan Event Hubs-namnområde liknar följande exempel:

   

Skapa en händelsehubb

Gör följande om du vill skapa en händelsehubb i namnområdet:

1. På sidan Översikt väljer du + Händelsehubb i kommandofältet.

   

2. Skriv ett namn på händelsehubben och välj sedan Granska + skapa.

   

3. På sidan Granska + skapa väljer du Skapa.

4. Du kan kontrollera status för skapandet av händelsehubben i aviseringarna. När händelsehubben har skapats visas den i listan över händelsehubbar.

   

Ge Event Grid-namnområdet åtkomst till att skicka händelser till händelsehubben

1. På sidan Event Hubs-namnområde väljer du Åtkomstkontroll (IAM) på den vänstra menyn.

2. På sidan Åtkomstkontroll väljer du + Lägg till i kommandofältet och väljer sedan Lägg till rolltilldelning.

   

3. På sidan Lägg till rolltilldelning väljer du Azure Event Hubs Data Sender i listan över roller och väljer sedan Nästa längst ned på sidan.

   

4. Följ dessa steg på sidan Medlemmar :

   1. I fältet Tilldela åtkomst till väljer du Hanterad identitet.

   2. Välj + Välj medlemmar.

      

5. Följ dessa steg på sidan Välj hanterade identiteter :

   1. Välj din Azure-prenumeration.

   2. För Hanterad identitet väljer du Event Grid-namnområde.

   3. Välj den hanterade identitet som har samma namn som Event Grid-namnområdet.

   4. Välj Välj längst ned på sidan.

      

6. På sidan Lägg till rolltilldelning väljer du Granska + tilldela längst ned på sidan.

7. På sidan Granska + tilldela väljer du Granska + tilldela.

Skapa en händelseprenumeration med Event Hubs som slutpunkt

1. Växla till fliken i webbläsarfönstret där Event Grid-namnområdet är öppet.

2. På sidan Event Grid-namnområde väljer du Ämnen på den vänstra menyn.

3. På sidan Ämnen väljer du det namnområdesavsnitt som du skapade tidigare.

   

4. På sidan Event Grid-namnområdesämne väljer du + Prenumeration i kommandofältet högst upp.

   

5. Följ dessa steg på sidan Skapa prenumeration :

   1. Ange ett namn för händelseprenumerationen.

   2. För Leveransläge väljer du Push.

   3. Bekräfta att Slutpunktstypen är inställd på Händelsehubb.

   4. Välj Konfigurera en slutpunkt.

      

   5. Följ dessa steg på Välj händelsehubb:

      1. Välj den Azure-prenumeration som har händelsehubben.

      2. Välj den resursgrupp som har händelsehubben.

      3. Välj Event Hubs-namnområdet.

      4. Välj händelsehubben i Event Hubs-namnområdet.

      5. Välj sedan Bekräfta markering.

         

   6. På sidan Skapa prenumeration väljer du Systemtilldelad för hanterad identitetstyp.

   7. Välj Skapa längst ned på sidan.

      

Konfigurera routning i Event Grid-namnområdet

1. Gå tillbaka till sidan Event Grid-namnområde genom att välja namnområdet i avsnittet Essentials på sidan Event Grid-namnområdesämne eller genom att välja namnområdesnamnet i menyn breadcrumb längst upp.

2. På sidan Event Grid-namnområde väljer du Routning på den vänstra menyn i avsnittet MQTT-koordinator .

3. På sidan Routning väljer du Aktivera routning.

4. Som Ämnestyp väljer du Namnområdesämne.

5. För Ämne väljer du det Event Grid-namnområdesavsnitt som du skapade där alla MQTT-meddelanden dirigeras.

6. Välj Använd.

   

   Kontrollera meddelanden för att bekräfta att namnområdet är aktiverat med routningsinformationen.

Skapa klienter, ämnesutrymme och behörighetsbindningar

Följ stegen i snabbstarten: Publicera och prenumerera på ett MQTT-ämne för att:

1. Skapa en klient. Du kan skapa den andra klienten om du vill, men det är valfritt.

2. Skapa ett ämnesutrymme.

3. Skapa behörighetsbindningar för utgivare och prenumeranter.

4. Använd MQTTX för att skicka några meddelanden.

5. Kontrollera att händelsehubben tog emot dessa meddelanden på sidan Översikt för event hubs-namnområdet.

   

Visa dirigerade MQTT-meddelanden i Event Hubs med hjälp av en Stream Analytics-fråga

Gå till Event Hubs-instansen (händelsehubben) i din händelseprenumeration i Azure-portalen. Bearbeta data från din händelsehubb med hjälp av Stream Analytics. Mer information finns i Bearbeta data från Azure Event Hubs med Stream Analytics – Azure Event Hubs | Microsoft Learn. Du kan se MQTT-meddelandena i frågan.

Nästa steg

För kodexempel går du till den här GitHub-lagringsplatsen.