Cliente de ClickHouse
Execute consultas analíticas por HTTP, leia planos e pipelines e gerencie partes e partições MergeTree.
Visão geral
- Linguagem de consulta
- SQL
- Driver
- Acompanha o app para Mac
- Conectar por
- Host e porta, Túnel SSH, SSL/TLS
- Porta padrão
- 8123
- Versão mínima
- Nenhuma


Conecte-se
Informe um host, a porta HTTP, o usuário e, se quiser, um banco de dados, e troque de banco sem reconectar; as abas abertas mantêm o banco em que começaram.
Qualquer modo SSL passa a conexão para HTTPS. A porta 443 ou 8443, a que o ClickHouse Cloud usa, ativa Verify Identity, que verifica o certificado com o seu arquivo CA ou com o repositório de confiança do sistema. Verify CA exige um arquivo CA, e um certificado e uma chave de cliente acessam servidores que exigem TLS mútuo.
Sem TLS, acesse um servidor remoto por um túnel SSH em vez de enviar HTTP sem criptografia pela rede.
Consulte e edite
O menu Explain oferece Plan, Pipeline, AST, Syntax e Estimate. A saída indentada é desenhada como diagrama ou árvore, e Estimate mostra as linhas, marcas e partes que uma consulta leria. Uma consulta em execução mostra as linhas lidas até o momento, Stop envia KILL QUERY, e o timeout de consulta da conexão é repassado ao servidor.
Inserções e mutações UPDATE e DELETE rodam pela grade. Um salvamento bem-sucedido significa aceito, não aplicado: acompanhe o progresso em system.mutations. As views materializadas são somente leitura. Tuplas de ponto e de anel abrem na visualização Mapa, e uma consulta com a própria cláusula FORMAT mostra a saída bruta do servidor em uma coluna, então omita a cláusula para obter uma grade.
Tabelas, partes e monitoramento
Uma tabela abre com as abas Structure, Indexes, DDL e Parts. Indexes mostra a chave de ordenação e os índices data-skipping, DDL mostra o CREATE TABLE completo com mecanismo e configurações, e Parts lê system.parts, com Optimize, Drop Partition e Detach Partition. A aba Structure altera colunas e remove índices data-skipping. A chave de ordenação e a chave primária são fixadas na criação da tabela, então adicione um índice data-skipping com ALTER TABLE … ADD INDEX e recrie a tabela para outras alterações.
O Server Dashboard mostra consultas ativas, merges, mutações de partes e uso de disco, encerra outras sessões e lista, a partir de system.query_log, as consultas concluídas que levaram mais de um segundo.
Esta página trata do que é específico de ClickHouse. Safe Mode, o assistente de IA, o servidor MCP e o resto do TablePro estão nas páginas de recursos.
Também
Mover dados
Importe arquivos CSV, TSV, JSON, JSONL, XLSX e SQL e exporte tabelas ou resultados como CSV, JSON, SQL, XLSX, Markdown, HTML e XML. Uma coluna com um valor que não é UTF-8 válido aparece em hexadecimal; selecione
toValidUTF8(column)para lê-la como texto.Limitações
- As conexões usam a interface HTTP do ClickHouse. O protocolo TCP nativo não é usado.
- TLS fica desativado por padrão. Escolha um modo SSL no formulário para usar HTTPS.
- Sem chaves estrangeiras nem transações.
- Uma instrução SET não permanece para a próxima consulta.
Como altero uma configuração para uma consulta?
Coloque-a em uma cláusula
SETTINGSna consulta, comoSELECT … SETTINGS max_threads = 4. Cada instrução é uma requisição HTTP própria, então umSETseparado já não vale na seguinte.Por que a porta 9000 não conecta?
A porta 9000 é a porta TCP nativa do ClickHouse, que o TablePro não usa. Conecte-se à porta HTTP, ou à 8443 para HTTPS no ClickHouse Cloud; uma requisição a
/pingnessa porta respondeOk.quando a interface HTTP está ativa.
Baixe o TablePro
Tudo nesta página é gratuito.