Apache Druid

Crittografia del traffico di rete

È buona prassi criptare il traffico di rete tra l'applicazione Looker e il database. Valuta la possibilità di utilizzare 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 COUNT DISTINCT

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

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

`druid.sql.planner.useApproximateCountDistinct=false`

Creazione della connessione di 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 maggior parte 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+ o Apache Druid 0.18+.

  • Host: indirizzo DNS o 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 database. Il valore predefinito è druid.

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

  • Password: la password dell'utente. Se il cluster non è configurato per utilizzare la sicurezza di base di Druid, 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 separati 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 di PDT e gruppi di dati: 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 di PDT e gruppi di dati.

  • SSL: controlla se il cluster Apache Druid è configurato per utilizzare Druid TLS.

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

  • Numero massimo di connessioni per nodo: il valore predefinito è 25. Questa impostazione può essere lasciata al valore predefinito inizialmente. 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 di caricarle solo quando una tabella è selezionata, deseleziona questa opzione. Scopri di più su questa impostazione nella documentazione di Precache SQL Runner.

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

Per verificare che la connessione sia andata a buon fine, fai clic su Test. 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 di query. Non convalida l'esistenza della combinazione di catalogo e schema o l'accesso richiesto dell'utente a questo schema.

In caso di problemi, consulta la nostra documentazione relativa al 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 controlla se riesci a vedere le tabelle del database.

Funzionalità supportate

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

Apache Druid

Apache Druid supporta le seguenti funzionalità a partire da Looker 24.20:

Funzionalità Supportato?
Livello di assistenza
Supportato
Looker (Google Cloud core)
No
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate SQL permanenti
No
Tabelle derivate native permanenti
No
Visualizzazioni stabili
No
Interruzioni delle query
No
Pivot basati su SQL
No
Fusi orari
No
SSL
Sì
Subtotali
No
Parametri aggiuntivi JDBC
Sì
Sensibilità alle maiuscole
Sì
Tipo di località
Sì
Tipo di elenco
No
Percentile
No
Percentile distinto
No
Processi di visualizzazione di SQL Runner
No
Tabella Describe di SQL Runner
No
Indici di SQL Runner Show
No
SQL Runner Select 10
Sì
Conteggio di SQL Runner
Sì
SQL Explain
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pool di connessioni
No
Schizzi HLL
No
Aggregate Awareness
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimativo valori distinti
No

Apache Druid 0.13 o versioni successive

Apache Druid 0.13 e versioni successive supportano le seguenti funzionalità a partire da Looker 24.20:

Funzionalità Supportato?
Livello di assistenza
Supportato
Looker (Google Cloud core)
No
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate SQL permanenti
No
Tabelle derivate native permanenti
No
Visualizzazioni stabili
No
Interruzioni delle query
No
Pivot basati su SQL
No
Fusi orari
Sì
SSL
Sì
Subtotali
No
Parametri aggiuntivi JDBC
Sì
Sensibilità alle maiuscole
Sì
Tipo di località
No
Tipo di elenco
No
Percentile
No
Percentile distinto
No
Processi di visualizzazione di SQL Runner
No
Tabella Describe di SQL Runner
No
Indici di SQL Runner Show
No
SQL Runner Select 10
Sì
Conteggio di SQL Runner
Sì
SQL Explain
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pool di connessioni
No
Schizzi HLL
No
Aggregate Awareness
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimativo valori distinti
No

Apache Druid 0.18 o versioni successive

Apache Druid 0.18 e versioni successive supportano le seguenti funzionalità a partire da Looker 24.20:

Funzionalità Supportato?
Livello di assistenza
Supportato
Looker (Google Cloud core)
Sì
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate SQL permanenti
No
Tabelle derivate native permanenti
No
Visualizzazioni stabili
No
Interruzioni delle query
No
Pivot basati su SQL
No
Fusi orari
Sì
SSL
Sì
Subtotali
No
Parametri aggiuntivi JDBC
Sì
Sensibilità alle maiuscole
Sì
Tipo di località
Sì
Tipo di elenco
No
Percentile
No
Percentile distinto
No
Processi di visualizzazione di SQL Runner
No
Tabella Describe di SQL Runner
No
Indici di SQL Runner Show
No
SQL Runner Select 10
Sì
Conteggio di SQL Runner
Sì
SQL Explain
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pool di connessioni
No
Schizzi HLL
No
Aggregate Awareness
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimativo valori distinti
No

Passaggi successivi

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