Dela via


Lägga till Azure Event Hubs-källa i en händelseström

Den här artikeln visar hur du lägger till en Azure Event Hubs-källa i en händelseström.

Förutsättningar

Innan du börjar måste du uppfylla följande krav:

  • Åtkomst till en arbetsyta i infrastrukturkapacitetslicensläget (eller) utvärderingslicensläget med deltagare eller högre behörigheter.
  • Du måste ha rätt behörighet för att hämta åtkomstnycklarna för händelsehubben. Om din händelsehubb finns i ett skyddat nätverk, anslut till den med hjälp av en hanterad privat slutpunkt. Annars kontrollerar du att händelsehubben är offentligt tillgänglig och inte bakom en brandvägg.
  • Om du inte har en händelseström, skapa en händelseström.

Starta guiden Välj en datakälla

Om du inte har lagt till någon källa i händelseströmmen ännu väljer du Panelen Använd extern källa .

Skärmbild som visar valet av rutan Använd extern källa.

Om du lägger till källan i en redan publicerad händelseström växlar du till Redigeringsläge , väljer Lägg till källa i menyfliksområdet och väljer sedan Externa källor.

Skärmbild som visar valet av Menyn Lägg till källa till externa källor.

På sidan Välj en datakälla söker du efter och väljer AnslutAzure Event Hubs-panelen .

Skärmbild som visar valet av Azure Event Hubs som källtyp i guiden Hämta händelser.

