Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Conectar o DBeaver ao ClickHouse

Integração com parceiro

O DBeaver está disponível em várias versões. Neste guia, usamos o DBeaver Community. Veja as diferentes versões e recursos aqui. O DBeaver se conecta ao ClickHouse usando JDBC.

Reúna os detalhes do seu ClickHouse

O DBeaver usa JDBC sobre HTTP(S) para se conectar ao ClickHouse; você precisa de:

  • endpoint
  • número da porta
  • nome de usuário
  • senha

Baixe o DBeaver

O DBeaver está disponível em https://dbeaver.io/download/

Adicione um banco de dados

  • Use o menu Database > New Database Connection ou o ícone New Database Connection no Database Navigator para abrir a caixa de diálogo Connect to a database:
Adicionar um novo banco de dados
  • Selecione Analytical e, em seguida, ClickHouse:

  • Monte a URL JDBC. Na guia Main, defina Host, Port, Username, Password e Database:

Defina o hostname, a porta, o usuário, a senha e o nome do banco de dados
  • Por padrão, a propriedade SSL > Use SSL não estará ativada. Se você estiver se conectando ao ClickHouse Cloud ou a um servidor que exige SSL na porta HTTP, ative SSL > Use SSL:
Ative SSL, se necessário
  • Teste a conexão:
Teste a conexão

Se o DBeaver detectar que você não tem o driver do ClickHouse instalado, ele oferecerá baixá-lo para você:

Baixe o driver do ClickHouse
  • Após baixar o driver, Test a conexão novamente:
Teste a conexão

Faça consultas no ClickHouse

Abra um editor de consultas e execute uma consulta.

  • Clique com o botão direito na sua conexão e escolha SQL Editor > Open SQL Script para abrir um editor de consultas:
Abra o editor SQL
  • Exemplo de consulta em system.query_log:
Uma consulta de exemplo

Próximos passos

Consulte a wiki do DBeaver para conhecer os recursos do DBeaver e a documentação do ClickHouse para conhecer os recursos do ClickHouse.

Navigation