Lägga till ett anpassat appmål i en händelseström

Den här artikeln visar hur du lägger till en anpassad app som mål i en Microsoft Fabric-händelseström.

Förutsättningar

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

  • Få åtkomst till en Premium-arbetsyta med deltagarbehörigheter eller högre behörigheter där din eventstream finns.

Kommentar

  • Det maximala antalet källor och mål för en händelseström är 11.
  • Kvarhållning av händelsedata i en händelseström är en dag, med potential att utöka den och göra den konfigurerbar i framtiden.

Lägga till en anpassad app som mål

Om du vill dirigera händelsedata till ditt program kan du lägga till en anpassad app som ditt eventstream-mål. Följ dessa steg för att lägga till ett anpassat appmål:

  1. Välj Nytt mål i menyfliksområdet eller "+" på huvudredigerarens arbetsyta och välj sedan Anpassad app. Skärmen Anpassad appmålkonfiguration visas.

  2. Ange ett målnamn för den anpassade appen och välj Lägg till.

    Skärmbild av skärmen för anpassad appmålkonfiguration.

  3. När du har skapat det anpassade programmets mål kan du växla och visa följande information på fliken Information i den nedre rutan:

    Skärmbild som visar det anpassade appmålet.

    • Grundläggande: Visar namn, beskrivning, typ och status för din anpassade app.
    • Nycklar: Visar anslutningssträng för din anpassade app, som du kan kopiera och klistra in i ditt program.
    • Exempelkod: Visar exempelkod som du kan referera till eller kopiera för att skicka händelsedata till den här händelseströmmen eller hämta händelsedata från den här händelseströmmen.

    För varje flik (exempelkod för grundläggande / nycklar / ) kan du också växla mellan tre protokollflikar: Eventhub, **AMQP och Kafka för att få åtkomst till information om olika protokollformat:

    Anslutningssträng är en händelsehubbkompatibel anslutningssträng och du kan använda den i ditt program för att ta emot händelser från din händelseström. Anslutningssträng har flera protokollformat som du kan växla och välja på fliken Nycklar. I följande exempel visas hur anslutningssträng ser ut i händelsehubbformat:

    Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxxx

    Event Hub-formatet är standardformatet för anslutningssträng och är kompatibelt med Azure Event Hubs SDK. Du kan använda det här formatet för att ansluta till eventstream med hjälp av Event Hubs-protokollet.

    Skärmbild som visar information om anpassade appar.

    De andra två protokollformaten är AMQP och Kafka, som du kan välja genom att klicka på motsvarande flikar på fliken Nycklar.

    AMQP-formatet är kompatibelt med AMQP 1.0-protokollet, som är ett standardmeddelandeprotokoll som stöder samverkan mellan olika plattformar och språk. Du kan använda det här formatet för att ansluta till eventstream med hjälp av AMQP-protokollet.

    Kafka-formatet är kompatibelt med Apache Kafka-protokollet, som är en populär distribuerad strömningsplattform som stöder databearbetning med högt dataflöde och låg latens. Du kan använda det här formatet för att ansluta till eventstream med hjälp av Kafka-protokollet.

Du kan välja det protokollformat som passar dina programbehov och inställningar och kopiera och klistra in anslutningssträng i programmet. Du kan också referera till eller kopiera exempelkoden som vi anger på fliken Exempelkod, som visar hur du skickar eller tar emot händelser med hjälp av olika protokoll.

Hantera ett mål

Redigera/ta bort: Du kan redigera eller ta bort ett eventstream-mål antingen via navigeringsfönstret eller arbetsytan.

När du väljer Redigera öppnas redigeringsfönstret till höger i huvudredigeraren. Du kan ändra konfigurationen som du vill, inklusive logiken för händelsetransformeringen via redigeraren för händelseprocessorn.

Skärmbild som visar var du väljer alternativen för att ändra och ta bort mål på arbetsytan.

Mer information om hur du lägger till andra mål i en händelseström finns i följande artiklar:

Information om hur du lägger till ett mål i händelseströmmen finns i följande artiklar: