MongoSQL

Sie können Looker direkt mit Ihrem MongoSQL-Cluster verbinden, indem Sie den MongoSQL-Dialekt verwenden, der von der MongoSQL-Schnittstelle unterstützt wird. Wenn Sie Looker mit MongoSQL verbinden, können Sie Dokumentdaten mit relationalen SQL-Abfragen analysieren und interaktive Looker-Dashboards erstellen.

Looker enthält einen offiziell gebündelten, Apache 2.0-lizenzierten JDBC-Treiber für die MongoSQL-Schnittstelle. Im Gegensatz zum alten MongoBI-Dialekt ist keine manuelle Installation benutzerdefinierter, nicht paketierter JDBC-Treiber-JAR-Dateien erforderlich.

Voraussetzungen und MongoSQL-Konfiguration

Führen Sie vor dem Erstellen einer Verbindung in Looker die folgenden Konfigurationsschritte in MongoSQL aus:

Relationales Schema mit dem SQL Schema Builder erstellen

MongoDB speichert Daten in einem flexiblen, nicht relationalen Dokumentformat (JSON/BSON). Bevor Looker Ihre MongoDB-Sammlungen mit Standard-SQL abfragen kann, müssen Sie mit dem SQL Schema Builder in MongoSQL ein SQL-Schema erstellen.

Die MongoSQL-Schnittstelle basiert auf dem relationalen Schema, das vom SQL Schema Builder erstellt wird, um Dokumentstrukturen, verschachtelte Felder und Arrays Standard-SQL-Tabellen, ‑Zeilen und ‑Spalten zuzuordnen. Ohne ein aktives SQL-Schema kann die SQL-Schnittstelle keine SQL-Abfragen für Ihre MongoDB-Sammlungen übersetzen.

In der Dokumentation zum MongoSQL Schema Builder erfahren Sie, wie Sie Ihre tabellarischen Schemas definieren und veröffentlichen, bevor Sie die Verbindung in Looker erstellen.

Verwenden Sie für lokale MongoDB Enterprise-Instanzen die MongoDB SQL Schema Builder CLI, um Ihre Schemas zu definieren.

Looker-IP-Adressen zur Atlas-IP-Zugriffsliste hinzufügen

MongoSQL beschränkt Clientverbindungen auf autorisierte IP-Adressen. Wenn Sie MongoSQL über Ihre Looker-Instanz abfragen möchten, müssen Sie die IP-Adressen Ihrer Looker-Instanz der Atlas-IP-Zugriffsliste hinzufügen. Führen Sie dazu die folgenden Schritte aus:

  1. Rufen Sie die Liste der Looker-IP-Adressen für die Region Ihrer Looker-Instanz ab.
  2. Fügen Sie diese IP-Adressen der IP-Zugriffsliste Ihres Atlas-Projekts gemäß der Atlas-Dokumentation zur IP-Zugriffsliste hinzu.

MongoDB-Nutzerkonto für Looker erstellen

Erstellen Sie mit der MongoDB Atlas Web Console ein Datenbanknutzerkonto für Looker. Gehen Sie dazu so vor:

  1. Melden Sie sich in der MongoDB Atlas Console an.
  2. Wählen Sie im Hauptnavigationsmenü unter Sicherheit die Option Datenbankzugriff aus.
  3. Klicken Sie auf Neuen Datenbanknutzer hinzufügen.
  4. Wählen Sie Passwort als Authentifizierungsmethode aus. Geben Sie einen Nutzernamen ein, z. B. looker, und ein sicheres Passwort.
  5. Wählen Sie unter Database User Privileges (Berechtigungen des Datenbanknutzers) die Option Built-in Role (Integrierte Rolle) aus und weisen Sie die Rolle read (oder benutzerdefinierte Leseberechtigungen) für die Datenbank zu, auf die Looker zugreifen wird.
  6. Klicken Sie auf Nutzer hinzufügen, um die Nutzeranmeldedaten zu speichern.

Atlas SQL-Verbindungsparameter abrufen

Zum Erstellen der Looker-Verbindung müssen Sie Verbindungsparameter für die Atlas SQL-Verbindung eingeben. So rufen Sie die Parameterinformationen ab:

  1. Melden Sie sich in der MongoDB Atlas Console an.
  2. Rufen Sie Ihren Cluster auf und klicken Sie auf Connect (Verbinden).
  3. Wählen Sie Atlas SQL (oder Connect your application using SQL) aus.
  4. Wählen Sie JDBC-Treiber aus.
  5. Notieren Sie sich den generierten Host, Port (in der Regel 27017), die Datenbank und die SSL-Anforderungen. Sie geben diese Details ein, wenn Sie die Looker-Verbindung erstellen.

