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

  • Artikel

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.

    Skärmbild som visar Event Grid-namnområden i sökresultaten.

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

    Skärmbild som visar sidan Event Grid-namnområden med knappen Skapa i verktygsfältet markerat.

  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.

      Skärmbild som visar fliken Grundläggande på sidan Skapa namnområde.

  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 Eventing på den vänstra menyn.

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

    Skärmbild som visar skapande av Event Grid-namnområdesämne.

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

    Skärmbild som visar grunderna för att skapa Event Grid-namnrymdsämne.

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.

    Skärmbild av en systemtilldelad identitetssida för ett Event Grid-namnområde.

  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.

    Skärmbild som visar att tilldelningen av identitet till ett namnområde har slutförts.

    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.

    Skärmbild som visar konfigurationssidan för Event Grid-namnområdet för att aktivera MQTT.

    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.

    Skärmbild som visar valet av Event Hubs på sidan Alla tjänster.

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

    Skärmbild som visar valet av knappen Skapa på sidan Händelsehubbar.

  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.

      Skärmbild av sidan Skapa namnområde i Azure-portalen.

    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.

    Skärmbild av sidan Distributionen har slutförts med länken till resursen.

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

    Skärmbild av startsidan för Event Hubs-namnområdet i Azure-portalen.

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.

    Skärmbild av valet av knappen Lägg till händelsehubb i kommandofältet.

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

    Skärmbild av sidan Skapa händelsehubb.

  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.

    Skärmbild som visar 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.

    Skärmbild som visar sidan Åtkomstkontroll för Event Hubs-namnområdet.

  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.

    Skärmbild som visar sidan Lägg till rolltilldelning med Azure Event Hubs Data Sender vald.

  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.

      Skärmbild som visar sidan Lägg till rolltilldelning med Hanterad identitet markerad.

  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.

      Skärmbild som visar sidan Välj hanterade identiteter med Event Grid-namnområdets hanterade identitet markerad.

  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.

    Skärmbild som visar sidan Ämnen med det valda namnområdesavsnittet.

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

    Skärmbild som visar sidan Prenumerationer.

  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.

      Skärmbild som visar sidan Skapa prenumeration.

    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.

        Skärmbild som visar sidan Välj händelsehubb.

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

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

      Skärmbild som visar sidan Skapa prenumeration med knappen Skapa markerad.

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.

    Skärmbild som visar sidan Routning med det valda namnområdesavsnittet.

    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.

    Skärmbild som visar sidan Översikt för händelsehubben med inkommande meddelandeantal.

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.

Skärmbild som visar MQTT-meddelanden i Event Hubs med hjälp av Stream Analytics-frågeverktyget.

Nästa steg

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