Sdílet prostřednictvím


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 ve streamech událostí Microsoft Fabric.

Poznámka:

Vylepšené funkce jsou ve výchozím nastavení povolené při vytváření eventstreamů. Pokud máte streamy událostí vytvořené pomocí standardních funkcí, budou tyto streamy událostí dál fungovat. Pořád je můžete upravovat a používat jako obvykle. Doporučujeme vytvořit nový stream událostí, který nahradí standardní streamy událostí, abyste mohli využívat další možnosti a výhody rozšířených streamů událostí.

Požadavky

  • Přístup k pracovnímu prostoru v režimu licence kapacity Fabric (nebo) zkušebním režimu licence s oprávněními Přispěvatel nebo vyšší.
  • Pokud nemáte stream událostí, vytvořte stream událostí.

Přidání vlastních dat koncového bodu jako zdroje

  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 zdrojový>vlastní koncový bod.

    Snímek obrazovky s možností použití vlastního koncového bodu

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

    Snímek obrazovky s dialogovým oknem pro přidání vlastního koncového bodu

  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.

    Snímek obrazovky znázorňující stream událostí v režimu úprav se zvýrazněným tlačítkem Publikovat

Poznámka:

Maximální počet zdrojů a cílů pro jeden stream událostí je 11.

Získání podrobností 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í.

Snímek obrazovky znázorňující stream událostí v živém zobrazení

Podokno Podrobnosti obsahuje tři karty protokolu: Centrum událostí, AMQP a Kafka. Každá karta protokolu má tři stránky: základní ověřování a ověřování pomocí klíče SAS. Tyto stránky 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.

Snímek obrazovky znázorňující základní informace v podokně Podrobností živého zobrazení streamu událostí

Stránka ověřování pomocí klíče SAS poskytuje informace o klíčích připojení a také odkaz na ukázkový 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 stránce Klíče se liší podle protokolu.

Centrum událostí

Stránka Ověřování klíče SAS na kartě Centrum událostí obsahuje informace související s připojovací řetězec centra událostí. Mezi informace patří název centra událostí, název sdíleného přístupového klíče, primární klíč, sekundární klíč, připojovací řetězec primární klíč, sekundární klíč připojovacího řetězce.

Snímek obrazovky znázorňující klíčové informace v podokně Podrobností streamu událostí

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

Snímek obrazovky znázorňující ukázkový kód v podokně Podrobností živého zobrazení streamu událostí

Rozšířený protokol řízení front zpráv (AMQP)

Formát AMQP je kompatibilní s protokolem 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.

Snímek obrazovky znázorňující klíče AMQP v podokně Podrobností živého zobrazení streamu událostí

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.

Snímek obrazovky znázorňující ukázkový kód AMQP v podokně Podrobností živého zobrazení streamu událostí

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.

Snímek obrazovky znázorňující klíče Kafka v podokně Podrobností živého zobrazení eventstreamu

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

Snímek obrazovky znázorňující ukázkový kód Kafka v podokně Podrobností živého zobrazení streamu 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 zobrazení ukázkového kódu opustit, vyberte Skrýt vzorový kód.

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

Požadavky

Než začnete, musíte získat přístup k pracovnímu prostoru s oprávněními přispěvatele nebo vyššími oprávněními, kde se nachází váš eventstream.

Poznámka:

Maximální počet zdrojů a cílů pro jeden stream událostí je 11.

Přidání vlastní aplikace jako zdroje

Pokud chcete připojit vlastní aplikaci k eventstreamu, můžete přidat vlastní zdroj aplikace. Potom odešlete data do eventstreamu z vlastní aplikace s koncovým bodem připojení vystaveným ve vlastní aplikaci.

Přidání vlastního zdroje aplikace:

  1. Na pásu karet vyberte Nový zdroj nebo znaménko plus (+) na hlavním plátně editoru a pak vyberte Vlastní aplikace.

  2. V podokně Vlastní aplikace zadejte název zdroje vlastní aplikace a pak vyberte Přidat.

    Snímek obrazovky znázorňující podokno pro konfiguraci vlastní aplikace jako zdroje

Získání podrobností o koncovém bodu v podokně Podrobnosti pro odesílání událostí

Po úspěšném vytvoření vlastní aplikace jako zdroje můžete zobrazit informace v podokně Podrobností .

Podokno Podrobnosti obsahuje tři karty protokolu: Centrum událostí, AMQP a Kafka. Každá karta protokolu má tři stránky: Základy, Klíče a Vzorový kód. Tyto stránky nabízejí podrobnosti o koncovém bodu s odpovídajícím protokolem pro připojení.

Snímek obrazovky znázorňující vlastní zdroj aplikace

Základní informace ukazují název, typ a stav vlastní aplikace.

Snímek obrazovky znázorňující základní informace pro vlastní aplikaci v podokně Podrobností streamu událostí

Klíče poskytují informace o klíčích připojení. Ukázkový kód poskytuje 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ěchto stránkách se liší podle protokolu.

Centrum událostí

Stránka Klíče na kartě Centrum událostí obsahuje informace související s připojovací řetězec centra událostí. Informace zahrnují název centra událostí, název sdíleného přístupového klíče, primární klíč a primární klíč připojovacího řetězce.

Snímek obrazovky znázorňující klíčové informace v podokně Podrobností streamu událostí

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

Stránka Vzorový kód na kartě Centrum událostí nabízí kód připravený k použití, který obsahuje požadované informace o klíčích připojení v centru událostí. Jednoduše ho zkopírujte a vložte do aplikace pro použití.

Snímek obrazovky znázorňující ukázkový kód v podokně Podrobností streamu událostí

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 informace o klíčích a vzorovém kódu pro formát protokolu Kafka.

Snímek obrazovky znázorňující klíče Kafka v podokně Podrobností streamu událostí

Stránka Vzorový kód na kartě Kafka poskytuje připravený kód, včetně potřebných klíčů připojení ve formátu Kafka. Jednoduše ho zkopírujte pro své použití.

Snímek obrazovky znázorňující ukázkový kód Kafka v podokně Podrobností v eventstreamu

AMQP

Formát AMQP je kompatibilní s protokolem 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.

Snímek obrazovky znázorňující klíče AMQP v podokně Podrobností v eventstreamu

Stránka Vzorový kód na kartě AMQP poskytuje kód připravený k použití s informacemi o klíči připojení ve formátu AMQP.

Snímek obrazovky znázorňující ukázkový kód AMQP v podokně Podrobností v eventstreamu

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 na stránce Vzorový kód , který ukazuje, jak odesílat nebo přijímat události pomocí různých protokolů.

Informace o přidání dalších zdrojů do eventstreamu najdete v následujících článcích: