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.
Abrir esta conexão no SQLly
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-chave | Sinônimos | Padrão | O 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-chave | Sinônimos | Padrão | O 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-chave | Sinônimos | Padrão | O 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-chave | Sinônimos | Padrão | O 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.
Outros mecanismos
- Strings de conexão do SQL Server
- Strings de conexão do PostgreSQL
- Strings de conexão do MySQL
- Strings de conexão do MariaDB
- Strings de conexão do SQLite
- Strings de conexão do Oracle
- Strings de conexão do Redis
- Strings de conexão do DuckDB
- Strings de conexão do libSQL
- Todos os mecanismos e formatos
- Formatador SQL
- Todas as ferramentas gratuitas
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.