For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/data-analytics/analytics/kafka-enable-schema-registry.md.
Aller au contenu

Kafka - Comment activer le Schema Registry

Voir en Markdown

Découvrez comment activer le Schema Registry de votre service Kafka et enregistrer votre premier schéma

Objectif

Apache Kafka est une plateforme open source distribuée de streaming d'événements, conçue pour le traitement de données en temps réel et à grande échelle, avec une scalabilité et une durabilité élevées ainsi qu'une faible latence.

Le Schema Registry stocke les schémas de vos messages et permet aux producteurs et aux consommateurs de s'accorder sur leur format.

Ce guide explique comment activer le Schema Registry de votre service Kafka depuis la console OVHcloud ou l'API OVHcloud, et comment enregistrer un premier schéma.

Prérequis


Accès à la console OVHcloud

  • Lien direct :
  • Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Analytics

En pratique

Activer le Schema Registry

Console OVHcloud
API OVHcloud

Accédez à l'onglet Configuration de votre service Kafka. Dans la section Fonctionnalités Kafka, activez l'interrupteur Schema registry.

Le Schema Registry peut être désactivé avec le même interrupteur.

Récupérer le point d'accès du Schema Registry

Une fois le Schema Registry activé, un point d'accès kafkaSchemaRegistry est ajouté à votre service. Vous le trouvez dans la liste endpoints du détail du service :

{
  "component": "kafkaSchemaRegistry",
  "domain": "kafka-xxxxxxxx-xxxxxxxxx.database.cloud.ovh.net",
  "port": 20189,
  "scheme": "https",
  "ssl": true,
  "uri": "https://<username>:<password>@kafka-xxxxxxxx-xxxxxxxxx.database.cloud.ovh.net:20189"
}

Le Schema Registry utilise HTTPS avec le certificat CA de votre service, ainsi que le nom et le mot de passe d'un utilisateur Kafka.

Donner accès au Schema Registry

Un utilisateur a besoin d'une ACL Schema Registry pour lire ou enregistrer des schémas. Sans elle, chaque requête renvoie 401 Unauthorized.

Par exemple, pour permettre à l'utilisateur app-orders d'enregistrer des schémas pour le subject orders-value, créez l'ACL suivante :

{
  "username": "app-orders",
  "resource": "Subject:orders-value",
  "permission": "schema_registry_write"
}

Consultez le guide des ACL pour connaître les permissions et ressources disponibles.

Enregistrer et lister des schémas

Téléchargez le certificat CA de votre service sous le nom ca.pem (consultez le guide « Se connecter à un cluster Kafka en CLI »), puis enregistrez un schéma Avro pour le subject orders-value :

curl --cacert ca.pem -u 'app-orders:<password>' \
  -H 'Content-Type: application/vnd.schemaregistry.v1+json' \
  -X POST https://<host>:<port>/subjects/orders-value/versions \
  -d '{"schema":"{\"type\":\"record\",\"name\":\"Order\",\"fields\":[{\"name\":\"amount\",\"type\":\"int\"}]}"}'

Le Schema Registry renvoie l'identifiant du schéma :

{"id":1}

Listez les subjects auxquels l'utilisateur a accès :

curl --cacert ca.pem -u 'app-orders:<password>' https://<host>:<port>/subjects
["orders-value"]

Votre avis nous intéresse !

Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Vous êtes sur Discord ? Rejoignez notre chaîne via https://discord.gg/ovhcloud et interagissez directement avec l’équipe qui développe notre service Analytics !

Rejoignez notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?