Connettore MongoDB per la BI

Migrazione a MongoSQL da MongoBI

Looker ora supporta MongoSQL e consiglia di eseguire la migrazione a MongoSQL dal connettore MongoDB per BI.

A causa delle differenze di sintassi SQL tra MongoDB Connector for BI (MongoBI) e MongoSQL, i modelli LookML esistenti che utilizzano blocchi SQL personalizzati, formattazione delle date o funzioni di database potrebbero richiedere modifiche alla sintassi. Non passare direttamente una connessione di produzione esistente a MongoSQL senza prima convalidare il codice LookML, in quanto ciò può interrompere dashboard, Look, pianificazioni o avvisi.

Per eseguire la migrazione da MongoBI a MongoSQL in modo sicuro, segui questi passaggi:

  1. Consulta le differenze di sintassi SQL tra MongoBI e MongoSQL nella documentazione di MongoDB Transizione da Atlas BI Connector a MongoSQL.
  2. Crea una nuova connessione per MongoSQL in Looker come connessione secondaria.
  3. In un nuovo branch di sviluppo nel tuo progetto LookML, aggiorna il parametro connection nel file del modello in modo che punti alla nuova connessione MongoSQL.
  4. In SQL Runner, testa ed esegui query di esempio dalle tue esplorazioni per verificare la sintassi e i risultati delle query.
  5. Convalida il progetto e i contenuti:
  6. Dopo aver risolto eventuali errori di convalida, esegui il deployment delle modifiche in produzione.

Utilizzo di MongoDB Connector for BI (MongoBI)

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

  • Utilizzando 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 possa utilizzare un database MongoDB in esecuzione su MongoDB Atlas, devi utilizzare MongoDB Connector for BI (MongoBI). Per abilitare il connettore BI per Atlas, MongoDB Atlas deve utilizzare un cluster M10+.

Devi anche creare un account utente con autorizzazioni in lettura per il database scelto.

Configurazione di 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, spiegati in questa pagina:

Aggiunta del server Looker all'elenco per gli accessi IP di Atlas

Atlas consente le connessioni client solo dalle voci nell'elenco per gli accessi 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 per gli accessi IP di Atlas per aggiungere l'indirizzo IP di Looker all'elenco per gli accessi IP di Atlas.

Abilitazione di MongoDB Connector for BI

Attiva MongoDB Connector for BI:

  1. Verifica di utilizzare 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 durante la configurazione della 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, spiegati in questa pagina:

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 Install BI Connector On Premises .

Crittografia del traffico di rete

Il connettore MongoDB per 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 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 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:

Segui i passaggi descritti nella pagina della documentazione dedicata ai 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 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 normali (consigliato)

Le tabelle derivate sono strumenti importanti di Looker che ti consentono di ampliare la sofisticatezza delle tue analisi. Possono anche svolgere un ruolo prezioso nel migliorare le prestazioni delle query. In generale, la funzionalità delle tabelle derivate di Looker consente di creare nuove tabelle che non esistono ancora nel database.

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

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

Segui la sezione Modifica gli 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 Looker utilizzerà per connettersi.

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

Creazione della connessione di Looker al tuo database

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

  1. Nella sezione Admin (Amministratore) di Looker, seleziona Connections (Connessioni) e poi fai clic su Add Connection (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 sul pulsante Test Connection (Verifica connessione) nella sezione Status details (Dettagli stato) in fondo alla pagina Connections Settings (Impostazioni connessioni).

  5. Se Looker visualizza Can Connect (Connessione possibile), premi Connect (Connetti) per creare la connessione.

La connessione al tuo database viene quindi aggiunta all'elenco della pagina Connections (Connessioni) di Admin (Amministrazione) di Looker.

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.

Parametri JDBC supportati

Per MongoDB Connector for BI, Looker supporta i seguenti parametri JDBC nel campo Parametri JDBC aggiuntivi per la connessione. Per informazioni su questi parametri, consulta la documentazione del tuo database.

  • allowMultiQueries
  • appName
  • authSource
  • autoReconnect
  • cachePrepStmts
  • characterEncoding
  • connectTimeout
  • connectTimeoutMS
  • elideSetAutoCommits
  • enabledSslProtocolSuites
  • enabledTLSProtocols
  • explainSlowQueries
  • maxAllowedPacket
  • password
  • queryInterceptors
  • queryTimeoutKillsConnection
  • replicaSet
  • rewriteBatchedStatements
  • socketTimeout
  • ssl
  • sslMode
  • tcpKeepAlive
  • useCompression
  • useCursorFetch
  • useLocalSessionState
  • user
  • useServerPrepStmts
  • useSSL
  • verifyServerCertificate
  • zeroDateTimeBehavior

Funzionalità supportate

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

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

Funzionalità Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Interruzione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
Spiegazione SQL
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli di analisi nel database
Calendari personalizzati

Inoltre: