MongoDB-Connector für BI

Looker kann über den MongoDB-Connector für BI auf zwei Arten auf MongoDB zugreifen:

  • MongoDB-Connector für BI in MongoDB Atlas
  • Sie verwenden einen MongoDB-Connector für BI, der auf demselben Server wie die MongoDB-Datenbank installiert ist.

MongoDB Atlas

Ihre MongoDB Atlas muss einen M10+-Cluster verwenden. Damit Looker eine MongoDB-Datenbank verwenden kann, die auf MongoDB Atlas ausgeführt wird, müssen Sie den MongoDB-Connector für BI (MongoBI) verwenden. Für die Aktivierung des BI-Connectors für Atlas muss MongoDB Atlas einen M10+-Cluster verwenden.

Außerdem müssen Sie ein Nutzerkonto mit Leseberechtigungen für die gewünschte Datenbank erstellen.

MongoDB-Connector für BI konfigurieren

Bevor Sie eine Verbindung in Looker erstellen, muss Ihr MongoDB- oder Atlas-Administrator den MongoDB-Connector für BI mit den folgenden Schritten einrichten, die auf dieser Seite erläutert werden:

Looker-Server der IP-Zugriffsliste von Atlas hinzufügen

Atlas lässt nur Clientverbindungen von Einträgen in der IP-Zugriffsliste des Projekts zu. Fügen Sie die Looker-IP-Adresse der IP-Zugriffsliste des Atlas-Projekts hinzu:

  1. Rufen Sie die Looker-IP-Adresse ab.
  2. Folgen Sie der Anleitung unter Atlas-IP-Zugriffsliste einrichten, um die Looker-IP-Adresse der Atlas-IP-Zugriffsliste hinzuzufügen.

MongoDB-Connector für BI aktivieren

Aktivieren Sie den MongoDB-Connector für BI:

  1. Prüfen Sie, ob Sie sich in einem M10+ Cluster befinden.
  2. Öffnen Sie in Atlas die Seite "Verbinden" für den Cluster. Notieren Sie sich den Hostnamen, den Port und den Nutzer. Sie benötigen diese Informationen beim Konfigurieren der Verbindung in Looker.

MongoDB auf demselben Server

Bevor Sie eine Verbindung in Looker erstellen, sollte Ihr MongoDB-Administrator MongoDB und den Mongo Connector for BI mit den folgenden Schritten einrichten, die auf dieser Seite erläutert werden:

Mongo-Connector für BI installieren

Installieren Sie den MongoDB-Connector für BI auf demselben Server wie die MongoDB-Datenbank, wie unter BI-Connector lokal installieren MongoDB-Dokumentationsseite.

Netzwerk-Datenverkehr verschlüsseln

Für den MongoDB-Connector für BI ist die SSL-Verschlüsselung zwischen dem MongoDB-Server und der Looker-Anwendung erforderlich. Folgen Sie der Anleitung zur SSL-Einrichtung auf der MongoDB-Dokumentationsseite SSL für BI-Connector konfigurieren.

Looker-Benutzer und -Berechtigungen einrichten

Geben Sie in der MongoDB-Shell den Befehl use ein, um zur Datenbank zu wechseln, mit der Looker eine Verbindung herstellt. Erstellen Sie dann einen Nutzer für Looker mit db.createUser() und der Rolle readWrite:

use looker_database

db.createUser({ user: looker,
                pwd: `some_password_here`,
                roles: [ "readWrite" ]
              })

MongoBI-JDBC-Treiberdateien installieren

Für beide MongoDB Connector for BI-Optionen muss Looker die JDBC-Treiberdateien anhand der folgenden Schritte konfigurieren:

Laden Sie diese beiden JAR-Dateien herunter:

Führen Sie die Schritte auf der Dokumentationsseite Ungepackte JDBC-Treiber mit den folgenden Werten aus:

Fahrersymbol: mongobi

Fahrereintrag:

- name: mongobi
  dir_name: mongobi
  module_path: com.mysql.jdbc.Driver
  override_jdbc_url_subprotocol: mysql

Wenn Sie Looker 6.2 oder älter verwenden:

- name: maria15x
  dir_name: mongobi
  module_path: com.mysql.jdbc.Driver
  override_jdbc_url_subprotocol: mysql

Für den Schritt zum Ablegen des Treibers im Verzeichnis Ihres Dialekts sehen die Pfade zu diesen Dateien so aus:

  • looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jar
  • looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar

Verwendung regulärer abgeleiteter Tabellen zulassen (empfohlen)

Abgeleitete Tabellen sind wichtige Tools in Looker, mit denen Sie Ihre Analysen noch weiter verfeinern können. Sie können auch eine wertvolle Rolle bei der Verbesserung der Abfrageleistung spielen. Auf übergeordneter Ebene bietet die Funktion für abgeleitete Tabellen von Looker die Möglichkeit, neue Tabellen zu erstellen, die noch nicht in Ihrer Datenbank vorhanden sind.

Der MongoDB-Connector für BI unterstützt temporäre reguläre abgeleitete Tabellen, jedoch keine persistenten abgeleiteten Tabellen.

Da reguläre abgeleitete Tabellen temporär sind, müssen sie nicht gespeichert werden. Daher müssen Sie kein Schema für sie erstellen. Sie müssen dem looker_tmp-Schema jedoch die Rolle dbOwner zuweisen, auch wenn dieses Schema nicht vorhanden ist.

Folgen Sie dem Abschnitt zum Ändern von MongoDB-Nutzern auf dieser MongoDB-Dokumentationsseite zum Konfigurieren von Datenbanknutzern, um looker_tmp die Rolle dbOwner für den Nutzer hinzuzufügen, den Looker für die Verbindung verwendet.

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

Looker-Verbindung zu Ihrer Datenbank erstellen

Führen Sie die folgenden Schritte aus, um die Verbindung von Looker zu Ihrer Datenbank herzustellen:

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

  2. Wählen Sie im Drop-down-Menü Dialekt die Option MongoBI aus.

  3. Geben Sie die Verbindungsdetails ein. Die meisten Einstellungen sind den meisten Datenbankdialekten gemeinsam. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.

  4. Klicken Sie auf Testen, um zu prüfen, ob die Verbindung erfolgreich hergestellt wurde. Informationen zur Fehlerbehebung finden Sie auf der Dokumentationsseite Datenbankverbindung testen.

  5. Klicken Sie auf Verbinden, um diese Einstellungen zu speichern.

SQL-Funktionen und Operatoren mit MongoDB Connector for BI verwenden

Bei der Entwicklung mit einem MongoDB-Connector für BI-Verbindung können Sie die in der MongoDB-Dokumentation aufgeführten SQL-Funktionen und -Operatoren verwenden.

Funktionsunterstützung

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

MongoBI unterstützt ab Looker 24.12 die folgenden Funktionen:

Feature Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Nein
Symmetrische Summen
Nein
Abgeleitete Tabellen
Ja
Persistente SQL-Abgeleitete Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Ansichten
Nein
Anfrage wird abgebrochen
Ja
SQL-basierte Drehpunkte
Nein
Zeitzonen
Nein
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Ja
Listentyp
Nein
Perzentil
Nein
Unterschiedliches Perzentil
Nein
SQL Runner – Prozesse anzeigen
Ja
SQL Runner – Tabelle beschreiben
Ja
SQL Runner – Indexe anzeigen
Ja
SQL Runner – Select 10
Ja
Anzahl der SQL-Runner
Ja
SQL Explain
Ja
OAuth-Anmeldedaten
Nein
Kontextkommentare
Ja
Verbindungs-Pooling
Nein
HLL-Skizzen
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Nein
Mikrosekunden
Nein
Materialisierte Ansichten
Nein
Ungefähre Anzahl einzelner
Nein

Außerdem gilt: