MongoDB-Connector für BI

Für Looker sind mindestens MongoDB-Version 4.0 oder höher und MongoDB-Connector für BI Version 2.6.0 oder höher erforderlich (wo die type_conversion_mode-Sitzungsvariable eingeführt wurde).

Looker kann mit zwei Optionen auf 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 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. Wenn Sie den BI-Connector für Atlas aktivieren, muss MongoDB Atlas einen M10+-Cluster verwenden.

Sie müssen auch 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 mithilfe der folgenden Schritte einrichten:

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

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

  1. IP-Adresse von Looker abrufen
  2. Folgen Sie der Anleitung zur Einrichtung der IP-Zugriffsliste von Atlas, um die IP-Adresse von Looker zur IP-Zugriffsliste von Atlas 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 Connect-Seite 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 den MongoDB-Connector für BI auf demselben Server wie die MongoDB-Datenbank, wie auf der MongoDB-Dokumentationsseite BI-Connector lokal installieren erläutert.

Netzwerk-Datenverkehr verschlüsseln

Für den 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 Einrichtung von SSL auf der MongoDB-Dokumentationsseite Configure SSL for BI Connector (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 mit db.createUser() einen Nutzer für Looker mit 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 für BI-Optionen erfordert Looker die Konfiguration der JDBC-Treiberdateien:

Laden Sie diese beiden JAR-Dateien herunter:

Folgen Sie der Anleitung auf der Dokumentationsseite Entpackte JDBC-Treiber mit den folgenden Werten:

Treibersymbol: mongobi

Treibereintrag:

- 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

Wenn Sie den Schritt zum Hinzufügen des Treibers in Ihrem Dialektverzeichnis einrichten möchten, 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

Abgeleitete Tabellen sind wichtige Tools in Looker, mit denen Sie die Analysen Ihrer Analysen erweitern können. Sie können auch eine wertvolle Rolle bei der Verbesserung der Abfrageleistung spielen. Mit den Funktionen der abgeleiteten Tabelle von Looker können Sie 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, jedoch noch keine persistenten abgeleiteten Tabellen.

Da normale 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 Schema looker_tmp jedoch die Rolle dbOwner zuweisen, auch wenn das Schema nicht vorhanden ist.

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

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

Die Verbindung hinzufügen

Konfigurieren Sie eine Datenbankverbindung über die Looker-Oberfläche. Wählen Sie im Abschnitt Admin die Option Connections (Verbindungen) aus und klicken Sie auf Add Connection (Verbindung hinzufügen). Geben Sie die Verbindungsdetails ein. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.

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

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

Bei der Entwicklung mit einer MongoDB-Connector für BI-Verbindung 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.

In der neuesten Version von Looker unterstützt MongoDB die folgenden Looker-Features:

Außerdem gilt:

Nächste Schritte

Nachdem Sie die Datenbankkonfiguration abgeschlossen haben, stellen Sie über Looker eine Verbindung zur Datenbank her.