Registr schématu ve službě Azure Event Hubs

  • Článek

Registr schémat ve službě Azure Event Hubs poskytuje úložiště pro použití a správu schémat ve scénářích streamování událostí řízených schématy.

Součásti registru schématu

Obor názvů služby Event Hubs může hostovat skupiny schémat vedle center událostí (nebo témat Kafka). Hostuje registr schématu a může mít více skupin schémat. Navzdory hostování ve službě Azure Event Hubs je možné registr schématu používat universálně se všemi službami zasílání zpráv Azure a všemi dalšími zprostředkovateli zpráv nebo událostí. Každá z těchto skupin schémat je samostatné zabezpečitelné úložiště pro sadu schémat. Skupiny můžou být v souladu s konkrétní aplikací nebo organizační jednotkou.

Diagram that shows the components of Schema Registry in Azure Event Hubs.

Skupiny schémat

Skupina schémat je logická skupina podobných schémat na základě vašich obchodních kritérií. Skupina schématu může obsahovat více verzí schématu. Nastavení vynucení kompatibility ve skupině schématu může pomoct zajistit, aby novější verze schématu byly zpětně kompatibilní.

Hranice zabezpečení uložená mechanismem seskupení pomáhá zajistit, aby obchodní tajné kódy neúmyslně nepronikly metadaty v situacích, kdy se obor názvů sdílí mezi více partnery. Umožňuje také vlastníkům aplikací spravovat schémata nezávislá na jiných aplikacích, které sdílejí stejný obor názvů.

Schémata

Schémata definují kontrakt mezi producenty a spotřebiteli. Schéma definované v registru schématu služby Event Hubs pomáhá spravovat kontrakt mimo data událostí, čímž se odeberou režijní náklady na datovou část. Schéma má název, typ (například záznam, pole atd.), režim kompatibility (none, forward, backward, full) a typ serializace (prozatím pouze Avro). Můžete vytvořit více verzí schématu a načíst a použít konkrétní verzi schématu.

Formáty schématu

Formáty schématu se používají k určení způsobu, jakým je schéma strukturované a definované, přičemž každý formát obsahuje specifické pokyny a syntaxi pro definování struktury událostí, které se použijí pro streamování událostí.

Schéma Avro

Avro je oblíbený systém serializace dat, který používá kompaktní binární formát a poskytuje možnosti vývoje schématu.

Další informace o použití formátu schématu Avro s registrem schémat služby Event Hubs najdete tady:

Schéma JSON (Preview)

Schéma JSON je standardizovaný způsob definování struktury a datových typů událostí. Schéma JSON umožňuje spolehlivé a spolehlivé použití formátu dat JSON při streamování událostí.

Další informace o použití formátu schématu JSON s registrem schémat služby Event Hubs najdete tady:

Vývoj schématu

Schémata se musí vyvíjet s obchodním požadavkem výrobců a spotřebitelů. Azure Schema Registry podporuje vývoj schémat tím, že zavádí režimy kompatibility na úrovni skupiny schémat. Při vytváření skupiny schémat můžete určit režim kompatibility schémat, která do této skupiny schématu zahrnete. Při aktualizaci schématu by změna měla vyhovovat režimu kompatibility přiřazené a pak pouze vytvoří novou verzi schématu.

Poznámka:

Vývoj schématu je podporován pouze pro formát schématu Avro.

Azure Schema Registry pro službu Event Hubs podporuje následující režimy kompatibility.

Zpětná kompatibilita

Režim zpětné kompatibility umožňuje uživatelskému kódu používat novou verzi schématu, ale může zpracovávat zprávy se starou verzí schématu. Pokud ve skupině schémat používáte režim zpětné kompatibility, umožňuje provádět v schématu následující změny.

  • Odstranění polí.
  • Přidejte volitelná pole.

Přesměrová kompatibilita

Předávat kompatibilitu umožňuje uživatelskému kódu používat starou verzi schématu, ale může číst zprávy s novým schématem. Režim kompatibility vpřed umožňuje provádět následující změny ve schématu.

  • Přidat pole
  • Odstranění volitelných polí

Žádná kompatibilita

None Při použití režimu kompatibility registr schématu při aktualizaci schémat neprovádí žádné kontroly kompatibility.

Klientské sady SDK

Pomocí jedné z následujících knihoven můžete zahrnout serializátor Avro, který můžete použít k serializaci a deserializaci datových částí obsahujících identifikátory schématu schématu a data s kódováním Avro.

Limity

Omezení (například počet skupin schémat v oboru názvů) služby Event Hubs najdete v tématu Kvóty a limity služby Event Hubs.

Řízení přístupu na základě rolí Azure

Pokud chcete získat přístup k registru schématu prostřednictvím kódu programu, postupujte takto:

  1. Registrace aplikace v Microsoft Entra ID
  2. Přidejte objekt zabezpečení aplikace do jedné z následujících rolí řízení přístupu na základě role v Azure (Azure RBAC) na úrovni oboru názvů .
Role Popis
Vlastník Čtení, zápis a odstranění skupin a schémat registru schémat
Přispěvatel Čtení, zápis a odstranění skupin a schémat registru schémat
Čtenář registru schématu Přečtěte si a vypíšete skupiny a schémata registru schématu.
Přispěvatel registru schématu Čtení, zápis a odstranění skupin a schémat registru schémat

Pokyny k vytvoření registrace aplikace pomocí webu Azure Portal najdete v tématu Registrace aplikace s ID Microsoft Entra. Poznamenejte si ID klienta (ID aplikace), ID tenanta a tajný klíč, který se má v kódu použít.

Další kroky