ClickHouse

Collega Looker al tuo database ClickHouse per analizzare i dati e creare dashboard interattive. Questa connessione consente di rendere disponibili i dati di ClickHouse per la generazione di report e l'analisi in Looker, supportando decisioni dirette basate sui dati.

Questa pagina ti guida nella configurazione dell'istanza ClickHouse e delle impostazioni di connessione di Looker, tra cui come criptare il traffico di rete, definire le autorizzazioni utente e rivedere le funzionalità supportate. Looker supporta ClickHouse versione 0.2 o successive e ClickHouse 26+ utilizzando driver JDBC modernizzati e il supporto dell'aggregazione simmetrica.

Criptare il traffico di rete

È una best practice criptare il traffico di rete tra l'applicazione Looker e il tuo database. Valuta una delle opzioni descritte nella pagina della documentazione Abilita l'accesso sicuro ai database.

Per abilitare la crittografia SSL lato server, consulta la documentazione sulle impostazioni globali del server ClickHouse.

Utenti e sicurezza

Innanzitutto, configura l'utente Looker sul server ClickHouse. Gli utenti del database ClickHouse possono essere configurati utilizzando SQL (CREATE USER) o tramite la sezione users nel file users.xml. Segui la documentazione sui diritti di accesso a ClickHouse per configurare l'accesso utente. Il seguente esempio di base utilizza users.xml:

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

In questo file, configura anche l'accesso al database appropriato:

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

Creazione della connessione Looker al tuo database

Nella sezione Amministrazione di Looker, seleziona Connessioni e poi fai clic su Aggiungi connessione.

Compila i dettagli della connessione. La maggior parte delle impostazioni è comune alla maggioranza dei dialetti di database. Per informazioni, consulta la pagina della documentazione Connessione di Looker al tuo database. Di seguito sono descritte alcune impostazioni:

• Dialect (Dialetto): seleziona ClickHouse 26+ o ClickHouse.
• Host: nome host o indirizzo IP raggiungibile del server ClickHouse.
• Porta: porta su cui il servizio ClickHouse è raggiungibile tramite HTTP(S).
  • Per impostazione predefinita, le connessioni HTTP utilizzano 8123 e le connessioni HTTPS utilizzano 8443.
  • Le porte 9000 e 9440 vengono utilizzate per impostazione predefinita dal client a riga di comando TCP nativo di ClickHouse, ma le porte HTTP(S) devono essere utilizzate da Looker per connettersi a ClickHouse.
  • L'amministratore di ClickHouse potrebbe aver scelto porte alternative con le impostazioni http_port o https_port nella configurazione di ClickHouse. Chiedi all'amministratore di ClickHouse le impostazioni appropriate per la tua configurazione.
• Database: nome del database (deve essere uno dei database consentiti nelle autorizzazioni ClickHouse).
• Nome utente: nome utente del database.
• Password: password del database.
• SSL: seleziona questa casella per connetterti a ClickHouse tramite SSL/TLS.
• Verifica SSL: (facoltativo) seleziona questa opzione per applicare la verifica rigorosa del certificato SSL e del nome host sul server ClickHouse. Seleziona Verifica SSL solo se utilizzi un certificato SSL firmato da un'autorità di certificazione generalmente attendibile. Se utilizzi un certificato SSL autofirmato, lascia questa impostazione deselezionata.
• Parametri JDBC aggiuntivi: (facoltativo) parametri aggiuntivi della stringa JDBC. Consulta la sezione Parametri JDBC supportati in questa pagina per l'elenco dei parametri supportati da Looker.

Per verificare che la connessione sia stata stabilita, fai clic sul pulsante Prova connessione nella sezione Dettagli stato in fondo alla pagina Impostazioni di connessione.

Se Looker visualizza Can Connect (È possibile connettersi), premi Connetti per creare la connessione.

La connessione al tuo database viene quindi aggiunta all'elenco della pagina Connessioni Amministrazione di Looker.

Parametri JDBC supportati

Per ClickHouse, Looker supporta i seguenti parametri JDBC nel campo Parametri JDBC aggiuntivi per la connessione. Per informazioni su questi parametri, consulta la documentazione del tuo database.

Parametri di ClickHouse 26+

• async_insert
• autoCommit
• compress
• compress_algorithm
• compress_level
• connect_timeout
• connection_timeout
• continueBatchOnError
• createDatabaseIfNotExist
• custom_settings
• database
• databaseTerm
• externalDatabase
• fetchSize
• format
• jdbcCompliant
• keep_alive_timeout
• max_buffer_size
• max_execution_time
• max_result_bytes
• max_result_rows
• max_threads
• namedParameter
• query_timeout
• receive_timeout
• result_overflow_mode
• retry
• session_check
• session_id
• session_timeout
• session_timezone
• socket_timeout
• ssl
• sslmode
• transactionSupport
• use_server_time_zone
• use_time_zone
• wait_for_async_insert
• wrapperObject

Parametri ClickHouse (legacy)

• beta.row_binary_for_simple_insert
• compress
• connection_timeout
• continueBatchOnError
• createDatabaseIfNotExist
• custom_http_headers
• custom_http_params
• default_query_settings
• disable_frameworks_detection
• jdbc_ignore_unsupported_values
• jdbc_resultset_auto_close
• jdbc_sql_parser
• jdbc_use_max_result_rows
• jdbcCompliance
• max_execution_time
• password
• session_timezone
• socket_timeout
• typeMappings
• use_server_time_zone
• use_time_zone
• user
• wrapperObject

Funzionalità supportate

Affinché Looker supporti alcune funzionalità, anche il dialetto del database deve supportarle.

Supporto delle funzionalità di ClickHouse 26+

A partire da Looker 26.18, ClickHouse 26+ supporta le seguenti funzionalità:

Funzionalità	Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate permanenti basate su SQL
Tabelle derivate permanenti native
Visualizzazioni stabili
Terminazione delle query
Tabelle pivot basate su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Credenziali OAuth 2.0
Commenti contestuali
Pool di connessioni
Schizzi HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimativo dei valori distinti
Modelli analitici in-database
Calendari personalizzati

Supporto delle funzionalità di ClickHouse

A partire da Looker 26.18, ClickHouse supporta le seguenti funzionalità:

Funzionalità	Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate permanenti basate su SQL
Tabelle derivate permanenti native
Visualizzazioni stabili
Terminazione delle query
Tabelle pivot basate su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Credenziali OAuth 2.0
Commenti contestuali
Pool di connessioni
Schizzi HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimativo dei valori distinti
Modelli analitici in-database
Calendari personalizzati

Passaggi successivi

Dopo aver completato la connessione al database, configura le opzioni di autenticazione.