Looker-Verbindung zu Ihrer Datenbank erstellen

So stellen Sie die Verbindung von Looker zu MongoSQL her:

  1. Wählen Sie in Looker im Bereich Admin die Option Verbindungen aus und klicken Sie dann auf Verbindung hinzufügen.

  2. Geben Sie die Verbindungsdetails ein. Der Großteil der Einstellungen ist für die meisten Datenbankdialekte gleich. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden. Einige der Einstellungen werden im Folgenden beschrieben. Übernehmen Sie für alle anderen Felder die Standardwerte oder lassen Sie sie leer.

    • Name: Geben Sie einen eindeutigen Verbindungsnamen ein.
    • Dialekt: Wählen Sie im Drop-down-Menü MongoSQL aus.
    • Host: Der vom MongoSQL-Interface bereitgestellte Hostname (z. B. <cluster-name>.a.query.mongodb.net).
    • Port: Portnummer für Atlas SQL (Standard: 27017).
    • Datenbank: Name der Datenbank, für die Sie mit dem SQL Schema Builder ein Schema erstellt haben.
    • Nutzername: Der für Looker erstellte Datenbanknutzername.
    • Passwort: Passwort des Datenbanknutzers.
    • SSL: Aktivieren Sie SSL (ssl=true).
    • Zusätzliche JDBC-Parameter: (Optional) Zusätzliche JDBC-Parameter, die vom MongoDB-Treiber unterstützt werden, z. B. authSource=admin oder connectTimeoutMS=10000. Weitere Informationen finden Sie unter Unterstützte JDBC-Parameter.

  3. Klicken Sie auf Verbindung testen, um die Datenbankverbindung zu prüfen.

  4. Wenn in Looker Can Connect (Kann verbunden werden) angezeigt wird, klicken Sie auf Connect (Verbinden), um die Verbindung herzustellen.

Ihre Datenbankverbindung wird dann der Liste auf der Seite Verbindungen Administrator in Looker hinzugefügt.

Unterstützte JDBC-Parameter

Für den MongoSQL-Dialekt unterstützt Looker die folgenden JDBC-Parameter im Feld Zusätzliche JDBC-Parameter:

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

Einschränkungen bei Abfragen und SQL-Verhalten

Beachten Sie beim Erstellen von LookML-Modellen und beim Abfragen von MongoSQL über die SQL-Schnittstelle die folgenden Dialekteigenschaften:

  • Anforderung für SQL Schema Builder: Wie in den Voraussetzungen beschrieben, benötigen SQL-Abfragen ein vorkonfiguriertes relationales Schema, das in Atlas SQL Schema Builder definiert ist.
  • Abgeleitete Tabellen: Ephemere (reguläre) abgeleitete Tabellen werden unterstützt, persistente abgeleitete Tabellen (PDTs) jedoch nicht unterstützt.
  • Datums- und Zeitstempeltypen: Der Datentyp date wird nicht unterstützt. In der Regel werden Datumsangaben als timestamp-Felder gespeichert und modelliert.
  • Zeitzonen: Alle Zeitstempel, auf die über die MongoSQL-Schnittstelle zugegriffen wird, werden in UTC behandelt. Looker konvertiert Zeitzonen für MongoDB-Verbindungen nicht in der Datenbank.

Funktionsunterstützung

Damit Looker einige Funktionen unterstützen kann, müssen diese auch von Ihrem Datenbankdialekt unterstützt werden.

MongoSQL unterstützt ab Looker 26.16 die folgenden Funktionen:

Funktion Unterstützt?
Looker (Google Cloud Core)
Symmetrische Aggregate
Abgeleitete Tabellen
Persistente abgeleitete SQL-Tabellen
Persistente native abgeleitete Tabellen
Stabile Ansichten
Abfrageeabruch
SQL-basierte Pivottabellen
Zeitzonen
SSL
Zwischensummen
Zusätzliche JDBC-Parameter
Groß- und Kleinschreibung
Standorttyp
Listentyp
Perzentil
Perzentil der unterschiedlichen Werte
SQL Runner-Befehl – Prozesse anzeigen
SQL-Runner-Funktion – Tabelle beschreiben
SQL Runner-Befehl – Indexe anzeigen
SQL-Runner – „Select 10“
SQL-Runner – Anzahl
SQL – Erklären
OAuth 2.0-Anmeldedaten
Kontextkommentare
Verbindungs-Pooling
HLL-Skizzen
Aggregate Awareness
Inkrementelle PDTs
Millisekunden
Mikrosekunden
Materialisierte Ansichten
Vergleich von Zeiträumen
Ungefähre Anzahl einzelner Aufrufe
In-Database-Analysemodelle
Benutzerdefinierte Kalender