Connettore MongoDB per la BI

Looker può accedere a MongoDB utilizzando il connettore MongoDB per BI con due opzioni:

  • Utilizzo del connettore MongoDB per la BI in MongoDB Atlas.
  • Utilizzo di un connettore MongoDB per la 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 anche creare un account utente con 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 la BI seguendo i passaggi descritti in questa pagina:

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:

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

Attiva il connettore MongoDB per la BI:

  1. Verifica di utilizzare un cluster M10 o versioni successive.
  2. In Atlas, apri la pagina Connetti per il cluster. Prendi nota del nome host, della porta e dell'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 di Mongo Connector per BI

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

Crittografia del traffico di rete

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 di 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

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 tuo dialetto, i percorsi di questi file saranno i seguenti:

  • 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 importante nel migliorare le prestazioni delle query. A un livello generale, la funzionalità delle tabelle derivate di Looker consente di creare nuove tabelle che non esistono già nel database.

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

Poiché le tabelle derivate regolari sono temporanee, non devono essere archiviate. Di conseguenza, non è necessario creare uno schema per questi elementi. 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:

  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 maggior parte dei dialetti di database. Per informazioni, consulta la pagina della documentazione Connessione di Looker al tuo database.

  4. 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 Testare la connettività del database.

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

Utilizzo di funzioni e operatori SQL con il connettore MongoDB per la 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à, anche il dialetto del database deve supportarle.

MongoBI supporta le seguenti funzionalità a partire da Looker 24.20:

Funzionalità Supportato?
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
Interruzioni delle 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 di visualizzazione di SQL Runner
Sì
Tabella Describe di SQL Runner
Sì
Indici di SQL Runner Show
Sì
SQL Runner Select 10
Sì
Conteggio di SQL Runner
Sì
SQL Explain
Sì
Credenziali OAuth
No
Commenti contestuali
Sì
Pool di connessioni
No
Schizzi HLL
No
Aggregate Awareness
No
PDT incrementali
No
Millisecondi
No
Microsecondi
No
Viste materializzate
No
Conteggio approssimativo valori distinti
No

Inoltre: