ClickHouse

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 relativa alle impostazioni globali del server ClickHouse.

Utenti e sicurezza

Per prima cosa, 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>

Configura anche l'accesso al database appropriato all'interno di questo file.

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

Creare la 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 la porta 8123 e le connessioni HTTPS utilizzano la porta 8443.
    • Le porte 9000 e 9440 vengono utilizzate per impostazione predefinita dal client della riga di comando ClickHouse, ma queste porte 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 su Test. Per informazioni sulla risoluzione dei problemi, consulta la pagina della documentazione Testare la connettività del database.

Per salvare queste impostazioni, fai clic su Connetti.

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.6, 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 Conteggio
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
Calendari personalizzati