Ir para o conteúdo

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
TablePro em um Mac conectado ao ClickHouse, com uma consulta analítica e seus resultados.

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 SETTINGS na consulta, como SELECT … SETTINGS max_threads = 4. Cada instrução é uma requisição HTTP própria, então um SET separado 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 /ping nessa porta responde Ok. quando a interface HTTP está ativa.

Baixe o TablePro

Tudo nesta página é gratuito.