Créer un schéma autonome dans Stream Connect

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • Créez un schéma pour permettre à vos producteurs et consommateurs Stream Connect d’envoyer et de recevoir des Apache messages Kafka au 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 Connexion au flux.
    • Le module d’extension ServiceNow 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 chargeant un fichier JSON ou en entrant directement un schéma en tant que 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 d’ID de schéma générée est l’ID de schéma le plus élevé suivant sur l’instance. Par exemple, si vos schémas ont des 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 par 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) Entrez un schéma au format de chaîne JSON.
    3. Sélectionnez Soumettre.
      Dans 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 dans la table Schéma de connexion au flux autonome [standalone_stream_connect_schema] et dans 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.