MongoSQL

Connetti Looker direttamente al tuo cluster MongoSQL 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 di Looker interattive.

Looker include un driver JDBC con licenza Apache-2.0 integrato ufficialmente 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 tue 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 nelle tue 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 l'interfaccia a riga di comando 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 dalla tua istanza di Looker, devi aggiungere i tuoi 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 della tua istanza di Looker.
  2. Aggiungi questi indirizzi IP all'elenco per gli accessi IP del tuo progetto Atlas in base alla documentazione relativa all'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 MongoDB Atlas.
  2. Nel menu di navigazione principale, in Sicurezza, seleziona Accesso al database.
  3. Fai clic su Aggiungi nuovo utente database.
  4. Seleziona Password come metodo di autenticazione. Inserisci un nome utente (ad esempio looker) e una password sicura.
  5. In Database User Privileges (Privilegi utente del database), seleziona Built-in Role (Ruolo integrato) e assegna il ruolo read (o le autorizzazioni in lettura personalizzate) per il database a cui accederà Looker.
  6. Fai clic su Aggiungi utente per salvare le credenziali dell'utente.

Ottieni i parametri di connessione Atlas SQL

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

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

Crea la connessione di Looker al tuo database

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

  1. Nella sezione Admin (Amministratore) di Looker, seleziona Connections (Connessioni) e poi fai clic su Add Connection (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).
    • Port (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: il 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 Test Connection (Verifica connessione).

  4. 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.

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 SQL Schema Builder di Atlas.
  • Tabelle derivate: le tabelle derivate temporanee (normali) sono supportate, ma le tabelle derivate permanenti (PDT) non sono supportate.
  • Tipi di data e timestamp: il tipo di dati date non è supportato; la prassi standard prevede l'archiviazione e la modellazione delle 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.22, 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
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