Apache Druid

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 ai database.

Configurazione del cluster Apache Druid

<DRUID_BASE_DIR> si riferisce alla directory di base in cui è installato il cluster Apache Druid su un server.

Attivazione di SQL

Per abilitare SQL nel database Druid, aggiungi questa riga al file di configurazione broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

druid.sql.enable=true

(Facoltativo) Disattivare l'approssimazione di COUNT DISTINCT

Per impostazione predefinita, Druid approssima COUNT DISTINCT. Per risultati precisi, aggiungi questa riga al file di configurazione broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

`druid.sql.planner.useApproximateCountDistinct=false`

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:

• Nome: il nome della connessione.

• Dialetto: Apache Druid, Apache Druid 0.13+ (Apache Druid 0.13.x - 0.17.x) o Apache Druid 0.18+.

• Host: DNS o indirizzo IP del broker del cluster. Puoi trovarlo nel file broker/runtime.properties.

• Porta: la porta del broker. La porta predefinita è 8082. Se il cluster è protetto da SSL, la porta predefinita è 8182.

• Database: il nome del tuo database. Il valore predefinito è druid.

• Nome utente: il nome utente del database se il cluster Apache Druid è configurato per utilizzare Druid Basic Security. In caso contrario, puoi specificare qualsiasi stringa.

• Password: la password dell'utente. Se il cluster non è configurato per utilizzare Druid Basic Security, puoi specificare qualsiasi stringa.

• Schema: lo schema predefinito da utilizzare quando non è specificato alcuno schema. L'inserimento di uno schema è facoltativo.

• Parametri JDBC aggiuntivi: parametri JDBC Avatica delimitati da punto e virgola.

  • Queste proprietà possono essere impostate come proprietà di connessione:
    • useApproximateCountDistinct
    • useApproximateTopN
    • useFallback
    • sqlTimeZone

  Esempio: none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

• Pianificazione della manutenzione: un'espressione cron che indica quando Looker deve controllare i gruppi di dati e le tabelle derivate permanenti. Scopri di più su questa impostazione nella documentazione relativa alla pianificazione della manutenzione.

• SSL: verifica che il cluster Apache Druid sia configurato per utilizzare Druid TLS.

• Verifica SSL: seleziona questa opzione per applicare la verifica rigorosa del nome host.

• Numero massimo di connessioni per nodo: il valore predefinito è 25. Inizialmente, questa impostazione può essere lasciata al valore predefinito. Per ulteriori informazioni, consulta la pagina della documentazione Connessione di Looker al tuo database.

• Timeout del pool di connessioni: il valore predefinito è 120 secondi.

• Pre-cache SQL Runner: per impedire a SQL Runner di precaricare le informazioni sulle tabelle e caricarle solo quando una tabella viene selezionata, deseleziona questa opzione. Scopri di più su questa impostazione nella documentazione relativa a SQL Runner Precache.

• Fuso orario database: il fuso orario del database. Supportato in Apache Druid 0.13+ e Apache Druid 0.18+.

Per verificare che la connessione sia riuscita, fai clic su Testa. Per informazioni sulla risoluzione dei problemi, consulta la pagina della documentazione Testare la connettività del database.

Looker esegue una query SELECT 1 per verificare una connessione di base ed eseguire un test della query. Non verifica che la combinazione di catalogo e schema esista o che l'utente disponga dell'accesso richiesto allo schema.

In caso di problemi, consulta la nostra documentazione relativa ai test delle connessioni.

Per salvare queste impostazioni, fai clic su Connetti.

Testa la connessione in SQL Runner. Vai a SQL Runner, seleziona la connessione e lo schema, quindi verifica se riesci a visualizzare le tabelle del database.

Funzionalità supportate

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

Apache Druid

A partire da Looker 25.10, Apache Druid supporta le seguenti funzionalità:

Apache Druid 0.13+ (Apache Druide 0.13.x - 0.17.x)

A partire da Looker 25.10, Apache Druid 0.13+ supporta le seguenti funzionalità:

Apache Druid 0.18+

A partire da Looker 25.10, Apache Druid 0.18+ supporta le seguenti funzionalità:

Passaggi successivi

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