Loading...

ClickHouse

Esegui query SQL in sola lettura sul tuo database ClickHouse e porta i risultati nel foglio.

Il connettore ClickHouse esegue una query SQL di tua scelta, in sola lettura, su un database ClickHouse che gestisci tu: non richiede OAuth, usa host, porta, nome del database, utente e password che inserisci al momento della connessione. A differenza di MySQL/MariaDB/PostgreSQL, comunica direttamente con l'interfaccia HTTP nativa di ClickHouse, non tramite un driver JDBC.

Non è ammessa nessuna query diversa da SELECT (anche precedute da WITH): niente INSERT, UPDATE, DELETE o istruzioni che modificano la struttura, verificato prima di ogni esecuzione.

Suggerimento per aggiornamenti giornalieri: per scaricare automaticamente solo i dati nuovi ogni giorno (es. con uno schedule e "Append new results to old" attivo), non serve nessun meccanismo speciale: scrivi direttamente nella query una condizione con le funzioni data di ClickHouse, calcolate dal database ad ogni esecuzione, ad esempio WHERE toDate(data_inserimento) = today() oppure WHERE data_inserimento >= today() - 1. La query salvata resta sempre la stessa stringa, ma il risultato cambia ogni giorno perché queste funzioni vengono calcolate dal database al momento dell'esecuzione, non quando scrivi la query una volta.

Metriche disponibili

Non esistono metriche o dimensioni fisse: le colonne del report sono esattamente le colonne restituite dalla tua query SQL (i nomi delle colonne o degli alias usati nella SELECT).

Limiti noti

  • Solo query SELECT (o WITH)
    Una sola istruzione per query, niente INSERT/UPDATE/DELETE o modifiche alla struttura: verificato prima di ogni esecuzione. Una query che non supera il controllo mostra un errore invece di essere eseguita.
  • Nessun test al momento della connessione
    La pagina di connessione salva i dati inseriti senza verificarli: il test vero avviene la prima volta che selezioni quella connessione per configurare un report, non quando la crei.
  • Il server deve essere raggiungibile da internet
    Non funziona con reti locali o dietro VPN. Usa l'interfaccia HTTP di ClickHouse (non JDBC): il firewall del server deve autorizzare gli intervalli IP pubblicati da Google su gstatic.com/ipranges/goog.json, e la porta deve essere 1025 o superiore (8123 standard va bene, 8443 per HTTPS).
  • HTTP di default, con opzione HTTPS
    Di default la connessione usa HTTP semplice (porta 8123). Se il tuo server ClickHouse richiede una connessione cifrata — comune sui servizi gestiti, di solito sulla porta 8443 — spunta "Usa HTTPS" al momento della connessione. Usa sempre un utente dedicato con permessi di sola lettura, indipendentemente da questa impostazione.