Konfigurera Azure Event Hubs-kontakt

  1. På sidan Anslut bekräftar du att Basic har valts för funktionsnivån och väljer sedan Ny anslutning.

    Skärmbild som visar sidan Anslut länken Ny anslutning markerad.

    Om det finns en befintlig anslutning till din Azure-händelsehubb väljer du den befintliga anslutningen enligt följande bild och går sedan vidare till steget för att konfigurera dataformatet i följande steg.

    Skärmbild som visar sidan Anslut med en befintlig anslutning till en Azure-händelsehubb.

  2. Gör följande i avsnittet Anslutningsinställningar:

    1. Ange namnet på Event Hubs-namnområdet.

    2. Ange namnet på händelsehubben.

      Skärmbild som visar anslutningsinställningarna med Event Hubs-namnområdet och den angivna händelsehubben.

  3. Gör följande i avsnittet Anslutningsautentiseringsuppgifter:

    1. Som Anslutningsnamn anger du ett namn för anslutningen till händelsehubben.

    2. För Typ av autentisering kontrollerar du att nyckeln för delad åtkomst är markerad.

    3. För Namn på delad åtkomstnyckel anger du namnet på nyckeln för delad åtkomst. Anvisningar om hur du hämtar en åtkomstnyckel finns i Hämta anslutningssträng.

    4. För Delad åtkomstnyckel anger du värdet för nyckeln för delad åtkomst.

    5. Välj Anslut längst ned på sidan.

      Skärmbild som visar sidan Anslut för Azure Event Hubs-anslutningsappen.

  4. På sidan Anslut i guiden för konsumentgrupp anger du nu namnet på konsumentgruppen. Som standard $Default är valt, vilket är standardkonsumentgruppen för händelsehubben.

  5. För Dataformat väljer du ett dataformat för inkommande realtidshändelser som du vill hämta från din Azure-händelsehubb. Du kan välja mellan dataformaten JSON, Avro och CSV (med sidhuvud).

    Skärmbild som visar konsumentgruppen och dataformatet i avsnittet Stream-information.

  6. I fönstret Strömma information till höger väljer du Pennikon bredvid källnamnet och anger ett namn för källan. Steget är valfritt.

    Skärmbild som visar källnamnet i avsnittet Stream-information.

  7. Välj Nästa längst ned på sidan.

    Skärmbild som visar sidan Anslut två för Azure Event Hubs-anslutningsappen.

  8. På sidan Granska + anslut granskar du inställningarna och väljer Lägg till.

    Skärmbild som visar sidan Granska och skapa för Azure Event Hubs-anslutningsappen.

  1. På sidan Anslut för funktionsnivå väljer du Utökade funktioner (förhandsversion).

    Skärmbild som visar sidan Konfigurera anslutningsinställningar med alternativet Utökade funktioner valt.

    Om det finns en befintlig anslutning till din Azure-händelsehubb väljer du den befintliga anslutningen enligt följande bild och går sedan vidare till steget för att konfigurera dataformatet i följande steg.

  2. Gör följande i avsnittet Anslutningsinställningar:

    1. Ange namnet på Event Hubs-namnområdet.

    2. Ange namnet på händelsehubben.

      Skärmbild som visar anslutningsinställningarna med Event Hubs-namnområdet och den angivna händelsehubben.

  3. Gör följande i avsnittet Anslutningsautentiseringsuppgifter:

    1. Som Anslutningsnamn anger du ett namn för anslutningen till händelsehubben.

    2. För Typ av autentisering kontrollerar du att nyckeln för delad åtkomst är markerad.

    3. För Namn på delad åtkomstnyckel anger du namnet på nyckeln för delad åtkomst. Anvisningar om hur du hämtar en åtkomstnyckel finns i Hämta anslutningssträng.

    4. För Delad åtkomstnyckel anger du värdet för nyckeln för delad åtkomst.

    5. Välj Anslut längst ned på sidan.

      Skärmbild som visar sidan Anslut för Azure Event Hubs-anslutningsappen.

  4. På sidan Anslut i guiden för konsumentgrupp anger du nu namnet på konsumentgruppen. Som standard $Default är valt, vilket är standardkonsumentgruppen för händelsehubben.

    Skärmbild som visar konsumentgruppen i avsnittet Stream-information.

  5. (Valfritt) Om du vill anpassa källans namn väljer du Pennikon bredvid källnamnet i fönstret Strömma information till höger och anger ett namn för källan. Välj sedan Nästa längst ned på sidan.

    Skärmbild som visar källnamnet i avsnittet Strömma information med alternativet Utökade funktioner valt.

  6. På sidan Schemahantering måste du ange regler för att hantera händelser som tagits emot från den valda Eventhub så att Eventstream kan tillämpa dem korrekt. Mappningsreglerna beror på hur du modellerar händelserna.

    Om du har ett schema som styr alla händelser väljer du ett fast schema.

    Om du har flera scheman som representerar de olika inkommande händelserna kan du också definiera matchande regler för att tillämpa dina scheman. Om du vill välja det här läget väljer du Dynamiskt schema via rubrikalternativet och anger sedan reglerna med hjälp av rubrik- och värdepar för att välja varje schema. Rubriken är en anpassad Kafka-rubrikegenskap som ingår i händelsemetadata. Värdet är det förväntade värdet för den egenskapen.

    Skärmbild som visar sidan Schemahantering med alternativet Utökade funktioner valt.

  7. För båda lägena kan du välja scheman genom att klicka på listrutan Lägg till fler scheman och välja ett eller flera befintliga scheman från händelseschemaregistret. Om du inte har scheman att välja mellan kan du skapa nya scheman från den här vyn. Information om hur du definierar ett nytt händelseschema finns i Skapa och hantera händelsescheman i schemauppsättningar.

    Skärmbild som visar alternativet fast schema valt.

    Om du väljer Alternativet Välj från händelseschemaregister visas sidan Associera ett händelseschema . Välj ett eller flera scheman från registret, beroende på schemats matchningsläge, och välj sedan Välj längst ned på sidan.

    Skärmbild som visar sidan Associera ett händelseschema.

  8. Om du har valt alternativet Fast schema behöver du inte ange fler regler som matchar schemat. Du kan fortsätta till nästa steg. Om du har valt alternativet Dynamiskt schema via rubriker anger du egenskapen Kafka-rubrik och det förväntade värde som mappar till schemat. Lägg till fler scheman och ange olika rubrikegenskaper och/eller olika värden som ska mappas till dessa scheman.

    Kommentar

    När du definierar mappningsreglerna måste varje värde i rubriken vara unikt. Om du försöker återanvända ett schema visas ett varningsmeddelande som anger att du kan bryta befintliga strömmar. Så länge mappningsreglerna är desamma kan du återanvända ett schema. Om den här begränsningen påverkar din användning kontaktar du din Microsoft-representant för att dela din feedback. Vi arbetar aktivt med att ta bort den här begränsningen.

    Skärmbild som visar en egenskap och ett värde som mappats till ett schema.

  9. När scheman för alla förväntade händelser har mappats väljer du Nästa längst ned på sidan Schemahantering .

    Skärmbild som visar sidan Schemahantering.

  10. På sidan Granska + anslut granskar du inställningarna och väljer Anslut.

    Skärmbild som visar sidan Granska och skapa för Azure Event Hubs-anslutningsappen när de utökade funktionerna är aktiverade.

  11. På sidan Granska + anslut väljer du Lägg till nu.

    Skärmbild som visar sidan Granska och skapa efter att resurserna har skapats framgångsrikt.

Kommentar

En händelseström kan endast stödja upp till 11 kombinerade källor och mål när du använder följande typer:

  • Källa: Anpassad slutpunkt.
  • Mål: Anpassad slutpunkt och Eventhouse med direkt inmatning.

Alla källor eller mål som inte ingår i listan ovan och mål som inte läggs till i standardströmmen räknas inte mot den här gränsen.

Visa uppdaterad händelseström

  1. Du ser att Event Hubs-källan läggs till i händelseströmmen på arbetsytan i redigeringsläget. Välj Uppdatera i det nedre fönstret, som visar en förhandsgranskning av data i händelsehubben. Om du vill implementera den här nyligen tillagda Azure-händelsehubben väljer du Publicera i menyfliksområdet.

    Skärmbild som visar redigeraren med knappen Publicera markerad.

  2. När du har slutfört de här stegen är Azure-händelsehubben tillgänglig för visualisering i livevyn. Välj panelen Händelsehubb i diagrammet för att se sidan som liknar följande.

    Skärmbild som visar redigeraren i livevyn.

Visa uppdaterad händelseström

  1. Du ser att Event Hubs-källan läggs till i händelseströmmen på arbetsytan i redigeringsläget. Välj Uppdatera i det nedre fönstret, som visar en förhandsgranskning av data i händelsehubben. Om du vill implementera den här nyligen tillagda Azure-händelsehubben väljer du Publicera i menyfliksområdet.

    Skärmbild som visar redigeraren med knappen Publicera markerad.

  2. När du har slutfört de här stegen är Azure-händelsehubben tillgänglig för visualisering i livevyn. Välj panelen Händelsehubb i diagrammet för att se sidan som liknar följande.

    Skärmbild som visar redigeraren i livevyn.

Konfigurera eventstream-mål för att använda scheman

För närvarande stöds endast Eventhouse-mål, anpassade slutpunkter och härledda strömmar för eventstreams med aktiverade utökade funktioner (t.ex. schemastöd). Det här avsnittet visar hur du lägger till och konfigurerar ett Eventhouse-mål när utökade funktioner (till exempel schemastöd) aktiveras för händelseströmmen.

Konfigurera schema för ett anpassat slutpunktsmål

  1. Välj Transformera händelser eller lägg till mål och välj sedan Anpassad slutpunkt.

  2. I fönstret Anpassad slutpunkt anger du ett namn för målet som vanligt.

  3. För Indataschema väljer du schemat för händelser. Det här fältet är det extra fält som du fyller i när du aktiverar schemastöd för en händelseström.

    Skärmbild som visar konfigurationssidan för anpassad slutpunkt.

    Detaljerade anvisningar om hur du konfigurerar ett anpassat slutpunktsmål finns i Lägga till en anpassad slutpunkt eller ett anpassat appmål i en händelseström.

Konfigurera scheman för en evenemangshus-destination

  1. Välj Transformera händelser eller lägg till mål och välj sedan Eventhouse.
  2. På sidan Eventhouse konfigurerar du följande schemarelaterade inställningar:
    1. För Indataschema väljer du ett eller flera scheman i listrutan.

      Skärmbild som visar konfigurationssidan för Eventhouse med ett indataschema valt.

      Kommentar

      Om du valde alternativet Dynamiskt schema via rubriker när du konfigurerade en Händelsehubbkälla kan du ha konfigurerat flera scheman för källan och mappat dem till olika egenskaper och deras värden.

    2. För Metod för att skapa tabell väljer du ett av alternativen beroende på dina krav: En enskild tabell med alla kombinerade scheman eller Separata tabeller för varje schema.

      Skärmbild som visar konfigurationssidan för Eventhouse med metoder för att skapa tabeller.

    3. För Skriv data med väljer du något av följande alternativ:

      • Endast nyttolast: Skriva extraherade nyttolastdata till tabellen. Om det finns flera indatascheman skickas data till flera tabeller.

      • Metadata och nyttolast: Skriv metadata och nyttolastdata till en enda tabell. Exempelkolumner: source , subject, type, data, osv.

        Skärmbild som visar konfigurationssidan för Eventhouse med alternativen för skrivdata.

      Detaljerade anvisningar om hur du konfigurerar ett Eventhouse-mål finns i Lägga till ett Eventhouse-mål i en händelseström.

En lista över källor som stöds finns i Lägga till en händelsekälla i en händelseström