Connettore MongoDB per la BI

Looker può accedere a MongoDB utilizzando MongoDB Connector for BI con due opzioni:

  • Utilizzando MongoDB Connector for BI in MongoDB Atlas.
  • Utilizzando un MongoDB Connector for BI installato sullo stesso server del database MongoDB.

MongoDB Atlas

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). Per abilitare BI Connector for Atlas, MongoDB Atlas deve utilizzare un cluster M10+.

Devi anche creare un account utente con autorizzazioni di lettura per il database desiderato.

Configurare MongoDB Connector for BI

Prima di creare una connessione in Looker, l'amministratore di MongoDB o Atlas deve configurare MongoDB Connector for BI seguendo i passaggi riportati di seguito, illustrati in questa pagina:

Aggiungere il server Looker all'elenco per gli accessi IP di Atlas

Atlas consente solo le connessioni client dalle voci nell'elenco di accesso IP del progetto. Aggiungi l'indirizzo IP di Looker all'elenco per gli accessi IP del progetto Atlas:

  1. Recupera l'indirizzo IP di Looker.
  2. 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.

Abilitare MongoDB Connector for BI

Abilita MongoDB Connector for BI:

  1. Verifica di utilizzare un cluster M10+.
  2. In Atlas, apri la pagina Connetti per il cluster. Prendi nota del nome host, della porta e dell'utente. Dovrai utilizzare queste informazioni quando configuri la connessione in Looker.

MongoDB sullo stesso server

Prima di creare una connessione in Looker, l'amministratore di MongoDB deve configurare MongoDB e Mongo Connector for BI seguendo i passaggi riportati di seguito, illustrati in questa pagina:

Installare Mongo Connector for BI

Installa MongoDB Connector for BI sullo stesso server del database MongoDB, come spiegato nella pagina della documentazione di MongoDB Install BI Connector On Premises .

Criptare il traffico di rete

MongoDB Connector for BI richiede l'utilizzo della crittografia SSL tra il server di MongoDB e l'applicazione Looker. Segui le istruzioni di configurazione SSL nella pagina della documentazione di MongoDB Configure SSL for BI Connector.

Configurare l'utente e le autorizzazioni di Looker

Nella shell MongoDB, inserisci il comando use per passare al database a cui si connetterà Looker. Poi, 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" ]
              })

Installare i file del driver JDBC di MongoBI

Per entrambe le opzioni di MongoDB Connector for BI, Looker richiede la configurazione dei file del driver JDBC seguendo questi passaggi:

Scarica questi due file JAR:

Segui i passaggi nella pagina della documentazione relativa ai driver JDBC non inclusi in pacchetti utilizzando i seguenti valori:

Simbolo del driver: mongobi

Voce del driver:

- 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 a questi:

  • 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 in Looker che ti consentono di espandere la sofisticazione delle tue analisi. Possono anche svolgere un ruolo importante nel miglioramento delle prestazioni delle query. A livello generale, la funzionalità delle tabelle derivate di Looker offre un modo per creare nuove tabelle che non esistono già nel database.

MongoDB Connector for BI supporta le tabelle derivate regolari temporanee ma non le tabelle derivate permanenti.

Poiché le tabelle derivate regolari sono temporanee, non è necessario memorizzarle. Pertanto, non devi creare uno schema per queste tabelle. Tuttavia, devi concedere il ruolo dbOwner allo schema looker_tmp, anche se questo schema non esiste.

Segui la sezione Modificare gli utenti MongoDB in questa pagina della documentazione di MongoDB sulla configurazione degli utenti del database per aggiungere il ruolo dbOwner a looker_tmp per l'utente che Looker utilizzerà per la connessione.

db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])

Creare la connessione Looker al database

Segui questi passaggi per creare la connessione da Looker al database:

  1. Nella sezione Amministrazione di Looker, seleziona Connessioni e poi fai clic su Aggiungi connessione.

  2. Seleziona MongoBI dal menu a discesa Dialetto.

  3. Compila i dettagli della connessione. La maggior parte delle impostazioni è comune alla maggioranza dei dialetti di database. Per informazioni, consulta la pagina della documentazione Connessione di Looker al database.

  4. Per verificare che la connessione sia riuscita, fai clic su Test. Per informazioni sulla risoluzione dei problemi, consulta la pagina della documentazione Testare la connettività del database.

  5. Per salvare queste impostazioni, fai clic su Connetti.

Utilizzare funzioni e operatori SQL con MongoDB Connector for BI

Quando sviluppi utilizzando una connessione MongoDB Connector for BI, puoi utilizzare le funzioni e gli operatori SQL elencati nella documentazione di MongoDB.

Funzionalità supportate

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

A partire da Looker 26.2, MongoBI supporta le seguenti funzionalità:

Funzionalità Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Terminazione delle query
Tabelle pivot basate su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Maiuscole/minuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Mostra processi
SQL Runner Descrivi tabella
SQL Runner Mostra indici
SQL Runner Seleziona 10
SQL Runner Conteggio
Spiega SQL
Credenziali OAuth 2.0
Commenti di contesto
Pool di connessioni
Schizzi HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Visualizzazioni materializzate
Misure in base al periodo
Conteggio approssimato valori distinti

Inoltre: