Looker richiede almeno MongoDB 4.0+ e MongoDB Connector per BI versione 2.6.0+ (dove è stata introdotta la variabile di sessione
type_conversion_mode
).
Looker può accedere a MongoDB utilizzando il connettore MongoDB per BI utilizzando due opzioni:
- Utilizzo del connettore MongoDB per BI in MongoDB Atlas.
- Utilizzo di un connettore MongoDB per BI installato sullo stesso server del database MongoDB.
MongoDB Atlas
MongoDB Atlas deve utilizzare un cluster M10+. Per utilizzare Looker con un database MongoDB su Atlas, devi utilizzare il connettore MongoDB per BI (MongoBI). L'attivazione del connettore BI per Atlas richiede che MongoDB Atlas utilizzi un cluster M10+.
Devi inoltre creare un account utente che disponga delle autorizzazioni di lettura per il database desiderato.
Configurazione del connettore MongoDB per BI
Prima di creare una connessione in Looker, l'amministratore MongoDB o Atlas deve configurare il connettore MongoDB per BI seguendo i passaggi riportati in questa pagina:
- Aggiungi il server Looker all'elenco di accesso IP di Atlas
- Abilita il connettore MongoDB per BI
- Consenti l'utilizzo di tabelle derivate normali (consigliato)
Aggiunta del server Looker all'elenco di accesso IP di Atlas
Atlas consente solo connessioni client da voci nell'elenco di accesso IP del progetto. Aggiungi l'indirizzo IP di Looker all'elenco di accesso IP del progetto Atlas:
- Recupera l'indirizzo IP di Looker.
- Segui le istruzioni dell'elenco di accesso IP di Atlas per aggiungere l'indirizzo IP di Looker all'elenco di accesso IP di Atlas.
Abilitazione del connettore MongoDB per BI
Abilita il connettore MongoDB per BI:
- Verifica di essere in un cluster M10+.
- In Atlas, apri la pagina Connect per il cluster. Prendi nota di nome host, porta e utente. Dovrai utilizzare queste informazioni quando configuri la connessione in Looker.
MongoDB sullo stesso server
Prima di creare una connessione in Looker, l'amministratore MongoDB deve configurare MongoDB e il connettore Mongo per BI seguendo i passaggi riportati in questa pagina:
- Installare il connettore Mongo per BI
- Crittografia del traffico di rete
- Configurazione delle autorizzazioni e dell'utente Looker
- Consentire l'utilizzo di tabelle derivate normali (consigliato)
Installazione del connettore Mongo per BI
Installa il connettore MongoDB per BI sullo stesso server del database MongoDB, come spiegato nella pagina della documentazione relativa all'installazione di BI Connector on Premises .
Crittografia del traffico di rete
Il connettore MongoDB per BI richiede l'utilizzo della crittografia SSL tra il server MongoDB e l'applicazione Looker. Segui le istruzioni per la configurazione SSL nella pagina della documentazione relativa a configurazione di SSL per il connettore SSL per BI.
Configurazione dell'utente e delle autorizzazioni Looker
Nella shell MongoDB, inserisci il comando use
per passare al database a cui Looker si connetterà. Quindi, crea un utente per Looker con il ruolo readWrite
db.createUser()
:
use looker_database
db.createUser({ user: looker,
pwd: `some_password_here`,
roles: [ "readWrite" ]
})
Installazione dei file del driver JDBC di MongoBI
Per entrambe le opzioni di MongoDB Connector per BI, Looker richiede di configurare i file del driver JDBC seguendo questi passaggi:
Scarica questi due file JAR:
Segui i passaggi riportati nella pagina della documentazione Driver JDBC non pacchettizzati utilizzando i seguenti valori:
Simbolo del conducente: mongobi
voce del conducente:
- name: mongobi
dir_name: mongobi
module_path: com.mysql.jdbc.Driver
override_jdbc_url_subprotocol: mysql
Se utilizzi Looker 6.2 o versioni precedenti:
- name: maria15x
dir_name: mongobi
module_path: com.mysql.jdbc.Driver
override_jdbc_url_subprotocol: mysql
Per inserire il driver nella directory del dialetto, il percorso a questi file sarà il seguente:looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jar
looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar
Consentito l'utilizzo di tabelle derivate normali (consigliato)
Le tabelle derivate sono strumenti importanti in Looker che ti consentono di espandere la complessità delle analisi. Possono anche avere un ruolo importante nel miglioramento del rendimento delle query. A livello generale, la funzionalità per le tabelle derivate di Looker consente di creare nuove tabelle che non esistono già nel tuo database.
Il connettore MongoDB per BI supporta le tabelle derivate regolari temporanee, ma non supporta ancora le tabelle derivate persistenti.
Poiché le tabelle derivate normali sono temporanee, non è necessario archiviarle. Pertanto, non è necessario creare uno schema. Tuttavia, devi concedere il ruolo dbOwner
allo schema looker_tmp
, anche se questo schema non esiste.
Segui la sezione Modifica utenti MongoDB su questa pagina della documentazione MongoDB per aggiungere il ruolo dbOwner
su looker_tmp
che l&#Looker utilizzerà per connettersi.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
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.
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.
Per salvare queste impostazioni, fai clic su Connetti.
Utilizzo delle funzioni e degli operatori SQL con MongoDB Connector per BI
Quando si sviluppa con un connettore MongoDB per la connessione BI, è possibile utilizzare le funzioni e gli operatori SQL elencati in questa pagina della documentazione MongoDB.
Assistenza per le funzionalità
Affinché Looker supporti alcune funzionalità, anche il dialetto del tuo database deve supportarle.
In Looker 23.8, MongoBI 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 | Sì |
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 | Sì |
Tabella di descrizione di SQL Runner | Sì |
Indici di SQL Runner | Sì |
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 | No |
Microsecondi | No |
Viste materializzate | No |
Conteggio approssimativo distinto | No |
Inoltre:
- MongoDB non supporta periodi di tempo in millisecondi e microsecondi per i gruppi di dimensioni.
- MongoDB non supporta i tipi millisecond, millisecondX e microseconds per le dimensioni.
- Looker considera tutti i timestamp a cui si accede da MongoBI come nel fuso orario UTC (Coordinated Universal Time).