Skip to main content

​
Pré-requisitos

Pressupomos que você tenha familiaridade com:

​
O conector Kafka oficial da ClickHouse com a Confluent Cloud

​
Criar um tópico

Criar um tópico no Confluent Cloud é bem simples, e há instruções detalhadas aqui.

​
Notas importantes

  • O nome do tópico do Kafka deve ser o mesmo da tabela do ClickHouse. Para ajustar isso, use um transformador (por exemplo, ExtractTopic).
  • Mais partições nem sempre significam mais desempenho — consulte nosso próximo guia para mais detalhes e dicas de performance.

​
Reúna os detalhes da conexão

Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações: Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud. Selecione um serviço e clique em Connect:
botão Connect do serviço do ClickHouse Cloud
Escolha HTTPS. Os detalhes de conexão são exibidos em um comando curl de exemplo.
detalhes de conexão HTTPS do ClickHouse Cloud
Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.

​
Instale o conector

Instale o ClickHouse Sink Connector totalmente gerenciado no Confluent Cloud seguindo a documentação oficial.

​
Configure o conector

Durante a configuração do ClickHouse Sink Connector, você precisará fornecer os seguintes detalhes:
  • hostname do seu servidor ClickHouse
  • porta do seu servidor ClickHouse (o padrão é 8443)
  • nome de usuário e senha do seu servidor ClickHouse
  • nome do banco de dados no ClickHouse em que os dados serão gravados
  • nome do tópico no Kafka que será usado para gravar dados no ClickHouse
A UI do Confluent Cloud oferece opções avançadas de configuração para ajustar intervalos de polling, tamanhos de lote e outros parâmetros a fim de otimizar o desempenho.
No Confluent Cloud, o ajuste de determinadas configurações, como configurações de fetch e configurações de polling, exige a abertura de um chamado de suporte no Confluent Cloud.

​
Limitações conhecidas

Última modificação em 3 de julho de 2026