Přidání vlastního koncového bodu nebo vlastního zdroje aplikace do eventstreamu

Pokud chcete připojit vlastní aplikaci k eventstreamu, můžete přidat vlastní koncový bod nebo vlastní aplikaci jako zdroj. Události v reálném čase pak můžete odesílat do streamu událostí z vlastní aplikace s koncovým bodem připojení vystaveným na vlastním koncovém bodu nebo vlastní aplikaci. Díky protokolu Apache Kafka, který je k dispozici jako možnost pro vlastní koncové body nebo vlastní aplikace, můžete také odesílat události v reálném čase pomocí protokolu Apache Kafka.

Tento článek ukazuje, jak přidat vlastní zdroj koncového bodu nebo vlastní zdroj aplikace do eventstreamu v Microsoft Fabric.

Požadavky

• Přístup k pracovnímu prostoru, ve kterém se nachází váš eventstream. Pracovní prostor musí být v kapacitě Fabric nebo zkušebním režimu.

• Oprávnění přispěvatele nebo vyšší k úpravě streamu událostí a přidání vlastního koncového bodu (endpointu) jako zdroje.

Oprávnění pro ověřování Microsoft Entra

Pokud chcete pro připojení aplikace použít ověřování Microsoft Entra, potřebujete oprávnění člena nebo vyšší.

Musíte se také ujistit, že vlastní koncový bod má spravovanou identitu s požadovanými oprávněními. Nakonfigurujte nastavení na portálu pro správu:

1. V pravém horním rohu klikněte na Nastavení (ikona ozubeného kola).

2. V části Zásady správného řízení a přehledy vyberte Portál pro správu.

   

3. Aktivujte následující nastavení tenanta, abyste služebnímu principálovi udělili přístup k rozhraním Fabric API pro vytváření pracovních prostorů, připojení nebo kanálů nasazení.

   1. Na stránce Nastavení klienta v části Nastavení pro vývojáře rozbalte možnost Služby principálů můžou používat Fabric API.
   2. Nastavte přepínač na Povoleno.
   3. V části Použít na vyberte celou organizaci.
   4. Vyberte a použijte.

   

4. Povolte tuto možnost pro přístup ke všem ostatním API (povoleno ve výchozím nastavení pro nové nájemce):

   1. Na stránce Nastavení tenanta rozbalte možnost Povolit instančním objektům vytvářet a používat profily .
   2. Nastavte přepínač na Povoleno.
   3. Pro možnost Použít na vyberte Celou organizaci.
   4. Vyberte a použijte.

Přidejte vlastní data koncového bodu jako zdroj

1. Pokud chcete přidat vlastní zdroj koncového bodu, na stránce Začínáme vyberte Použít vlastní koncový bod. Pokud už máte publikovaný eventstream a chcete přidat vlastní data koncového bodu jako zdroj, přepněte do režimu úprav. Na pásu karet vyberte Přidat zdroj>vlastní koncový bod.

   

2. V dialogovém okně Vlastní koncový bod zadejte název vlastního zdroje v části Název zdroje a pak vyberte Přidat.

   

3. Po vytvoření vlastního zdroje koncového bodu se přidá do eventstreamu na plátně v režimu úprav. Pokud chcete implementovat nově přidaná data z vlastního zdroje aplikace, vyberte Publikovat.

   

Poznámka:

Eventstream může podporovat až 11 kombinovaných zdrojů a cílů pouze v případě, že používáte následující typy:

• Zdroj: Vlastní koncový bod.
• Cíle: Vlastní koncový bod a eventhouse s přímým příjmem dat.

Všechny zdroje nebo cíle, které nejsou zahrnuté v předchozím seznamu a cíle nepřipojené k výchozímu datovému proudu, se do tohoto limitu nezapočítávají.

Přidejte vlastní data koncového bodu jako zdroj

