Sémaregisztrációs adatbázis az Azure Event Hubsban
Az Azure Event Hubs sémaregisztrációs adatbázisa egy adattárat biztosít a sémák sémaalapú eseménystreamelési forgatókönyvekben való használatához és kezeléséhez.
Sémaregisztrációs adatbázis összetevői
Az Event Hubs-névterek az eseményközpontok (vagy Kafka-témakörök) mellett sémacsoportokat is üzemeltethetnek. Sémaregisztrációs adatbázist üzemeltet, és több sémacsoportot is tartalmazhat. Annak ellenére, hogy az Azure Event Hubsban üzemeltetik, a sémaregisztrációs adatbázis univerzálisan használható az összes Azure-üzenetkezelési szolgáltatáshoz és bármely más üzenet- vagy eseményszervezőhez. Ezen sémacsoportok mindegyike külön biztonságos tárház egy sémakészlethez. A csoportok egy adott alkalmazáshoz vagy szervezeti egységhez igazíthatók.
Sémacsoportok
A sémacsoport az üzleti feltételek alapján hasonló sémák logikai csoportja. A sémacsoportok a séma több verzióját is tartalmazhatják. A sémacsoport kompatibilitás-kényszerítési beállítása segíthet biztosítani, hogy az újabb sémaverziók visszamenőlegesen kompatibilisek legyenek.
A csoportosítási mechanizmus által előírt biztonsági határ biztosítja, hogy az üzleti titkok ne szivárognak véletlenül a metaadatokon olyan helyzetekben, amikor a névtér több partner között van megosztva. Emellett lehetővé teszi az alkalmazástulajdonosok számára, hogy más, azonos névteret használó alkalmazásoktól függetlenül kezeljék a sémákat.
Sémák
A sémák határozzák meg a termelők és a fogyasztók közötti szerződést. Az Event Hubs-sémaregisztrációs adatbázisban definiált séma segít a szerződés eseményadatokon kívüli kezelésében, így eltávolítva a hasznos adatok terhelését. A sémák neve, típusa (például rekord, tömb stb.), kompatibilitási mód (nincs, előre, hátra, teljes) és szerializálási típus (egyelőre csak az Avro). A séma több verzióját is létrehozhatja, és lekérheti és használhatja a séma egy adott verzióját.
Sémaformátumok
A sémaformátumok a séma strukturálásának és definiálásának módjának meghatározására szolgálnak. Minden formátum konkrét irányelveket és szintaxist tartalmaz az eseménystreameléshez használt események szerkezetének meghatározásához.
Avro-séma
Az Avro egy népszerű adatszerializálási rendszer, amely kompakt bináris formátumot használ, és sémafejlődési képességeket biztosít.
Az Avro-sémaformátum Event Hubs-sémaregisztrációs adatbázissal való használatáról a következő témakörben olvashat bővebben:
- Sémaregisztrációs adatbázis használata a Kafkával és az Avro-val
- Sémaregisztrációs adatbázis használata az Event Hubs .NET SDK-val (AMQP) és az Avro-val.
JSON-séma (előzetes verzió)
A JSON-séma szabványosított módszer az események szerkezetének és adattípusainak meghatározására. A JSON-séma lehetővé teszi a JSON-adatformátum megbízható és megbízható használatát az eseménystreamelésben.
A JSON-sémaformátum event hubs-sémaregisztrációs adatbázissal való használatáról a következő témakörben olvashat bővebben:
Sémafejlődés
A sémáknak a gyártók és a fogyasztók üzleti követelményeivel kell fejlődnie. Az Azure Schema Registry a sémacsoport szintjén a kompatibilitási módok bevezetésével támogatja a sémafejlődést. Sémacsoport létrehozásakor megadhatja az adott sémacsoportba belefoglalt sémák kompatibilitási módját. Séma frissítésekor a módosításnak meg kell felelnie a hozzárendelt kompatibilitási módnak, majd csak a séma új verzióját hozza létre.
Feljegyzés
A sémafejlődés csak az Avro-sémaformátum esetében támogatott.
Az Azure Schema Registry for Event Hubs támogatja a következő kompatibilitási módokat.
Visszamenőleges kompatibilitás
A visszamenőleges kompatibilitási mód lehetővé teszi, hogy a fogyasztói kód a séma új verzióját használja, de képes feldolgozni a séma régi verziójával rendelkező üzeneteket. Ha visszamenőleges kompatibilitási módot használ egy sémacsoportban, az lehetővé teszi a sémákon végzett módosítások követését.
- Mezők törlése.
- Választható mezők hozzáadása.
Kompatibilitás továbbítása
A továbbítási kompatibilitás lehetővé teszi, hogy a fogyasztói kód a séma egy régi verzióját használja, de képes üzeneteket olvasni az új sémával. A továbbítási kompatibilitási mód lehetővé teszi a sémán végzett módosítások követését.
- Mezők hozzáadása
- Nem kötelező mezők törlése
Nincs kompatibilitás
A kompatibilitási None
mód használata esetén a sémaregisztrációs adatbázis nem végez kompatibilitási ellenőrzéseket a sémák frissítésekor.
Ügyfél-SDK-k
Az alábbi kódtárak egyikével Avro szerializálót is használhat, amellyel szerializálhatja és deszerializálhatja a sémaregisztrációs sémaazonosítókat és Avro-kódolt adatokat tartalmazó hasznos adatokat.
- .NET – Microsoft.Azure.Data.SchemaRegistry.ApacheAvro
- Java – azure-data-schemaregistry-avro
- Python – azure-schemaregistry-avroserializer
- JavaScript - @azure/schema-registry-avro
- Apache Kafka – Futtassa az Azure Schema Registry által támogatott, Kafka által integrált Apache Avro szerializálókat és deszerializálókat. A Java-ügyfél Apache Kafka-ügyfél szerializálója az Azure Schema Registryhez bármely Apache Kafka-forgatókönyvben és bármely Apache Kafka-alapú® üzembe helyezéssel vagy felhőszolgáltatással használható.
- Azure CLI – Ha sémát szeretne hozzáadni egy sémacsoporthoz a parancssori felület használatával, olvassa el a séma hozzáadása sémacsoporthoz parancssori felülettel című témakört.
- PowerShell – Ha sémát szeretne hozzáadni egy sémacsoporthoz a PowerShell használatával, olvassa el a Séma hozzáadása sémacsoporthoz a PowerShell használatával című témakört.
Korlátok
Az Event Hubs korlátait (például a névtérben lévő sémacsoportok számát) az Event Hubs kvótái és korlátai című témakörben tekintheti meg.
Azure szerepköralapú hozzáférés-vezérlő
A sémaregisztrációs adatbázis programozott eléréséhez kövesse az alábbi lépéseket:
- Alkalmazás regisztrálása a Microsoft Entra-azonosítóban
- Adja hozzá az alkalmazás biztonsági tagját az alábbi Azure szerepköralapú hozzáférés-vezérlési (Azure RBAC) szerepkörök egyikéhez a névtér szintjén.
Szerepkör | Leírás |
---|---|
Tulajdonos | Sémaregisztrációs csoportok és sémák olvasása, írása és törlése. |
Közreműködő | Sémaregisztrációs csoportok és sémák olvasása, írása és törlése. |
Sémaregisztrációs adatbázis olvasója | Sémaregisztrációs adatbáziscsoportok és sémák olvasása és listázása. |
Sémaregisztrációs adatbázis közreműködője | Sémaregisztrációs csoportok és sémák olvasása, írása és törlése. |
Az alkalmazások Azure Portalon való regisztrálásának létrehozásával kapcsolatos utasításokért lásd : Alkalmazás regisztrálása a Microsoft Entra-azonosítóval. Jegyezze fel az ügyfél-azonosítót (alkalmazásazonosítót), a bérlőazonosítót és a kódban használandó titkos kódot.
Következő lépések
- Ha tudni szeretné, hogyan hozhat létre sémaregisztrációs adatbázist az Azure Portal használatával, tekintse meg az Event Hubs sémaregisztrációs adatbázisának létrehozását az Azure Portal használatával.
- Tekintse meg a következő Sémaregisztrációs adatbázis Avro ügyfélkódtár-mintáit .