Looker richiede almeno MongoDB versione 4.0+ e MongoDB Connector for 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.
- Utilizzare un connettore MongoDB per BI installato sullo stesso server del database MongoDB.
MongoDB Atlas
Il tuo MongoDB Atlas deve utilizzare un cluster M10+. Affinché Looker possa utilizzare un database MongoDB in esecuzione su MongoDB Atlas, devi utilizzare il MongoDB Connector for BI (MongoBI). L'abilitazione del connettore BI per Atlas richiede che MongoDB Atlas utilizzi un cluster M10+.
Devi anche creare un account utente con 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 utilizzando i seguenti passaggi, illustrati in questa pagina:
- Aggiungi il server Looker all'elenco di accesso IP Atlas
- Attivare il connettore MongoDB per BI
- Consenti l'uso di tabelle derivate normali (opzione consigliata)
Aggiunta del server Looker all'elenco di accesso IP Atlas
Versa 3 consente solo le connessioni client dalle voci dell'elenco di accesso IP del progetto. Aggiungi l'indirizzo IP di Looker all'elenco di accesso IP del progetto Atlas:
- Ottieni l'indirizzo IP di Looker.
- Segui le istruzioni di configurazione dell'elenco di accesso IP di Atlas per aggiungere l'indirizzo IP di Looker all'elenco di accesso IP di Atlas.
Attivazione del connettore MongoDB per BI
Attiva il connettore MongoDB per BI:
- Verifica di essere in un cluster M10+.
- In Atlas, apri la pagina Connetti per il cluster. Prendi nota di nome host, porta e utente. Dovrai utilizzare queste informazioni durante la configurazione della 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 seguenti, illustrati in questa pagina:
- Installazione del connettore Mongo per BI
- Crittografia del traffico di rete
- Configurazione dell'utente e delle autorizzazioni di Looker
- Consentire l'uso di tabelle derivate normali (opzione consigliata)
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 di configurazione di SSL nella pagina della documentazione Configura SSL per BI Connector.
Configurazione dell'utente e delle autorizzazioni di Looker
Nella shell MongoDB, inserisci il comando use
per passare al database a cui si connetterà Looker. Quindi, crea un utente per Looker con il ruolo db.createUser()
con il ruolo readWrite
:
use looker_database
db.createUser({ user: looker,
pwd: `some_password_here`,
roles: [ "readWrite" ]
})
Installazione dei file JDBC 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 inclusi utilizzando i seguenti valori:
Simbolo del conducente: mongobi
Inserimento 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 aggiungere il driver nella directory del dialetto, i percorsi verso questi file saranno simili al 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
Consentire l'uso di tabelle derivate normali (opzione consigliata)
Le tabelle derivate sono strumenti importanti di Looker che ti consentono di espandere la complessità delle analisi. Inoltre, possono contribuire a migliorare il rendimento delle query: A livello generale, la funzionalità di tabella derivata da Looker offre un modo per creare nuove tabelle che non esistono già nel tuo database.
Il connettore MongoDB per BI supporta tabelle derivate regolari temporanee, ma non supporta ancora le tabelle derivate permanenti.
Poiché le tabelle derivate normali sono temporanee, non è necessario archiviarle. Per questo, non c'è bisogno di creare uno schema per loro. Tuttavia, devi concedere il ruolo dbOwner
allo schema looker_tmp
, anche se lo schema non esiste.
Segui la sezione Edit MongoDB Users (Modifica utenti MongoDB) in questa pagina della documentazione di MongoDB per aggiungere il ruolo dbOwner
su looker_tmp
che l'utente dovrà utilizzare per connettersi.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
Aggiungere la connessione
Configura una connessione al database tramite l'interfaccia di Looker. Nella sezione Admin, seleziona Connections (Connessioni) e fai clic su Add Connection (Aggiungi connessione). Per saperne di più, compila i dettagli della connessione (vedi la pagina di connessione di Connessione di Looker al tuo database).
Fai clic su Test These Settings (Prova queste impostazioni) per verificare che la connessione sia riuscita. La pagina della documentazione relativa al test della connettività del database contiene informazioni sulla risoluzione dei problemi.
Utilizzo di funzioni e operatori SQL con MongoDB Connector for BI
Durante lo sviluppo di un connettore MongoDB per la connessione BI, puoi utilizzare le funzioni e gli operatori SQL elencati in questa pagina della documentazione di MongoDB.
Supporto delle funzionalità
Affinché Looker supporti alcune funzionalità, anche il tuo dialetto del database deve supportarle.
Nell'ultima release di Looker, MongoDB supporta le seguenti funzionalità di Looker:
Inoltre:
- MongoDB non supporta periodi di tempo in millisecondi e microsecondi per i gruppi di dimensioni.
- MongoDB non supporta i tipi di millisecondo, millisecondoX e microsecondo per le dimensioni.
- Looker considera tutti i timestamp a cui accede da MongoBI come nel fuso orario UTC (Coordinated Universal Time).
Passaggi successivi
Dopo aver completato la configurazione del database, connettiti al database da Looker.