1. Pokud chcete přidat vlastní zdroj koncového bodu, na stránce Začínáme vyberte Použít vlastní koncový bod. Pokud už máte publikovaný eventstream a chcete přidat vlastní data koncového bodu jako zdroj, přepněte do režimu úprav. Na pásu karet vyberte Přidat zdroj>vlastní koncový bod.

   

2. Na stránce Přidat zdroj vyberte Aktivovatpro přidružení schématu a pak vyberte Přidat.

   

3. Pokud chcete v editoru přidružit nové schéma nebo existující schéma z registru schématu, na pásu karet vyberte Přidružit schéma události .

   

4. Pokud chcete použít existující schéma, vyberte možnost Zvolit z registru schématu událostí a pak postupujte takto:

   1. V dialogovém okně Přidružit schéma události vyberte schéma z registru schématu. Schéma dat události se zobrazí v pravém podokně.

   2. Výběrem možnosti Zvolit přidružíte schéma události k vlastnímu koncovému bodu.

      

   3. V editoru pro událostní tok vyberte dlaždici eventstream. V dolním podokně přepněte na kartu Přidružené schéma . Ověřte, že je schéma přidružené k eventstreamu.

      

5. K vytvoření schématu použijte jednu z následujících možností:

   • Pokud máte soubor JSON schématu, vyberte Nahrát a nahrajte soubor. Ukázkový soubor najdete v tématu Stažení schématu událostí.

     

   • Začněte schéma vytvářet ručně výběrem možnosti Přidat řádek. Pro každý řádek vyberte typ pole, vyberte název pole a volitelně zadejte popis.

     

   • Pokud chcete vytvořit schéma zadáním kódu JSON, vyberte možnost Editor kódu . Pokud se rozhodnete použít editor kódu k vytvoření schématu, všimněte si, že nebudete moct přepnout zpět na tvůrce uživatelského rozhraní, vyberte Upravit.

     

     Do editoru zadejte kód JSON.

     

Poznámka:

Eventstream může podporovat až 11 kombinovaných zdrojů a cílů pouze v případě, že používáte následující typy:

• Zdroj: Vlastní koncový bod.
• Cíle: Vlastní koncový bod a eventhouse s přímým příjmem dat.

Všechny zdroje nebo cíle, které nejsou zahrnuté v předchozím seznamu a cíle nepřipojené k výchozímu datovému proudu, se do tohoto limitu nezapočítávají.

Získejte podrobnosti o koncovém bodu v podokně Podrobností

Po vytvoření vlastního zdroje koncového bodu jsou její data k dispozici pro vizualizaci v živém zobrazení.

Podokno Podrobnosti obsahuje tři karty protokolu: Centrum událostí, AMQP a Kafka. Každá karta protokolu má dvě stránky, které nabízejí podrobnosti o koncovém bodu s odpovídajícím protokolem pro připojení:

• Základní informace ukazují název, typ a stav vašeho vlastního koncového bodu.

  

• Ověřování pomocí klíče SAS poskytuje informace o klíčích připojení. Poskytuje také odkaz na vzorový kód s vloženými odpovídajícími klíči, které můžete použít k streamování událostí do streamu událostí. Informace na této stránce se liší podle protokolu.

Centrum událostí

Karta Ověřování klíče SAS pro protokol centra událostí obsahuje informace související s připojovacím řetězcem centra událostí. Informace zahrnují název centra událostí, název sdíleného přístupového klíče, primární klíč, sekundární klíč, primární klíč připojovacího řetězce a sekundární klíč připojovacího řetězce.

Formát centra událostí je výchozí pro připojovací řetězec a funguje se sadou Azure Event Hubs SDK. Tento formát umožňuje připojení k eventstreamu prostřednictvím protokolu Event Hubs.

Následující příklad ukazuje, jak připojovací řetězec vypadá ve formátu centra událostí:

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

Pokud vyberete tlačítko Zobrazit ukázkový kód , zobrazí se kód Java připravený k použití, který obsahuje požadované informace o klíčích připojení v centru událostí. Zkopírujte ho a vložte ho do aplikace pro použití.

AMQP

