Cliente de ClickHouse para Mac
Execute SQL analítico pela interface HTTP do ClickHouse, leia o plano, o pipeline ou a estimativa de linhas de uma consulta e gerencie partes e partições MergeTree pela aba Parts da tabela. Consultas longas informam as linhas lidas durante a execução, e Stop as encerra no servidor.
Funciona em MacO driver acompanha o app para Mac


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
- iPhone e iPad
- Não abre
Conecte-se
Informe o host, a porta HTTP, um usuário e, se quiser, um banco. Alternar o banco acontece na mesma conexão, e uma aba aberta permanece no banco em que começou. View > Sidebar as Tree mostra os bancos do servidor como uma árvore que você expande no local.
Escolha qualquer modo SSL para usar HTTPS. As portas 443 ou 8443, usada pelo ClickHouse Cloud, ativam Verify Identity, que verifica o certificado com o arquivo CA ou 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
Cada consulta leva seu próprio ID e solicita progresso, portanto uma consulta longa informa as linhas lidas durante a execução. Stop envia KILL QUERY para esse ID, e o timeout de consulta da conexão chega ao servidor.
O menu Explain oferece Plan, Pipeline, AST, Syntax e Estimate. A saída indentada é apresentada como diagrama ou árvore, e Estimate mostra as linhas, marcas e partes que uma consulta leria.
As edições na grade são enviadas como INSERT, ALTER TABLE … UPDATE e ALTER TABLE … DELETE, primeiro com Preview SQL. ClickHouse executa atualizações e exclusões como mutações em segundo plano, portanto salvar significa que foram aceitas, ainda não aplicadas; system.mutations mostra o progresso. Uma view materializada abre somente para leitura.
Um resultado com tuplas de ponto ou anel do ClickHouse abre na visualização Map. Uma consulta com sua própria cláusula FORMAT mostra a saída bruta do servidor em uma coluna, portanto omita a cláusula para obter uma grade.
Tabelas, partes e partições
Uma tabela abre com as abas Structure, Indexes, DDL e Parts. Indexes mostra a chave de ordenação e os índices data-skipping, e DDL mostra o CREATE TABLE completo, incluindo mecanismo e configurações.
Parts lista cada parte de system.parts com partição, linhas, tamanho no disco, data de modificação e indicação de atividade, e permite executar Optimize, Drop Partition e Detach Partition.
A aba Structure adiciona, modifica e remove colunas e remove índices data-skipping. A chave de ordenação e a chave primária são fixadas na criação da tabela, portanto adicione um índice data-skipping com ALTER TABLE … ADD INDEX e recrie a tabela para outras alterações.
Monitore
O Server Dashboard mostra consultas ativas, merges ativos, mutações de partes e uso de disco, lista as outras sessões com Terminate Session em cada uma e lê as consultas lentas de system.query_log: as consultas concluídas mais recentes que demoraram mais de um segundo.
Mova dados
Carregue arquivos CSV, TSV, JSON, JSONL, XLSX e SQL com Import e exporte tabelas ou resultados de consultas como CSV, JSON, SQL, XLSX, Markdown, HTML e XML. Uma coluna com pelo menos um valor que não é UTF-8 válido aparece em hexadecimal na grade; selecione toValidUTF8(column) para lê-la como texto.
iPhone e iPad
O app para iPhone e iPad não tem um driver de ClickHouse. As conexões ClickHouse sincronizadas de um Mac aparecem na lista, mas não abrem.
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.
Perguntas sobre ClickHouse
Como altero uma configuração para uma consulta?
Coloque-a em uma cláusula SETTINGS na própria consulta, como SELECT … SETTINGS max_threads = 4. Cada instrução é uma requisição HTTP independente, sem sessão, portanto um SET separado não permanece para a próxima.
Por que a porta 9000 não conecta?
A porta 9000 é a porta TCP nativa de ClickHouse, que TablePro não usa. Conecte à porta HTTP ou à 8443 para HTTPS no ClickHouse Cloud e confira se a interface HTTP do servidor está ativa: uma requisição a /ping nessa porta responde Ok.
Baixe TablePro
Requer macOS 13 Ventura ou posterior