Pular para o conteúdo principal
clickhouse-jdbc-bridge contém código experimental e não recebe mais suporte. Ele pode conter vulnerabilidades de confiabilidade e segurança. Use por sua conta e risco.
O uso de JDBC requer o ClickHouse JDBC Bridge, portanto você precisará usar o clickhouse-local em uma máquina local para transmitir os dados do seu banco de dados para o ClickHouse Cloud. Visite a página Using clickhouse-local na seção Migrate da documentação para mais detalhes.
Visão geral: O ClickHouse JDBC Bridge, em combinação com a função de tabela JDBC ou o engine de integração ou o engine de tabela JDBC, permite que o ClickHouse acesse dados de qualquer fonte de dados externa para a qual haja um driver JDBC disponível: Isso é útil quando não há um integration engine, uma table function ou um dicionário externo nativo disponível para a fonte de dados externa, mas existe um driver JDBC para essa fonte de dados. Você pode usar o ClickHouse JDBC Bridge tanto para leituras quanto para gravações, inclusive em paralelo para várias fontes de dados externas. Por exemplo, é possível executar consultas distribuídas no ClickHouse em tempo real em várias fontes de dados externas e internas. Nesta lição, vamos mostrar como é fácil instalar, configurar e executar o ClickHouse JDBC Bridge para conectar o ClickHouse a uma fonte de dados externa. Usaremos o MySQL como fonte de dados externa nesta lição. Vamos começar!
Pré-requisitosVocê precisa ter acesso a uma máquina que tenha:
  1. um shell Unix e acesso à internet
  2. wget instalado
  3. uma versão atual do Java (por exemplo, OpenJDK versão >= 17) instalada
  4. uma versão atual do MySQL (por exemplo, MySQL versão >=8) instalada e em execução
  5. uma versão atual do ClickHouse instalada e em execução

​
Instale o ClickHouse JDBC Bridge localmente

A forma mais fácil de usar o ClickHouse JDBC Bridge é instalá-lo e executá-lo no mesmo host em que o ClickHouse também está sendo executado: Vamos começar nos conectando ao shell Unix da máquina em que o ClickHouse está em execução e criando uma pasta local onde instalaremos o ClickHouse JDBC Bridge mais adiante (fique à vontade para dar à pasta o nome que quiser e colocá-la onde preferir):
Agora, baixe a versão atual do ClickHouse JDBC Bridge para essa pasta:
Para poder se conectar ao MySQL, vamos criar uma fonte de dados nomeada:
Agora você pode copiar e colar a configuração a seguir no arquivo ~/clickhouse-jdbc-bridge/config/datasources/mysql8.json:
no arquivo de configuração acima
  • você pode usar qualquer nome que quiser para a fonte de dados; usamos mysql8
  • no valor de jdbcUrl, você precisa substituir <host> e <port> pelos valores apropriados de acordo com a sua instância do MySQL em execução, por exemplo, "jdbc:mysql://localhost:3306"
  • você precisa substituir <username> e <password> pelas suas credenciais do MySQL; se não usar senha, pode excluir a linha "password": "<password>" no arquivo de configuração acima
  • no valor de driverUrls, especificamos apenas uma URL da qual a versão atual do driver JDBC do MySQL pode ser baixada. Isso é tudo o que precisamos fazer, e o ClickHouse JDBC Bridge fará o download automaticamente desse driver JDBC (em um diretório específico do sistema operacional).

Agora estamos prontos para iniciar o ClickHouse JDBC Bridge:
Iniciamos o ClickHouse JDBC Bridge em modo de primeiro plano. Para interromper o Bridge, traga a janela do shell Unix mostrada acima para o primeiro plano e pressione CTRL+C.

​
Use a conexão JDBC a partir do ClickHouse

Agora o ClickHouse pode acessar dados do MySQL usando a função de tabela JDBC ou o engine de tabela JDBC. A maneira mais fácil de executar os exemplos a seguir é copiá-los e colá-los no clickhouse-client ou na Play UI.
  • função de tabela JDBC:
Como primeiro parâmetro da função de tabela JDBC, usamos o nome da fonte de dados nomeada que configuramos acima.
  • Engine de tabela JDBC:
Como primeiro parâmetro da cláusula engine jdbc, estamos usando o nome da fonte de dados nomeada que configuramos acimaO esquema da tabela do engine JDBC do ClickHouse e o esquema da tabela MySQL conectada devem ser compatíveis entre si; por exemplo, os nomes e a ordem das colunas devem ser os mesmos, e os tipos de dados das colunas devem ser compatíveis

​
Instalar o ClickHouse JDBC Bridge externamente

Para um cluster distribuído do ClickHouse (um cluster com mais de um host do ClickHouse), faz sentido instalar e executar o ClickHouse JDBC Bridge externamente, em um host próprio: Isso traz a vantagem de permitir que cada host do ClickHouse acesse o JDBC Bridge. Caso contrário, o JDBC Bridge precisaria ser instalado localmente em cada instância do ClickHouse que deve acessar fontes de dados externas por meio do Bridge. Para instalar o ClickHouse JDBC Bridge externamente, siga estas etapas:
  1. Instale, configure e execute o ClickHouse JDBC Bridge em um host dedicado, seguindo as etapas descritas na seção 1 deste guia.
  2. Em cada host do ClickHouse, adicione o seguinte bloco de configuração à configuração do servidor ClickHouse (dependendo do formato de configuração escolhido, use a versão em XML ou YAML):
  • substitua JDBC-Bridge-Host pelo nome do host ou endereço IP do host dedicado do ClickHouse JDBC Bridge
  • especificamos a porta padrão do ClickHouse JDBC Bridge, 9019; se você estiver usando uma porta diferente para o JDBC Bridge, adapte a configuração acima adequadamente
Última modificação em 25 de junho de 2026