MongoSQL

Collega Looker al cluster MongoSQL direttamente utilizzando il dialetto MongoSQL (basato sull'interfaccia MongoSQL). Il collegamento di Looker a MongoSQL consente di analizzare i dati dei documenti utilizzando query SQL relazionali e creare dashboard interattive di Looker.

Looker include un driver JDBC con licenza Apache 2.0 per l'interfaccia MongoSQL pronto all'uso. A differenza del dialetto MongoBI legacy, non è richiesta l'installazione manuale di file JAR del driver JDBC personalizzati non inclusi nel pacchetto.

Prerequisiti e configurazione di MongoSQL

Prima di creare una connessione in Looker, completa i seguenti passaggi di configurazione in MongoSQL:

Crea uno schema relazionale utilizzando SQL Schema Builder

MongoDB archivia i dati in un formato di documento flessibile e non relazionale (JSON/BSON). Prima che Looker possa eseguire query sulle raccolte MongoDB utilizzando SQL standard, devi utilizzare SQL Schema Builder in MongoSQL per creare uno schema SQL.

L'interfaccia MongoSQL si basa sullo schema relazionale creato da SQL Schema Builder per mappare strutture di documenti, campi nidificati e array a tabelle, righe e colonne SQL standard. Senza uno schema SQL attivo, l'interfaccia SQL non sarà in grado di tradurre le query SQL rispetto alle raccolte MongoDB.

Consulta la documentazione di MongoSQL Schema Builder per definire e pubblicare gli schemi tabellari prima di creare la connessione in Looker.

Per le istanze on-premise di MongoDB Enterprise, utilizza la CLI MongoDB SQL Schema Builder per definire gli schemi.

Aggiungere gli indirizzi IP di Looker all'elenco per gli accessi IP di Atlas

MongoSQL limita le connessioni client agli indirizzi IP autorizzati. Per eseguire query MongoSQL dall'istanza Looker, devi aggiungere gli indirizzi IP di Looker all'elenco per gli accessi IP di Atlas eseguendo i seguenti passaggi:

  1. Ottieni l'elenco degli indirizzi IP di Looker per la regione della tua istanza di Looker.
  2. Aggiungi questi indirizzi IP all'elenco per gli accessi IP del tuo progetto Atlas in base alla documentazione dell'elenco per gli accessi IP di Atlas.

Crea un account utente MongoDB per Looker

Utilizza la console web MongoDB Atlas per creare un account utente del database per Looker seguendo questi passaggi:

  1. Accedi alla console MongoDB Atlas.
  2. Nel menu di navigazione principale, in Sicurezza, seleziona Accesso al database.
  3. Fai clic su Aggiungi nuovo utente del database.
  4. Seleziona Password come metodo di autenticazione. Inserisci un nome utente (ad esempio, looker) e una password sicura.
  5. Nella sezione Privilegi utente del database, seleziona Ruolo integrato e assegna il ruolo read (o autorizzazioni di lettura personalizzate) per il database a cui Looker accederà.
  6. Fai clic su Aggiungi utente per salvare le credenziali dell'utente.

Ottieni i parametri di connessione SQL di Atlas

Per creare la connessione Looker, devi inserire i parametri di connessione per la connessione SQL di Atlas. Per ottenere le informazioni sui parametri:

  1. Accedi alla console MongoDB Atlas.
  2. Vai al cluster e fai clic su Connetti.
  3. Seleziona Atlas SQL (o Collega la tua applicazione utilizzando SQL).
  4. Seleziona Driver JDBC.
  5. Prendi nota di Host, Porta (in genere 27017), Database e requisiti SSL generati. Inserirai questi dettagli quando crei la connessione Looker.

Crea la connessione Looker al tuo database

Segui questi passaggi per stabilire la connessione da Looker a MongoSQL:

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

  2. 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. Alcune delle impostazioni sono descritte di seguito. Utilizza i valori predefiniti in tutti gli altri campi o lasciali vuoti.

    • Name (Nome): inserisci un nome univoco per la connessione.
    • Dialetto: seleziona MongoSQL dal menu a discesa.
    • Host: nome host fornito dall'interfaccia MongoSQL (ad esempio, <cluster-name>.a.query.mongodb.net).
    • Porta: numero di porta per Atlas SQL (impostazione predefinita: 27017).
    • Database: nome del database per il quale hai creato uno schema utilizzando SQL Schema Builder.
    • Nome utente: nome utente del database creato per Looker.
    • Password: password dell'utente del database.
    • SSL: attiva SSL (ssl=true).
    • Parametri JDBC aggiuntivi: (facoltativo) parametri JDBC aggiuntivi supportati dal driver MongoDB, ad esempio authSource=admin o connectTimeoutMS=10000. Consulta Parametri JDBC supportati.

  3. Per verificare la connettività del database, fai clic su Prova connessione.

  4. Se Looker visualizza Connessione possibile, premi Connetti per creare la connessione.

La connessione al database viene quindi aggiunta all'elenco nella pagina Connessioni Amministrazione di Looker.

Parametri JDBC supportati

Per il dialetto MongoSQL, Looker supporta i seguenti parametri JDBC nel campo Parametri JDBC aggiuntivi:

  • appName
  • authSource
  • clientinfo
  • connectTimeoutMS
  • directConnection
  • disableclientcache
  • extjsonmode
  • heartbeatFrequencyMS
  • journal
  • localThresholdMS
  • maxIdleTimeMS
  • maxWaitTimeMS
  • readPreference
  • replicaSet
  • retryReads
  • retryWrites
  • serverSelectionTimeoutMS
  • socketTimeoutMS
  • ssl
  • tls
  • tlsAllowInvalidHostnames
  • tlsInsecure
  • w
  • wtimeoutMS

Limitazioni delle query e comportamento SQL

Quando crei modelli LookML ed esegui query MongoSQL utilizzando l'interfaccia SQL, tieni presente le seguenti caratteristiche del dialetto:

  • Requisito di SQL Schema Builder: come indicato nei prerequisiti, le query SQL richiedono uno schema relazionale preconfigurato definito in Atlas SQL Schema Builder.
  • Tabelle derivate: le tabelle derivate temporanee (regolari) sono supportate, ma le tabelle derivate permanenti (PDT) non lo sono.
  • Tipi di data e timestamp: il tipo di dati date non è supportato; la prassi standard è archiviare e modellare le date come campi timestamp.
  • Fusi orari: tutti i timestamp a cui si accede dall'interfaccia MongoSQL vengono trattati in formato UTC. Looker non converte i fusi orari nel database per le connessioni MongoDB.

Funzionalità supportate

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

A partire da Looker 26.16, MongoSQL supporta le seguenti funzionalità:

Funzionalità Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate permanenti basate su SQL
Tabelle derivate permanenti native
Visualizzazioni stabili
Terminazione delle query
Tabelle pivot basate 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
SQL Explain
Credenziali OAuth 2.0
Commenti contestuali
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimativo dei valori distinti
Modelli analitici in-database
Calendari personalizzati