Connettore MongoDB per BI

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:

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:

  1. Ottieni 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.

Attivazione del connettore MongoDB per BI

Attiva il connettore MongoDB per BI:

  1. Verifica di essere in un cluster M10+.
  2. 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

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

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:

Passaggi successivi

Dopo aver completato la configurazione del database, connettiti al database da Looker.