MongoDB-Connector für BI

Für Looker sind mindestens MongoDB 4.0+ und MongoDB-Connector für BI 2.6.0 oder höher erforderlich, da in diesem Fall die Sitzungsvariable type_conversion_mode eingeführt wurde.

Looker kann mit zwei Möglichkeiten auf MongoDB über den MongoDB-Connector für BI zugreifen:

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

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. Wenn Sie den BI-Connector für Atlas aktivieren, 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:

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

Versa 3 erlaubt nur Clientverbindungen aus Einträgen in der IP-Zugriffsliste des Projekts. Fügen Sie die IP-Adresse von Looker der IP-Zugriffsliste des Atlas-Projekts hinzu:

  1. Rufen Sie die IP-Adresse von Looker ab.
  2. Folgen Sie der Anleitung unter Atlas IP-Zugriffsliste einrichten, um der IP-Adresse von Atlas die Looker-IP-Adresse 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, wenn Sie die Verbindung in Looker konfigurieren.

MongoDB auf demselben Server

Bevor Sie eine Verbindung in Looker erstellen, sollte Ihr MongoDB-Administrator MongoDB und den Mongo Connector für BI mithilfe der folgenden Schritte einrichten:

Mongo-Connector für BI installieren

Installieren Sie MongoDB-Connector für BI auf demselben Server wie die MongoDB-Datenbank. Weitere Informationen dazu finden Sie auf der Seite Install BI Connector On Premises in der MongoDB-Dokumentation.

Netzwerk-Datenverkehr verschlüsseln

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

Looker-Nutzer und -Berechtigungen einrichten

Geben Sie in der MongoDB-Shell den Befehl use ein, um zu der Datenbank zu wechseln, zu der Looker eine Verbindung herstellt. Erstellen Sie dann einen Nutzer für Looker mit der Rolle 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-Connectors für BI muss in Looker die JDBC-Treiberdateien konfiguriert werden. Gehen Sie dazu so vor:

Laden Sie diese beiden JAR-Dateien herunter:

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

Fahrersymbol: mongobi

Treiber:

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

Wenn Sie Looker 6.2 oder niedriger verwenden:

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

Wenn Sie den Treiber in das Verzeichnis Ihres Dialekts aufnehmen möchten, sehen Sie folgende Pfade:
looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jar
looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar

Abgeleitete Tabellen sind wichtige Tools in Looker, mit denen Sie die Analysen optimieren können. Außerdem können sie bei der Verbesserung der Abfrageleistung eine wertvolle Rolle spielen. Auf übergeordneter Ebene können Sie mit den abgeleiteten Tabellenfunktionen von Looker neue Tabellen erstellen, die noch nicht in Ihrer Datenbank vorhanden sind.

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

Da reguläre abgeleitete Tabellen nur vorübergehend sind, müssen sie nicht gespeichert werden. Sie müssen daher 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 der Anleitung im Abschnitt „MongoDB-Nutzer ändern“ auf dieser MongoDB-Dokumentationsseite, um die Rolle dbOwner für looker_tmp für den Nutzer hinzuzufügen, den Looker verwenden wird, um eine Verbindung herzustellen.

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

Looker-Verbindung zu Ihrer Datenbank erstellen

Wählen Sie im Abschnitt Admin von Looker die Option Verbindungen aus und klicken Sie auf Verbindung hinzufügen.

Geben Sie die Verbindungsdetails ein. Die meisten Einstellungen gelten für die meisten Datenbankdialekte. Informationen dazu finden Sie in der Dokumentation zum Verbinden von Looker mit Ihrer Datenbank.

Klicken Sie auf Test, um zu prüfen, ob die Verbindung erfolgreich war. Informationen zur Fehlerbehebung finden Sie in der Dokumentation zum Testen der Datenbankverbindung.

Klicken Sie auf Verbinden, um diese Einstellungen zu speichern.

SQL-Funktionen und -Operatoren mit MongoDB-Connector für BI verwenden

Wenn Sie eine MongoDB-Connector für BI-Verbindung entwickeln, können Sie die SQL-Funktionen und -Operatoren verwenden, die auf dieser MongoDB-Dokumentationsseite aufgeführt sind.

Unterstützte Funktionen

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

MongoBI unterstützt ab Looker 23.8 die folgenden Funktionen:

Funktion Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Nein
Symmetrische Summen
Nein
Abgeleitete Tabellen
Ja
Über SQL abgeleitete Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Aufrufe
Nein
Abfrageabbau
Ja
SQL-basierte Pivots
Nein
Zeitzonen
Nein
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Ja
Listentyp
Nein
Perzentil
Nein
Eindeutiges Perzentil
Nein
Prozesse der SQL Runner-Sendung
Ja
SQL-Runner-Beschreibungstabelle
Ja
SQL-Runner-Show-Indizes
Ja
SQL Runner Select 10
Ja
Anzahl der SQL-Runner
Ja
Erläuterung zu SQL
Ja
OAuth-Anmeldedaten
Nein
Kontextkommentare
Ja
Verbindungs-Pooling
Nein
HLL-Sketche
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Nein
Mikrosekunden
Nein
Materialisierte Ansichten
Nein
Ungefähre Anzahl Einzeln
Nein

Außerdem gilt: