Client ClickHouse per Mac
Esegui SQL analitico tramite l’interfaccia HTTP di ClickHouse, leggi piano, pipeline o stima delle righe di una query e gestisci parti e partizioni MergeTree dalla scheda Parts della tabella. Le query lunghe riportano le righe lette durante l’esecuzione e Stop le termina sul server.
Funziona su MacIl driver è incluso nell’app per Mac


A colpo d’occhio
- Linguaggio di query
- SQL
- Driver
- Incluso nell’app per Mac
- Connetti tramite
- Host e porta, Tunnel SSH, SSL/TLS
- Porta predefinita
- 8123
- iPhone e iPad
- Non si apre
Connetti
Fornisci host, porta HTTP, utente e, se vuoi, database. Il cambio di database avviene sulla stessa connessione e una scheda aperta rimane sul database iniziale. View > Sidebar as Tree mostra i database del server come albero da espandere sul posto.
Scegli qualsiasi modalità SSL per passare a HTTPS. Le porte 443 o 8443, quella usata da ClickHouse Cloud, attivano Verify Identity, che verifica il certificato rispetto al file CA o all’archivio di certificati attendibili del sistema. Verify CA richiede un file CA e un certificato e una chiave client consentono di raggiungere server che richiedono TLS reciproco.
Senza TLS, raggiungi un server remoto tramite un tunnel SSH anziché inviare HTTP non cifrato sulla rete.
Esegui query e modifica
Ogni query ha un proprio ID e richiede aggiornamenti sul progresso, quindi una query lunga riporta le righe lette durante l’esecuzione. Stop invia KILL QUERY per quell’ID e il timeout delle query della connessione raggiunge il server.
Il menu Explain offre Plan, Pipeline, AST, Syntax ed Estimate. L’output indentato viene rappresentato come diagramma o albero ed Estimate mostra righe, mark e parti che la query leggerebbe.
Le modifiche nella griglia vengono inviate come INSERT, ALTER TABLE … UPDATE e ALTER TABLE … DELETE, con Preview SQL prima. ClickHouse esegue aggiornamenti ed eliminazioni come mutazioni in background, quindi un salvataggio significa accettato, non ancora applicato; system.mutations mostra il progresso. Una vista materializzata si apre in sola lettura.
Un risultato con tuple di punti o anelli ClickHouse si apre nella vista Map. Una query con una propria clausola FORMAT mostra l’output non elaborato del server in una colonna, quindi ometti la clausola per ottenere una griglia.
Tabelle, parti e partizioni
Una tabella si apre con le schede Structure, Indexes, DDL e Parts. Indexes mostra la chiave di ordinamento e gli indici data-skipping e DDL mostra l’intero CREATE TABLE, motore e impostazioni inclusi.
Parts elenca ogni parte da system.parts con partizione, righe, dimensione sul disco, ora di modifica e indicatore di attività e consente di eseguire Optimize, Drop Partition e Detach Partition.
La scheda Structure aggiunge, modifica ed elimina colonne ed elimina indici data-skipping. Chiave di ordinamento e chiave primaria vengono fissate alla creazione della tabella, quindi aggiungi un indice data-skipping con ALTER TABLE … ADD INDEX e ricrea la tabella per altre modifiche.
Monitora
Il Server Dashboard mostra query attive, merge attivi, mutazioni delle parti e uso del disco, elenca le altre sessioni con Terminate Session per ciascuna e legge l’elenco delle query lente da system.query_log: le query concluse più recenti durate oltre un secondo.
Sposta i dati
Carica file CSV, TSV, JSON, JSONL, XLSX e SQL con Import ed esporta tabelle o risultati delle query in CSV, JSON, SQL, XLSX, Markdown, HTML e XML. Una colonna con anche un solo valore non UTF-8 valido appare in esadecimale nella griglia; seleziona toValidUTF8(column) per leggerla come testo.
iPhone e iPad
L’app per iPhone e iPad non ha un driver ClickHouse. Le connessioni ClickHouse sincronizzate da un Mac compaiono nell’elenco, ma non si aprono.
Limiti
- Le connessioni usano l’interfaccia HTTP di ClickHouse. Il protocollo TCP nativo non viene usato.
- TLS è disattivato per impostazione predefinita. Scegli una modalità SSL nel modulo di connessione per usare HTTPS.
- Nessuna chiave esterna o transazione.
- Un’istruzione SET non viene mantenuta nella query successiva.
Domande su ClickHouse
Come modifico un’impostazione per una query?
Inseriscila in una clausola SETTINGS nella query stessa, per esempio SELECT … SETTINGS max_threads = 4. Ogni istruzione è una richiesta HTTP autonoma senza sessione, quindi un SET separato scompare alla successiva.
Perché la porta 9000 non si connette?
La porta 9000 è la porta TCP nativa di ClickHouse, che TablePro non usa. Connettiti alla porta HTTP oppure alla 8443 per HTTPS su ClickHouse Cloud e verifica che l’interfaccia HTTP del server sia attiva: una richiesta a /ping su quella porta risponde Ok.
Scarica TablePro
Richiede macOS 13 Ventura o successivo