Configurer un consommateur de carte de transformation

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Importez et traitez les données de votre environnement Kafka à l’aide de vos configurations de cartes de transformation existantes.

    Avant de commencer

    Formatage des charges utiles des messages Kafka

    Utilisez des charges utiles JSON simples pour les messages Kafka. Chaque message Kafka ne doit avoir qu’un seul objet JSON plat. Les charges utiles JSON complexes, telles que celles avec des listes et des objets imbriqués, ne sont pas prises en charge.

    Exemple d’entrée JSON simple et valide, à l’aide d’une carte plate de paires clé-valeur.
    {"key1": "value1", "key2": "value2"}
    Exemples d’entrées JSON complexes et non valides. Le premier utilise une liste. Le second utilise des objets imbriqués.
    [{"key1": "value1", "key2": "value2"}, {"key1": "value3", "key2": "value4"}]
    {"key1": "value1", "key2": {"key3": "value3", "key4": "value4"}}

    Pourquoi et quand exécuter cette tâche

    Pour configurer un consommateur, vous devez créer deux enregistrements.
    1. Enregistrement consommateur, qui spécifie le mode d’importation et de traitement des données.
    2. Un enregistrement pour le flux Kafka, qui définit le flux de données vers votre consommateur.
    Cette tâche couvre la création du consommateur. Pour obtenir des instructions sur la création d’un flux Kafka, reportez-vous à la section Créer un flux Kafka.

    Procédure

    1. Accédez à la Tous > Centre d'intégration > Consommateurs > Consommateur de carte de transformation.
    2. Sélectionnez Nouveau.
    3. Renseignez les champs du formulaire.
      Tableau 1. Consommateur de carte de transformation
      Champ Description
      Nom Nom du consommateur de carte de transformation.
      Carte de transformation Nom de la carte de transformation à utiliser pour traiter les données.
      Garantie de livraison En cas de défaillance d’un nœud, option permettant de spécifier la garantie de remise des messages entrants. Sélectionnez l'une des options suivantes :
      • Pas de pertes, mais des doublons : tous les messages sont remis au moins une fois. Certains messages peuvent être remis plusieurs fois.
      • Une fois ou pas du tout : un message n’est pas remis plus d’une fois. Certains messages peuvent ne pas être remis du tout.
      Format de sérialisation Format de sérialisation du message. Sélectionnez l'une des options suivantes :
      • Texte brut : sélectionnez cette option pour tous les messages en texte brut. Il s’agit du format par défaut.
      • Encodé : sélectionnez cette option pour les Apache messages au format Avro. La conversion de messages en texte brut au format Avro nécessite un schéma. Sélectionnez le registre de schémas dans le champ Registre de schémas . Pour plus d’informations sur les schémas, reportez-vous à la section Gestion des schémas dans Connexion au flux.
      Mappage de colonnes Option permettant de spécifier si la clé JSON du message mappe les données au nom ou à l’étiquette de la colonne dans la table d’ensembles de données à importer. Sélectionnez l'une des options suivantes :
      • Étiquette
      • Nom de colonne
      Synchroniser les insertions Option permettant de garantir qu’il n’existe qu’un seul enregistrement avec des valeurs de champ de fusion uniques en synchronisant les insertions d’enregistrement.
      Application Périmètre de l’application pour le consommateur de carte de transformation.
      Registre de schémas
      Registre pour le schéma sélectionné. Sélectionnez l'une des options suivantes :
      • Registre de schémas autonome
      • Registre de schéma Confluent

      Ce champ apparaît uniquement lorsque le format de sérialisation est défini sur Codé.

      Pour le registre de schémas Confluent, si l’ID de schéma du message reçu ne figure pas dans la table de schémas, le système importe le schéma de manière dynamique, à l’aide de la connexion REST configurée.
    4. Sélectionnez Enregistrer.

    Que faire ensuite

    Créer un flux Kafka pour ce consommateur. Une fois le flux activé, vous pouvez commencer à recevoir des messages de votre environnement Kafka.