Conectar ao ClickHouse

Comece em Console → Projeto ClickHouse → Conexão. Copie o host, usuário, banco de dados e as portas do seu projeto; elas não são números fixos entre projetos. Se perdeu a senha mostrada na criação, leia Senha e operação antes de tentar conectar.

Escolha a porta pelo cliente

As portas são diferentes e não intercambiáveis. A URI clickhouse:// é nativa: não a cole no campo JDBC nem troque sua porta pela HTTPS. Se a Console não mostrar Porta HTTPS/JDBC, não calcule nem adivinhe um valor a partir da outra porta.

DBeaver passo a passo (HTTPS/JDBC)

1. Crie uma conexão em Analytical → ClickHouse. Prefira o driver ClickHouse atual, não ClickHouse Legacy. Se o programa pedir a instalação do driver, confirme.
2. Em Main, preencha Host, Port (Porta HTTPS/JDBC), Database, Username e Password usando a Console. Para conexões novas, o banco apresentado costuma ser app; confirme o nome no seu projeto.
3. Na aba SSL, marque Use SSL e mantenha a validação de certificado habilitada. Não aceite certificados inválidos nem substitua o host pelo IP.
4. Se usar Connect by → URL, informe uma URL JDBC inteira, não só https://. Substitua host e porta pelos valores do projeto; use app apenas quando esse for o banco exibido pela Console. Digite usuário e senha nos campos próprios, sem colocá-los na URL:

jdbc:clickhouse:https://HOST_FROM_CONSOLE:HTTPS_JDBC_PORT/app?ssl=true

5. Não omita ssl=true: inclua-o explicitamente, mesmo com https:// e Use SSL ativado. Neste fluxo real de DBeaver com a Zenifra, a conexão falhou sem ssl=true e funcionou com ele. A referência geral do JDBC descreve o parâmetro como opcional quando se escolhe HTTPS; essa regra genérica não substitui a configuração validada para este DBeaver.
6. Clique em Test Connection. Após conectar, execute SELECT 1 e SELECT currentDatabase() para verificar autenticação e banco ativo.

O prefixo jdbc:clickhouse: é obrigatório no campo de URL JDBC: https://… sozinho provoca Invalid JDBC URL. secure=true aparece na URI Native TLS clickhouse://…?secure=true; não substitui ssl=true no exemplo JDBC. O print de um erro de URL mostra apenas aquela tentativa, não explica sozinho todas as falhas de conexão. A interface do DBeaver pode variar entre versões; veja também a instrução oficial para DBeaver.

clickhouse-client passo a passo (Native TLS)

Use a Porta Native TLS da Console, não a HTTPS/JDBC. Deixe a senha fora da linha de comando para que o cliente a solicite sem gravá-la no histórico:

clickhouse-client --host HOST_DA_CONSOLE --port PORTA_NATIVE_TLS --secure \
  --user USUARIO_DA_CONSOLE --database BANCO_DA_CONSOLE --query 'SELECT 1'

Informe a senha no prompt. A opção --secure liga TLS para o cliente nativo; não é um parâmetro JDBC. A referência oficial do cliente descreve as opções de conexão. Não use --password com valor em comandos compartilhados. Não desabilite a verificação de certificado como solução para erros de host ou TLS.

Se a conexão falhar

• Invalid JDBC URL: confira o prefixo jdbc:clickhouse:https://, a porta HTTPS/JDBC e ssl=true.
• Falha SSL ou de certificado: confirme SSL ligado, hostname da Console e confiança na CA; não aceite certificado inválido para contornar o problema.
• Erro de protocolo ou HTTP 400: verifique se não enviou HTTPS à porta Native TLS nem protocolo nativo à porta HTTPS.
• HTTP 401 / falha de autenticação: confira usuário e senha nos campos do cliente. Uma requisição sem credenciais pode receber 401; compare com um teste autenticado.
• Conexão abre, mas as tabelas não aparecem: execute SELECT currentDatabase() e escolha o banco mostrado na Console. Os exemplos de primeiro uso empregam app.
• Senha mascarada: a Console não recupera a senha após a criação. Consulte rotação e diagnóstico.

Um /ping bem-sucedido ou uma porta aberta confirma apenas alcance do endpoint, não autorização para SQL. Valide com SELECT 1 usando o cliente e as credenciais reais.

Próximos passos

• Crie a tabela de exemplo e rode uma agregação.
• Compare topologias e storage incluído.
• Faça manutenção das credenciais.