Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Integrando o Confluent Cloud ao ClickHouse

View as MarkdownEdit this pageReport an issueSet up docs MCP

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:

Parâmetro(s) Descrição
HOST and PORT Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS.
DATABASE NAME Por padrão, há um banco de dados chamado default; use o nome do banco de dados ao qual você deseja se conectar.
USERNAME and PASSWORD Por padrão, o nome de usuário é default. Use o nome de usuário apropriado para o seu caso de uso.

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.

Limitações conhecidas

Navigation