Looker può accedere a MongoDB utilizzando il connettore MongoDB per BI utilizzando due opzioni:
- Utilizzo del connettore MongoDB per la 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 o superiore. Affinché Looker utilizzi un database MongoDB in esecuzione su MongoDB Atlas, devi utilizzare il connettore MongoDB per la BI (MongoBI). L'abilitazione del connettore BI per Atlas richiede che MongoDB Atlas utilizzi un cluster M10 o superiore.
Devi inoltre creare un account utente che disponga delle autorizzazioni di lettura per il database desiderato.
Configurazione del connettore MongoDB per la BI
Prima di creare una connessione in Looker, l'amministratore di MongoDB o Atlas deve configurare il connettore MongoDB per BI utilizzando i seguenti passaggi, spiegati in questa pagina:
- Aggiungere il server Looker all'elenco per gli accessi degli IP Atlas
- Abilitare il connettore MongoDB per BI
- Consenti l'utilizzo di tabelle derivate regolari (opzione consigliata)
Aggiunta del server Looker all'elenco di accesso IP di Atlas
Atlas consente le connessioni dei client solo dalle voci dell'elenco di accesso IP del progetto. Aggiungi l'indirizzo IP di Looker all'elenco per gli accessi IP del progetto Atlas:
- Recupera l'indirizzo IP di Looker.
- Segui le istruzioni per la configurazione 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
Abilitare il connettore MongoDB per BI:
- Verifica di utilizzare un cluster M10 o versioni successive.
- In Atlas, apri la pagina Connetti per il cluster. Prendi nota di nome host, porta e utente. Dovrai utilizzare queste informazioni per configurare la connessione in Looker.
MongoDB sullo stesso server
Prima di creare una connessione in Looker, l'amministratore di MongoDB deve configurare MongoDB e il connettore Mongo per la BI seguendo i passaggi descritti in questa pagina:
- Installazione del connettore Mongo per BI
- Crittografia del traffico di rete
- Configurare l'utente e le autorizzazioni di 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 Installare il connettore BI on-premise Pagina della documentazione di MongoDB.
Crittografia del traffico di rete in corso...
Il connettore MongoDB per la BI richiede l'utilizzo della crittografia SSL tra il server di MongoDB e l'applicazione Looker. Segui le istruzioni di configurazione di SSL nella pagina della documentazione di MongoDB Configurare 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 db.createUser()
con il ruolo readWrite
:
use looker_database
db.createUser({ user: looker,
pwd: `some_password_here`,
roles: [ "readWrite" ]
})
Installazione dei file del driver JDBC MongoBI
Per entrambe le opzioni del connettore MongoDB per la BI, Looker richiede la configurazione dei file del driver JDBC seguendo questi passaggi:
Scarica questi due file JAR:
Segui i passaggi descritti nella pagina della documentazione relativa ai driver JDBC non inclusi nel pacchetto utilizzando i seguenti valori:
simbolo del driver: mongobi
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 il passaggio per inserire il driver nella directory del dialetto, i percorsi di 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'utilizzo di tabelle derivate regolari (opzione consigliata)
Le tabelle derivate sono strumenti importanti di Looker che ti consentono di aumentare la complessità delle tue analisi. Possono anche svolgere un ruolo prezioso nel migliorare le prestazioni delle query. A livello generale, la funzionalità delle tabelle derivate da Looker fornisce 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 le tabelle derivate permanenti.
Poiché le tabelle derivate regolari sono temporanee, non è necessario archiviarle. Pertanto, non è necessario creare uno schema. Tuttavia, devi concedere il ruolo dbOwner
allo schema looker_tmp
, anche se non esiste.
Segui la sezione Modifica utenti MongoDB in questa pagina della documentazione di MongoDB sulla configurazione degli utenti del database per aggiungere il ruolo dbOwner
su looker_tmp
per l'utente che verrà utilizzato da Looker per la connessione.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
Creazione della connessione di Looker al database
Per creare la connessione da Looker al database:
- Nella sezione Amministrazione di Looker, seleziona Connessioni e poi fai clic su Aggiungi connessione.
Seleziona MongoBI dal menu a discesa Dialect.
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 Collegamento di Looker al tuo database.
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.
Per salvare queste impostazioni, fai clic su Connetti.
Utilizzo di funzioni e operatori SQL con MongoDB Connector per BI
Quando sviluppi utilizzando un connettore MongoDB per la connessione BI, puoi utilizzare le funzioni e gli operatori SQL elencati nella documentazione di MongoDB.
Funzionalità supportate
Affinché Looker supporti alcune funzionalità, è necessario che anche il dialetto del tuo database le supporti.
A partire da Looker 24.16, MongoBI supporta le seguenti funzionalità:
Funzionalità | Supportata? |
---|---|
Livello di assistenza | Supportato |
Looker (Google Cloud core) | No |
Aggregati simmetrici | No |
Tabelle derivate | Sì |
Tabelle derivate SQL permanenti | 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 |
Percentile distinto | No |
Processi SQL Runner Show | Sì |
Tabella descrittiva di SQL Runner | Sì |
Indici delle visualizzazioni di SQL Runner | Sì |
Selezione SQL Runner 10 | Sì |
Conteggio di SQL Runner | Sì |
Spiegazione SQL | Sì |
Credenziali OAuth | No |
Commenti contestuali | Sì |
Pool di connessioni | No |
Schizzi HLL | No |
Consapevolezza aggregata | No |
PDT incrementali | No |
Millisecondi | No |
Microsecondi | No |
Viste materializzate | No |
Conteggio approssimato distinto | No |
Inoltre:
- MongoDB non supporta intervalli di millisecondi e microsecondi per i gruppi di dimensioni.
- MongoDB non supporta i tipi millisecondo, millisecondX e microsecondo per le dimensioni.
- Looker tratta tutti i timestamp a cui si accede da MongoBI come appartenenti al fuso orario UTC (Coordinated Universal Time).