Conectar o DBeaver ao ClickHouse

DBeaver é uma ferramenta de banco de dados multiplataforma.

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.

Use o DBeaver versão 23.1.0 ou superior para ter melhor suporte a colunas Nullable no ClickHouse.

​

1. Reúna as informações 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

​

2. Baixe o DBeaver

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

​

3. 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:

• Selecione Analytical e, em seguida, ClickHouse:

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

• 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:

• Teste a conexão:

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

• Após baixar o driver, Test a conexão novamente:

​

4. Consultar o ClickHouse

Abra um editor de consultas e execute uma consulta.

• Clique com o botão direito na conexão e escolha SQL Editor > Open SQL Script para abrir um editor de consultas:

• Exemplo de consulta em system.query_log:

​

Próximas etapas

Consulte a wiki do DBeaver para saber mais sobre os recursos do DBeaver e a documentação do ClickHouse para saber mais sobre os recursos do ClickHouse.