Druid Apache

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 sul tuo database Druid, aggiungi questa riga al file di configurazione di broker/runtime.properties:

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

druid.sql.enable=true

Disattivazione approssimativa di COUNT DISTINCT (facoltativa)

Per impostazione predefinita, Druid si avvicina a 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 Admin (Amministrazione) di Looker, seleziona Connections (Connessioni) e fai clic su Add Connection (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 delle impostazioni riportate di seguito:

  • Nome: il nome della connessione.
  • Dialect: Apache Druid, Apache Druid 0.13 e versioni successive o Apache Druid 0.18 e versioni successive.
  • Host: DNS o indirizzo IP del cluster Broker. Puoi trovarla nel tuo file broker/runtime.properties.
  • Porta: la porta della Broker. La porta predefinita è 8082. Se il tuo cluster è protetto tramite 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 in modo da utilizzare Druid Basic Security. In caso contrario, puoi specificare qualsiasi stringa.
  • Password: la password dell'utente. Se il cluster non è configurato per l'uso di Druid Basic Security, puoi specificare qualsiasi stringa.
  • Schema: lo schema predefinito da utilizzare quando non è stato specificato alcuno schema. L'inserimento di uno schema è facoltativo.

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

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

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

  • Pianificazione della manutenzione del gruppo di dati e della PDT: un'espressione cron che indica quando Looker deve controllare i gruppi di dati e le tabelle derivate permanenti. Per ulteriori informazioni su questa impostazione, consulta la documentazione relativa alla pianificazione della manutenzione di PDT e gruppi di dati.

  • SSL: controlla se il tuo cluster Apache Druid è configurato per l'utilizzo di 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, puoi lasciare il valore predefinito per questa impostazione. Per ulteriori informazioni, consulta la pagina Documentazione sulla connessione di Looker al tuo database.

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

  • SQL Runner Precache (Pre-cache SQL Runner): per evitare che SQL Runner non precarichi le informazioni delle 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 di SQL Runner.

  • Fuso orario database: 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 Prova. Per informazioni sulla risoluzione dei problemi, consulta la pagina della documentazione Testare la connettività dei database.

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 che l'utente abbia l'accesso richiesto allo schema.

In caso di problemi, consulta la documentazione Testing Connections.

Per salvare queste impostazioni, fai clic su Connetti.

Testa la connessione in SQL Runner. Accedi a SQL Runner, seleziona la connessione e lo schema, quindi controlla se riesci a vedere le tabelle del tuo database.

Assistenza per le funzionalità

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

Druid Apache

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

Funzionalità Supportato?
Livello di assistenza
Richiesta supportata
Looker (Google Cloud core)
No
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate permanenti da SQL
No
Tabelle derivate native permanenti
No
Visualizzazioni stabili
No
Termine 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
Distintivo percentile
No
Processi di visualizzazione di SQL Runner
No
Tabella di descrizione di SQL Runner
No
Indici di SQL Runner
No
SQL Runner Seleziona 10
Sì
Conteggio SQL Runner
Sì
Spiegazione SQL
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pooling della connessione
No
Disegni HLL
No
Aggregate Awareness
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimativo distinto
No

Apache Druid 0.13+

Apache Druid 0.13+ supporta le seguenti funzionalità a partire da Looker 23.8:

Funzionalità Supportato?
Livello di assistenza
Richiesta supportata
Looker (Google Cloud core)
No
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate permanenti da SQL
No
Tabelle derivate native permanenti
No
Visualizzazioni stabili
No
Termine 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
Distintivo percentile
No
Processi di visualizzazione di SQL Runner
No
Tabella di descrizione di SQL Runner
No
Indici di SQL Runner
No
SQL Runner Seleziona 10
Sì
Conteggio SQL Runner
Sì
Spiegazione SQL
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pooling della connessione
No
Disegni HLL
No
Aggregate Awareness
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimativo distinto
No

Apache Druid 0.18+

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

Funzionalità Supportato?
Livello di assistenza
Richiesta supportata
Looker (Google Cloud core)
Sì
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate permanenti da SQL
No
Tabelle derivate native permanenti
No
Visualizzazioni stabili
No
Termine 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
Distintivo percentile
No
Processi di visualizzazione di SQL Runner
No
Tabella di descrizione di SQL Runner
No
Indici di SQL Runner
No
SQL Runner Seleziona 10
Sì
Conteggio SQL Runner
Sì
Spiegazione SQL
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pooling della connessione
No
Disegni HLL
No
Aggregate Awareness
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimativo distinto
No

Passaggi successivi

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