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
- MongoDB-Connector für BI aktivieren
- Verwendung von abgeleiteten Tabellen zulassen (empfohlen)
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:
- IP-Adresse von Looker abrufen
- 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:
- Prüfen Sie, ob Sie sich in einem M10+ Cluster befinden.
- Ö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
- Netzwerkverkehr verschlüsseln
- Looker-Nutzer und -Berechtigungen einrichten
- Verwendung regulärer abgeleiteter Tabellen zulassen (empfohlen)
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
Verwendung regulärer abgeleiteter Tabellen zulassen (empfohlen)
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:
- MongoDB unterstützt keinen Millisekunden- und Mikrosekundenzeitraum für Dimensionsgruppen.
- MongoDB unterstützt keine Millisekunden-, Millisekunden-X- und Mikrosekunden-Typen für Dimensionen.
- Looker behandelt alle Zeitstempel, auf die über MongoBI zugegriffen wird, als in der koordinierten Weltzeitzone (UTC)
Nächste Schritte
Nachdem Sie die Datenbankkonfiguration abgeschlossen haben, stellen Sie über Looker eine Verbindung zur Datenbank her.