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 creazione di report e l'analisi in Looker, supportando decisioni basate sui dati dirette.

Questa pagina ti guida nella configurazione dell'istanza di ClickHouse e delle impostazioni di connessione di Looker, inclusa la crittografia del traffico di rete, la definizione delle autorizzazioni utente e la revisione delle funzionalità supportate. Looker supporta ClickHouse versione 0.2 o successive.

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 abilitare la crittografia SSL sul lato server, consulta la documentazione Impostazioni server globali di ClickHouse.

Utenti e sicurezza

Innanzitutto, configura l'utente Looker sul server ClickHouse. Gli utenti del database ClickHouse non vengono creati con il comando CREATE USER. Segui la documentazione sui diritti di accesso di ClickHouse per configurare la sezione users nel file users.xml. Ecco un esempio di base:

<!-- 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 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 delle impostazioni:

• Dialetto: ClickHouse.
• Host: nome host raggiungibile.
• Porta: porta su cui il servizio ClickHouse è raggiungibile tramite HTTP(S).
  • Per impostazione predefinita, le connessioni HTTP utilizzano 8123 e HTTPS utilizza 8443.
  • Le porte 9000 e 9440 vengono utilizzate per impostazione predefinita dal client della riga di comando di ClickHouse, ma non possono essere utilizzate da Looker per connettersi a ClickHouse.
  • L'amministratore di ClickHouse potrebbe aver scelto porte alternative con le http_port/https_port impostazioni nella configurazione di ClickHouse. Chiedi all'amministratore di ClickHouse le impostazioni appropriate per la tua configurazione locale.
• Database: nome del database (deve essere uno dei database consentiti nel file users.xml).
• Nome utente: nome utente del database.
• Password: password del database.

• Parametri JDBC aggiuntivi: (facoltativo) parametri aggiuntivi della stringa JDBC. Per l'elenco dei parametri supportati da Looker, consulta la sezione Parametri JDBC supportati in questa pagina.

• Pianificazione manutenzione: ClickHouse non supporta le PDT, quindi questa impostazione può essere ignorata.

• SSL: seleziona questa opzione per connetterti a ClickHouse tramite SSL.

• Verifica SSL: (facoltativo) seleziona questa opzione per applicare la verifica rigorosa del nome host sul server ClickHouse. Seleziona questa opzione solo se utilizzi un certificato SSL firmato da un'autorità di certificazione generalmente attendibile. Se utilizzi un certificato SSL autofirmato, non selezionare questa opzione.

Per verificare che la connessione sia riuscita, fai clic sul pulsante Verifica connessione nella sezione Dettagli stato nella parte inferiore della pagina Impostazioni connessioni.

Se Looker visualizza È possibile connettersi, premi Connetti per creare la connessione.

La connessione al database viene aggiunta all'elenco nella 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.

• 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.

A partire da Looker 26.16, 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
Maiuscole/minuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Mostra processi
SQL Runner Descrivi tabella
SQL Runner Mostra indici
SQL Runner Seleziona 10
SQL Runner Count
Spiega SQL
Credenziali OAuth 2.0
Commenti di contesto
Pool di connessioni
Schizzi HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli analitici nel database
Calendari personalizzati