ClickHouse

Connetti 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 all'interno di 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 ed esaminare le funzionalità supportate. Looker supporta ClickHouse versione 0.2 o successive e ClickHouse 26+ utilizzando driver JDBC modernizzati e il supporto dell'aggregazione simmetrica.

Crittografia del 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 attivare la crittografia SSL sul lato server, consulta la documentazione sulle impostazioni del server globale 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 di ClickHouse per configurare l'accesso utente. L'esempio di base seguente 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>

Inoltre, in questo file, configura l'accesso al database appropriato:

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

Creazione della connessione di Looker al tuo database

Nella sezione Admin (Amministratore) di Looker, seleziona Connections (Connessioni) e poi fai clic su Add Connection (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. Alcune delle impostazioni sono descritte di seguito:

• Dialetto: seleziona ClickHouse 26+ o ClickHouse.
• Host: nome host o indirizzo IP raggiungibile del server ClickHouse.
• Port (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 Looker deve utilizzare le porte HTTP(S) 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 tue autorizzazioni ClickHouse).
• Nome utente: nome utente del database.
• Password: password del database.
• SSL: seleziona questa opzione per connetterti a ClickHouse tramite SSL/TLS.
• Verifica SSL: (facoltativo) seleziona questa opzione per applicare una 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 di questa pagina per l'elenco dei parametri supportati da Looker.

Per verificare che la connessione sia stata stabilita, fai clic sul pulsante Test Connection (Verifica connessione) nella sezione Status details (Dettagli stato) in fondo alla pagina Connection Settings (Impostazioni di connessione).

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

La connessione al tuo database viene aggiunta all'elenco della pagina Connections (Connessioni) di Looker Admin (Amministratore).

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.

ClickHouse 26+ parametri

• 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
• ssl_mode
• 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 di oltre 26 funzionalità di ClickHouse

ClickHouse 26+ supporta le seguenti funzionalità a partire da Looker 26.20:

Funzionalità	Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Interruzione delle query
Pivot basati 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
Spiegazione SQL
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli di analisi nel database
Calendari personalizzati

Supporto delle funzionalità di ClickHouse

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

Funzionalità	Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Interruzione delle query
Pivot basati 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
Spiegazione SQL
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli di analisi nel database
Calendari personalizzati

Passaggi successivi

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