Connettore MongoDB per la BI

Looker può accedere a MongoDB utilizzando il connettore MongoDB per BI in due modi:

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

MongoDB Atlas

MongoDB Atlas deve utilizzare un cluster M10+. Affinché Looker utilizzi un database MongoDB in esecuzione su MongoDB Atlas, devi utilizzare il connettore MongoDB per BI (MongoBI). L'abilitazione di BI Connector 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 di MongoDB o Atlas deve configurare MongoDB Connector for BI seguendo i passaggi riportati di seguito, spiegati in questa pagina:

• Aggiungere il server Looker all'elenco di accesso IP di Atlas
• Attivare MongoDB Connector for BI
• Consenti l'utilizzo di tabelle derivate regolari (opzione consigliata)

Aggiunta del server Looker all'elenco di accesso IP di Atlas

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

Attivazione del connettore MongoDB per BI

Attiva MongoDB Connector for BI:

1. Verifica di trovarti in un cluster M10+.
2. In Atlas, apri la pagina Connect (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 MongoDB deve configurare MongoDB e Mongo Connector for BI seguendo questi passaggi, descritti in questa pagina:

• Installazione di Mongo Connector for BI
• Crittografia del traffico di rete
• Configurazione dell'utente e delle autorizzazioni di Looker
• Consentire l'utilizzo di tabelle derivate regolari (opzione consigliata)

Installazione di Mongo Connector for BI

Installa MongoDB Connector for BI sullo stesso server del database MongoDB, come spiegato nella pagina della documentazione di MongoDB Installare BI Connector on-premise .

Crittografia del 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 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. 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" ]
              })

Installazione dei file del driver JDBC 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:

• mongosql auth 1.0.0
• mysql connector java 5.1.47

Segui i passaggi descritti nella pagina della documentazione Driver JDBC non inclusi nel pacchetto utilizzando i seguenti valori:

Simbolo del conducente: mongobi

driver entry:

- 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 avranno il seguente aspetto:

• 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 (consigliato)

Le tabelle derivate sono strumenti importanti in Looker che ti consentono di ampliare la sofisticatezza delle tue analisi. Possono anche svolgere un ruolo prezioso nel migliorare il rendimento delle query. A livello generale, la funzionalità delle tabelle derivate di Looker consente di creare nuove tabelle che non esistono già nel database.

Il connettore MongoDB per BI supporta le tabelle derivate regolari temporanee, ma non supporta le tabelle derivate permanenti.

Poiché le tabelle derivate regolari sono temporanee, non devono essere archiviate. Pertanto, non è necessario creare uno schema per questi dati. Tuttavia, devi concedere il ruolo dbOwner allo schema looker_tmp, anche se non esiste.

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

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

Creazione della connessione Looker al tuo database

Segui questi passaggi per creare la connessione da Looker al tuo 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 tuo database.

4. Per verificare che la connessione sia riuscita, fai clic su Testa. 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.

Utilizzo di 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 25.10, MongoBI supporta le seguenti funzionalità:

Inoltre:

• MongoDB non supporta intervalli di tempo in millisecondi e microsecondi per i gruppi di dimensioni.
• MongoDB non supporta i tipi millisecondo, millisecondoX e microsecondo per le dimensioni.
• Looker considera tutti i timestamp a cui si accede da MongoBI come appartenenti al fuso orario UTC (Coordinated Universal Time).