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

Abilitazione di SQL

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

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

druid.sql.enable=true

Disattivazione dell'approssimazione di COUNT DISTINCT (facoltativo)

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 di Looker al tuo database

Nella sezione Admin (Amministratore) di Looker, seleziona Connections (Connessioni) e poi fai clic su Add Connection (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:

  • Nome: il nome della connessione.

  • Dialetto: Apache Druid, Apache Druid 0.13+ (Apache Druide 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.

  • Port (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 Druid Basic Security. In caso contrario, puoi specificare qualsiasi stringa.

  • Password: la password dell'utente. Se il cluster non è configurato per l'utilizzo di 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. Consulta la sezione Parametri JDBC supportati di questa pagina per l'elenco dei parametri supportati da Looker.

    • 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: controlla se il tuo 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. 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-memorizzazione nella cache di SQL Runner: per fare in modo che SQL Runner non precarichi le informazioni sulle tabelle e le carichi solo quando viene selezionata una tabella, deseleziona questa opzione. Scopri di più su questa impostazione nella documentazione relativa alla pre-cache SQL Runner.

  • Database Time Zone: Fuso orario database. Supportato in Apache Druid 0.13+ e Apache Druid 0.18+.

Per verificare che la connessione sia riuscita, fai clic sul pulsante Test Connection (Verifica connessione) nella sezione Status details (Dettagli stato) in fondo alla pagina Connections Settings (Impostazioni connessioni).

Looker esegue una query SELECT 1 per verificare una connessione di base ed eseguire un test della query. Non convalida l'esistenza della combinazione di catalogo e schema o l'accesso richiesto dell'utente a questo schema.

Se Looker visualizza Can Connect (Connessione possibile), premi Connect (Connetti) per creare la connessione.

La connessione al tuo database viene quindi aggiunta all'elenco della pagina Connections (Connessioni) di Admin (Amministrazione) di Looker.

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.

Parametri JDBC supportati

Per Apache Druid, 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.

  • authentication
  • avatica_password
  • avatica_user
  • serialization
  • sqlTimeZone
  • timeZone
  • useApproximateCountDistinct
  • useApproximateTopN
  • useFallback
  • url

Funzionalità supportate

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

Apache Druid

A partire da Looker 26.22, Apache Druid 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
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
Spiegazione SQL
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli di analisi nel database
Calendari personalizzati

Apache Druid 0.13.x - 0.17.x

Apache Druid 0.13.x - 0.17.x supporta le seguenti funzionalità a partire da Looker 26.22:

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
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
Spiegazione SQL
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli di analisi nel database
Calendari personalizzati

Apache Druid 0.18+

Apache Druid 0.18+ supporta le seguenti funzionalità a partire da Looker 26.22:

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
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
Spiegazione SQL
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli di analisi nel database
Calendari personalizzati

Passaggi successivi

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