Formát AMQP (Advanced Message Queuing Protocol) je kompatibilní s AMQP 1.0, což je standardní protokol zasílání zpráv, který podporuje interoperabilitu mezi různými platformami a jazyky. Tento formát můžete použít k připojení k eventstreamu pomocí protokolu AMQP.

Když vyberete tlačítko Zobrazit ukázkový kód , zobrazí se kód Java připravený k použití s informacemi o klíči připojení ve formátu AMQP.

Kafka

Formát Kafka je kompatibilní s protokolem Apache Kafka, což je oblíbená platforma pro distribuované streamování, která podporuje zpracování dat s vysokou propustností a nízkou latencí. K připojení k eventstreamu a streamování událostí můžete použít ověřovací informace o klíči SAS pro formát protokolu Kafka.

Když vyberete tlačítko Zobrazit vzorový kód , zobrazí se kód Java připravený k použití, včetně potřebných klíčů připojení ve formátu Kafka. Zkopírujte ho pro své použití.

Pro jasný návod k používání vlastního koncového bodu s protokolem Kafka se podívejte do tohoto tutoriálu. Poskytuje podrobné kroky pro streamování a využívání událostí.

Poznámka:

• Můžete zvolit formát protokolu, který vyhovuje potřebám a předvolbám vaší aplikace, a pak zkopírujte a vložte připojovací řetězec do aplikace. Můžete také odkazovat nebo kopírovat vzorový kód, který ukazuje, jak odesílat nebo přijímat události pomocí různých protokolů.
• Pokud chcete ukázkové zobrazení kódu zavřít, vyberte Skrýt vzorový kód.

Konfigurace cílů eventstreamu pro použití schémat

V současné době jsou pro eventstreamy s povolenými rozšířenými funkcemi podporovány pouze eventhouse, vlastní koncový bod a odvozené datové proudy jako cíle. V této části se dozvíte, jak přidat a nakonfigurovat cíl pro Eventhouse, když jsou pro proud událostí povoleny rozšířené funkce, jako je podpora schématu.

Konfigurace schématu pro vlastní cílový koncový bod

1. Vyberte Převod událostí nebo přidání cíle a potom zvolte CustomEndpoint.

2. V podokně Vlastní koncový bod zadejte název cíle.

3. V části Vstupní schéma vyberte schéma událostí. Když povolíte podporu schématu pro eventstream, provedete výběr v tomto poli.

Podrobný postup konfigurace vlastního cíle koncového bodu najdete v tématu Přidání vlastního koncového bodu nebo vlastního cíle aplikace do eventstreamu.

Konfigurace schémat pro cíl centra událostí

1. Vyberte možnost Transformovat události nebo přidat cíl, poté vyberte Eventhouse.

2. V podokně Eventhouse nakonfigurujte následující nastavení související se schématem:

   1. V části Vstupní schéma vyberte jedno nebo více schémat z rozevíracího seznamu.

      

      Poznámka:

      Pokud jste při konfiguraci zdroje služby Event Hubs vybrali dynamické schéma prostřednictvím hlaviček , možná jste pro zdroj nakonfigurovali více schémat a namapovali je na různé vlastnosti a jejich hodnoty.

   2. Pro metodu vytvoření tabulky vyberte jednu tabulku se všemi schématy zkombinované nebo oddělené tabulky pro každé schéma v závislosti na vašich požadavcích.

      

   3. Pro zápis dat pomocí vyberte jednu z následujících možností:

      • Pouze datová část: Zapište do tabulky extrahovaná data datové části. Pokud existuje více vstupních schémat, data se odesílají do více tabulek.
      • Metadata a užitečná data: Zapište metadata a užitečná data do jedné tabulky. Mezi příklady sloupců patří source , subject, typea data.

      

Podrobný postup konfigurace cíle eventhouse najdete v tématu Přidání cíle eventhouse do eventstreamu.

Související obsah

• Seznam podporovaných zdrojů najdete v tématu Přidání a správa zdroje událostí v eventstreamu.