Configure um consumidor de script

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Use um script para importar e processar dados do seu ambiente Kafka.

    Antes de Iniciar

    Por Que e Quando Desempenhar Esta Tarefa

    Para configurar um consumidor, você precisa criar dois registros.
    1. O registro do consumidor, que especifica como importar e processar dados.
    2. Um registro para o fluxo Kafka, que define o fluxo de dados para seu consumidor.
    Esta tarefa cobre a criação do consumidor. Para obter instruções sobre como criar um fluxo Kafka, consulte Crie um fluxo Kafka.

    Procedimento

    1. Navegar até Tudo > IntegrationHub > Consumidores > Consumidor de script.
    2. Selecione Novo.
    3. No formulário, preencha os campos.
      Tabela 1. Consumidor de script
      Campo Descrição
      Nome Nome do consumidor de script.
      Garantia de entrega Se houver uma falha de nó, opção para especificar a garantia de entrega para mensagens de entrada. Selecione uma das seguintes opções.
      • Não perdidos, mas duplicados : Todas as mensagens são entregues pelo menos uma vez. Algumas mensagens podem ser entregues mais de uma vez.
      • Uma vez ou não : Uma mensagem não é entregue mais de uma vez. Algumas mensagens podem não ser entregues.
      Formato de serialização O formato de serialização da mensagem. Selecione uma das seguintes opções.
      • Texto sem formatação : Selecione esta opção para qualquer mensagem de texto sem formatação. Este é o formato padrão.
      • Codificado : Selecione esta opção para mensagens em um Apache Formato Avro. Converter mensagens de texto sem formatação para um formato Avro requer um esquema. Selecione o registro de esquema no Registro de esquema campo. Para obter mais informações sobre esquemas, consulte Gestão de esquemas em Stream Connect.
      Consumidor do evento Script a ser usado para consumir as mensagens recebidas do tópico Kafka.
      Aplicação Escopo da aplicação para o consumidor do mapa de transformação.
      Registro de esquema
      Registro do esquema selecionado. Selecione uma das seguintes opções.
      • Registro de esquema autônomo
      • Registro de esquema confluent

      Este campo aparece somente quando Formato de serialização está definido como Codificado .

      Para o Registro de esquema confluent, se o ID de esquema da mensagem recebida não estiver na tabela de esquema, o sistema importará o esquema dinamicamente, usando a conexão REST configurada.

    4. Selecione Save (Salvar).

    Exemplo

    Este exemplo mostra um script de exemplo para processar mensagens.
    (function process(messages) {
     // Add your code here to consume kafka messages 
     // sample message [ { 'key' : 'message_key' , 'message' : 'message' , 'headers' : [ { 'key' : 'header_key' , 'value' : 'header_value' } ] } ] 
    
     for (var i = 0; i < messages.length; i++) {
         var message = JSON.parse(messages[i].message);
         gs.info('Number ' + message.number + ', short description ' + message.short_description +
             ', headers ' + JSON.stringify(messages[i].headers));
     }
    })(messages);

    O que Fazer Depois

    Crie um fluxo Kafka para este consumidor. Depois que o fluxo é ativado, você pode começar a receber mensagens do seu ambiente Kafka.