// ferramenta gratuita

Construtor de strings de conexão do ClickHouse

Construa strings de conexão do ClickHouse para a interface HTTP e o protocolo nativo a partir de um único formulário, ou cole uma para verificar a porta, o protocolo e as configurações de TLS. Tudo roda no seu navegador: nada do que você digita é enviado para lugar nenhum.

Abrir esta conexão no SQLly

Abre o editor de conexão do SQLly preenchido.

Privado por design. O construtor e o decodificador são JavaScript puro rodando nesta aba. A página não envia nenhuma solicitação com o que você digita, não armazena nada (nem mesmo no seu navegador) e continua funcionando offline após carregada. O link Abrir no SQLly vai do seu navegador direto para o aplicativo no seu computador.

Formatos de strings de conexão do ClickHouse

O ClickHouse possui dois protocolos de cliente em portas diferentes: HTTP (8123, ou 8443 com TLS), usado pelo JDBC, clickhouse-connect e o driver .NET, e o protocolo TCP nativo (9000, ou 9440 com TLS), usado pelo clickhouse-client e clickhouse-go. Apontar um cliente para a porta do outro protocolo é o erro de conexão mais comum.

URL HTTP Interface HTTP, curl

https://ch.example.com:8443/?database=analytics

DSN nativo clickhouse-go v2

clickhouse://default:[email protected]:9440/analytics?secure=true

JDBC clickhouse-java 0.8+

jdbc:clickhouse:https://ch.example.com:8443/analytics?user=default&password=your_password&ssl=true

ADO.NET ClickHouse.Driver

Host=ch.example.com;Protocol=https;Username=default;Password=your_password;Database=analytics

Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao ClickHouse: SQLly para ClickHouse.

Portas do ClickHouse

Do guia de portas de rede do ClickHouse.

Palavra-chaveSinônimosPadrãoO que faz
8123 - - Interface HTTP.
8443 - - Interface HTTPS.
9000 - - Protocolo TCP nativo.
9440 - - Protocolo nativo sobre TLS.
9004 / 9005 - - Interfaces de compatibilidade com o wire protocol do MySQL e do PostgreSQL.

Parâmetros DSN do clickhouse-go v2

clickhouse://user:password@host1:9000,host2:9000/database?param=value; http:// e https:// DSNs usam a interface HTTP.

Palavra-chaveSinônimosPadrãoO que faz
secure - falso TLS.
skip_verify - falso Ignorar verificação de certificados.
dial_timeout - 30s Tempo limite de conexão com unidade.
read_timeout - 5m Tempo limite de leitura.
compress - - Método de compressão.
connection_open_strategy - - Como os hosts são selecionados.

Chaves do ClickHouse.Driver (.NET)

Estilo ADO.NET.

Palavra-chaveSinônimosPadrãoO que faz
Host - localhost Host do servidor.
Port - 8123 / 8443 Porta HTTP(S).
Protocol - http http ou https.
Username - padrão Nome do usuário.
Password - vazio Senha.
Database - vazio Banco de dados padrão.
Compression - true Comprimir o tráfego.
UseSession - falso Usar uma sessão do lado do servidor.
Timeout - 120 Segundos.

Opções do clickhouse-client

O clickhouse-client também aceita uma string de conexão como seu primeiro argumento: clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters].

Palavra-chaveSinônimosPadrãoO que faz
--host, -h - localhost Host do servidor.
--port - 9000 (9440 com --secure) Porta nativa.
--user, -u - padrão Usuário.
--password --ask-password - Senha; --ask-password Solicitações.
--database, -d - padrão Banco de dados.
--secure, -s - - TLS; ativado automaticamente para a porta 9440 e hosts do ClickHouse Cloud.

Erros comuns de conexão com ClickHouse

Port 9000 is for clickhouse-client program. You must use port 8123 for HTTP.

Por que: Um cliente HTTP (navegador, curl, JDBC, clickhouse-connect, .NET) foi apontado para a porta do protocolo nativo.

Correção: Use 8123 ou 8443 para HTTPS.

Code: 516. DB::Exception: default: Authentication failed: password is incorrect, or there is no user with such name.

Por que: Usuário ou senha incorretos, ou o usuário pode não ter permissão para fazer login a partir do seu endereço.

Correção: Verifique as credenciais e os hosts permitidos do usuário na configuração de usuários do servidor.

Code: 81. DB::Exception: Database analytics does not exist. (UNKNOWN_DATABASE)

Por que: O banco de dados na string não existe.

Correção: Verificar SHOW DATABASES e a ortografia.

Unexpected packet / connection reset on the native port

Por que: Um cliente do protocolo nativo (clickhouse-client, clickhouse-go) está se conectando a uma porta HTTP, ou um cliente comum à porta TLS 9440.

Correção: Use 9000 sem TLS ou 9440 com --secure / secure=true.

Perguntas frequentes sobre strings de conexão do ClickHouse

Qual porta devo usar para o ClickHouse?

Clientes HTTP (JDBC, clickhouse-connect, .NET, curl) usam 8123 ou 8443 para HTTPS. Clientes nativos (clickhouse-client, clickhouse-go DSN nativo) usam 9000 ou 9440 para TLS. ClickHouse Cloud atende 8443 e 9440.

Qual é o formato da URL JDBC do ClickHouse?

jdbc:clickhouse:http://host:8123/database ou jdbc:clickhouse:https://host:8443/database?ssl=true (driver 0.8+). O driver não adivinha o protocolo a partir da porta, então escreva.

Posso colocar a senha na URL HTTP?

Evite isso: URLs acabam nos logs. Envie no X-ClickHouse-User e X-ClickHouse-Key cabeçalhos, ou com autenticação básica HTTP.

// dispense as strings por completo

Conecte-se uma vez. Depois é só escrever SQL.

O SQLly é um ambiente de trabalho SQL nativo para macOS, Windows e Linux. Cole uma string de conexão no editor de conexões, mantenha as senhas no chaveiro do sistema e tenha IntelliSense baseado no esquema no ClickHouse e muito mais.