MongoSQL

Connetti Looker al tuo cluster MongoSQL direttamente utilizzando il dialetto MongoSQL (basato sull'interfaccia MongoSQL). La connessione di Looker a MongoSQL ti consente di analizzare i dati dei documenti utilizzando query SQL relazionali e di creare dashboard Looker interattive.

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

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 le strutture dei documenti, i campi nidificati e gli 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 sulle raccolte MongoDB.

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

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

Aggiungi 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 su MongoSQL dall'istanza di Looker, devi aggiungere gli indirizzi IP di Looker all'elenco per gli accessi IP di Atlas seguendo questi passaggi:

  1. Ottieni l'elenco degli indirizzi IP di Looker per la regione dell'istanza di Looker.
  2. Aggiungi questi indirizzi IP all'elenco per gli accessi IP del 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 di MongoDB Atlas per creare un account utente del database per Looker seguendo questi passaggi:

  1. Accedi alla console di 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. In Privilegi utente del database, seleziona Ruolo integrato e assegna il ruolo read (o le autorizzazioni di lettura personalizzate) per il database a cui Looker accederà.
  6. Fai clic su Aggiungi utente per salvare le credenziali utente.

Ottieni i parametri di connessione SQL di Atlas

Per creare la connessione Looker, dovrai inserire i parametri di connessione per la connessione SQL di Atlas. Puoi ottenere le informazioni sui parametri seguendo questi passaggi:

  1. Accedi alla console di MongoDB Atlas.
  2. Vai al cluster e fai clic su Connetti.
  3. Seleziona Atlas SQL (o Connetti l'applicazione utilizzando SQL).
  4. Seleziona Driver JDBC.
  5. Prendi nota dei requisiti di host, porta (in genere 27017), database e 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.

    • Nome: inserisci un nome di connessione univoco.
    • 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 (valore predefinito: 27017).
    • Database: nome del database per cui 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, come authSource=admin o connectTimeoutMS=10000. Consulta Parametri JDBC supportati.

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

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

La connessione al tuo database viene aggiunta all'elenco della 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 su 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 effimere (regolari) sono supportate, ma le tabelle derivate permanenti (PDT) non sono supportate.
  • Tipi di dati di data e timestamp: il tipo di dati date non è supportato; la prassi standard consiste nell'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 SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Eliminazione delle query
Tabelle pivot basate su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Maiuscole/minuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Mostra processi
SQL Runner Descrivi tabella
SQL Runner Mostra indici
SQL Runner Seleziona 10
SQL Runner Conteggio
Spiega SQL
Credenziali OAuth 2.0
Commenti di contesto
Pool di connessioni
Schizzi HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli analitici nel database
Calendari personalizzati