Créer un schéma autonome dans Stream Connect

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture

    • Créez un schéma pour permettre à vos producteurs et consommateurs Stream Connect d’envoyer et de recevoir des messages Kafka au Apache format Avro.

    Avant de commencer

    • Rôle requis : kafka_admin
    • Cette fonctionnalité fait partie de la gestion des schémas dans Stream Connect. Pour plus d'informations, consultez Gestion des schémas dans Stream Connect.
    • Le ServiceNow module d’extension Stream Connect Installer [com.glide.hub.stream_connect.installer] est requis.

    Pourquoi et quand exécuter cette tâche

    Stream Connect utilise des schémas pour convertir les messages du texte brut au format Avro et inversement. L’utilisation d’un format Avro peut réduire la taille de la charge utile et simplifier votre intégration à votre instance Kafka locale.

    Ce document vous montre comment créer votre propre schéma autonome en téléchargeant un fichier JSON ou en saisissant un schéma directement sous forme de chaîne au format JSON. Vous pouvez également Importer un schéma à partir du registre Confluent.

    Procédure

    1. Accédez à la Tout > Centre d'intégration > Gestion des schémas > Créer un schéma autonome.

      Sur le formulaire de création d’un schéma Avro, la valeur de l’ID de schéma est automatiquement renseignée. Vous pouvez conserver la valeur suggérée ou la modifier.

      Tous les schémas ont un ID de schéma, un identificateur unique global du schéma. Pour les schémas autonomes, l’ID de schéma est généré localement et est unique sur l’instance. Par défaut, la valeur de l’ID de schéma généré est l’ID de schéma le plus élevé disponible suivant sur l’instance. Par exemple, si vos schémas ont les numéros d’ID un à cinq, le schéma suivant que vous créez aura un ID de schéma de six. Les ID de schéma sont uniques pour chaque registre. Par exemple, deux schémas peuvent tous deux avoir un ID d’un tant qu’ils se trouvent dans des registres différents.

    2. Dans le champ Source , sélectionnez l’une des options suivantes.
      Option Description
      Fichier Sélectionnez un fichier JSON pour importer le schéma. Une fois importé, le contenu du fichier est visible dans le champ du schéma JSON .
      Chaîne au format Avro (JSON) Saisissez un schéma au format de chaîne JSON.
    3. Sélectionnez Soumettre.
      Sur le formulaire Schéma de connexion au flux autonome, le champ Schéma contient le schéma au format JSON que vous avez chargé ou saisi.

    Résultats

    Votre schéma est visible sur la table Schéma de connexion au flux autonome [standalone_stream_connect_schema] et la table Schémas de connexion au flux [stream_connect_schema].

    Que faire ensuite

    Utilisez les producteurs et les consommateurs de Stream Connect pour envoyer et recevoir des messages au format Avro.