Druid Apache

Crittografia del traffico di rete in corso...

Una best practice consiste nel criptare il traffico di rete tra l'applicazione Looker e il tuo database. Prendi in considerazione una delle opzioni descritte nella pagina della documentazione Abilitazione dell'accesso sicuro al database.

Configurazione del cluster Apache Druid

<DRUID_BASE_DIR> si riferisce alla directory di base in cui il cluster Apache Druid è installato 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 dell'approssimazione COUNT DISTINCT (facoltativo)

Per impostazione predefinita, Druid approssima 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 Looker al tuo database

Nella sezione Admin (Amministrazione) di Looker, seleziona Connections (Connessioni) e quindi fai clic su Add Connection (Aggiungi connessione).

Compila i dettagli della connessione. La maggior parte delle impostazioni è comune alla maggior parte dei dialetti dei database. Per informazioni, consulta la pagina della documentazione Collegamento di Looker al tuo database. Di seguito sono descritte alcune delle impostazioni:

  • Nome: il nome della connessione.

  • Dialetto: 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 trovarlo nel file broker/runtime.properties.

  • Porta: la porta dell'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 utilizzare Druid Basic Security, puoi specificare qualsiasi stringa.

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

  • Parametri JDBC aggiuntivi: parametri JDBC delimitato da punti 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. Per saperne di più su questa impostazione, consulta la documentazione Pianificazione della manutenzione di PDT e gruppi di dati.

  • SSL: controlla se il 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, è possibile lasciare il valore predefinito per questa impostazione. Per saperne di più, consulta la pagina della documentazione Collegamento di Looker al tuo database.

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

  • SQL Runner Precache: cancella questa opzione per fare in modo che SQL Runner non precarichi le informazioni della tabella e le carichi solo quando ne è selezionata una. Scopri di più su questa impostazione nella documentazione SQL Runner Precache.

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

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 relativa al test della connettività del database.

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

In caso di problemi, consulta la 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 verifica se riesci a visualizzare le tabelle del tuo database.

Supporto delle funzionalità

Affinché Looker supporti alcune funzionalità, è necessario che anche il dialetto del tuo database le supporti.

Druid Apache

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

Selezione delle Supportata?
Livello di assistenza
Supportato
Looker (Google Cloud core)
No
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate da SQL permanente
No
Tabelle derivate native permanenti
No
Viste stabili
No
Eliminazione 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 SQL Runner Show
No
Tabella di descrizione di SQL Runner
No
SQL Runner Mostra indici
No
Selezione SQL Runner 10
Sì
Conteggio runner SQL
Sì
Spiegazione SQL
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pooling di connessioni
No
Schizzi HLL
No
Consapevolezza aggregata
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimato distinto
No

Apache Druid 0.13 o versioni successive

Apache Druid 0.13 e versioni successive supporta le seguenti funzionalità a partire da Looker 24.10:

Selezione delle Supportata?
Livello di assistenza
Supportato
Looker (Google Cloud core)
No
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate da SQL permanente
No
Tabelle derivate native permanenti
No
Viste stabili
No
Eliminazione 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 SQL Runner Show
No
Tabella di descrizione di SQL Runner
No
SQL Runner Mostra indici
No
Selezione SQL Runner 10
Sì
Conteggio runner SQL
Sì
Spiegazione SQL
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pooling di connessioni
No
Schizzi HLL
No
Consapevolezza aggregata
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimato distinto
No

Apache Druid 0.18 o versioni successive

Apache Druid 0.18 e versioni successive supporta le seguenti funzionalità a partire da Looker 24.10:

Selezione delle Supportata?
Livello di assistenza
Supportato
Looker (Google Cloud core)
Sì
Aggregati simmetrici
No
Tabelle derivate
Sì
Tabelle derivate da SQL permanente
No
Tabelle derivate native permanenti
No
Viste stabili
No
Eliminazione 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 SQL Runner Show
No
Tabella di descrizione di SQL Runner
No
SQL Runner Mostra indici
No
Selezione SQL Runner 10
Sì
Conteggio runner SQL
Sì
Spiegazione SQL
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pooling di connessioni
No
Schizzi HLL
No
Consapevolezza aggregata
No
PDT incrementali
No
Millisecondi
Sì
Microsecondi
No
Viste materializzate
No
Conteggio approssimato distinto
No

Passaggi successivi

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