Dela via

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

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.

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 börjar.
  • 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. Med ett Azure Event Grid-namnområde kan du gruppera relaterade resurser och hantera dem som en enda enhet i din Azure-prenumeration. Med ett unikt namnområde kan du ha flera resurser i samma Azure-region.

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 från resultaten.

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

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

    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 namnområdet.

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

    5. Välj Förhandsgranska + skapa.

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

  5. Granska inställningarna på fliken Granska + skapa . Välj sedan 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, under Event Broker, välj Ämnen.

  3. På sidan Ämnen väljer du + Ämne.

    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 går du till Inställningar och väljer Identitet.

  2. Om du vill aktivera en systemtilldelad hanterad identitet väljer du På.

  3. Spara inställningen genom att välja Spara.

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

  4. I bekräftelsemeddelandet väljer du Ja.

  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 Azure-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 går du till Inställningar och väljer Konfiguration.

  2. Välj Aktivera MQTT-mäklare.

  3. Välj Använd.

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

    Kontrollera meddelanden i Azure-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 Portal 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 händelsehubbar. Så här skapar du ett namnområde i resursgruppen med hjälp av portalen:

  1. I Azure-portalen går du till den utfällbara menyn och väljer Alla tjänster. På sidan Alla tjänster söker du efter och väljer Event Hubs.

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

  2. På sidan Händelsehubbar väljer du Skapa.

    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 där du vill skapa namnområdet.

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

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

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

    5. För prisnivån väljer du Grundläggande.

      Anmärkning

      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åt inställningen dataflödesenheter (för standardnivå) eller bearbetningsenheter (för premiumnivå) vara som den är. Mer information om dataflödesenheter eller bearbetningsenheter finns i Event Hubs-skalbarhet.

    7. Välj Granska + skapa.

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

    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 Portal.

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.

    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).

  2. På sidan Åtkomstkontroll väljer du + Lägg till 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 går du till listan över roller, väljer Azure Event Hubs Data Sender och väljer sedan Nästa.

    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.

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

  6. På sidan för Lägg till rolltilldelning väljer du Granska + tilldela.

  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.

  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.

    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å sidan 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.

      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 går du till MQTT-broker och väljer Ruttning.

  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 den här 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 din händelsehubb med Hjälp av Azure Stream Analytics. 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 GitHub-lagringsplatsen MqttApplicationSamples.