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 delle impostazioni di connessione dell'istanza di ClickHouse e 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 e ClickHouse 26+ utilizzando driver JDBC modernizzati e il supporto per l'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 Abilitare l'accesso sicuro al 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 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. 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>

Inoltre, all'interno di 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 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. Alcune delle impostazioni sono descritte di seguito:

• 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 della 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 di 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 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. Per l'elenco dei parametri supportati da Looker, consulta la sezione Parametri JDBC supportati in questa pagina.

Per verificare che la connessione sia andata a buon fine, fai clic sul pulsante Test connessione nella sezione Dettagli stato nella parte inferiore della pagina Impostazioni di connessione.

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

La connessione al database viene quindi 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.

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 di 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.20, ClickHouse 26+ supporta le seguenti funzionalità:

Supporto delle funzionalità di ClickHouse

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

Passaggi successivi

Una volta completata la connessione al database, configura le opzioni di autenticazione.