MongoDB-Connector für BI

Looker kann über den MongoDB Connector for BI auf MongoDB zugreifen. Dazu gibt es zwei Möglichkeiten:

• Mit dem MongoDB Connector for BI in MongoDB Atlas
• Verwendung eines MongoDB-Connectors für BI, der auf demselben Server wie die MongoDB-Datenbank installiert ist.

MongoDB Atlas

Für Ihren MongoDB Atlas-Cluster muss ein M10+-Cluster verwendet werden. Damit Looker eine MongoDB-Datenbank verwenden kann, die in MongoDB Atlas ausgeführt wird, müssen Sie den MongoDB Connector for BI (MongoBI) verwenden. Wenn Sie den BI Connector für Atlas aktivieren möchten, muss in MongoDB Atlas ein Cluster vom Typ M10 oder höher verwendet werden.

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

MongoDB Connector for BI konfigurieren

Bevor Sie eine Verbindung in Looker erstellen können, muss Ihr MongoDB- oder Atlas-Administrator den MongoDB Connector for BI mit den folgenden Schritten einrichten, die auf dieser Seite beschrieben werden:

• Looker-Server der Atlas-IP-Zugriffsliste hinzufügen
• MongoDB Connector for BI aktivieren
• Verwendung regulärer abgeleiteter Tabellen zulassen (empfohlen)

Looker-Server der Atlas-IP-Zugriffsliste 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. Looker-IP-Adresse abrufen
2. Folgen Sie der Anleitung unter Atlas IP access list setup, um die Looker-IP-Adresse der Atlas-IP-Zugriffsliste hinzuzufügen.

MongoDB Connector for BI aktivieren

Aktivieren Sie den MongoDB Connector for BI:

1. Prüfen Sie, ob Sie einen M10+-Cluster verwenden.
2. Öffnen Sie in Atlas die Seite „Connect“ 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 for BI mit den folgenden Schritten einrichten, die auf dieser Seite beschrieben werden:

• Mongo Connector for BI installieren
• Netzwerk-Datenverkehr 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 for BI auf demselben Server wie die MongoDB-Datenbank. Eine Anleitung dazu finden Sie in der MongoDB-Dokumentation auf der Seite Install BI Connector On Premises .

Netzwerk-Datenverkehr verschlüsseln

Für den MongoDB Connector for BI ist die Verwendung von SSL-Verschlüsselung zwischen dem Server von MongoDB und der Looker-Anwendung erforderlich. 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 zur Datenbank zu wechseln, mit der Looker eine Verbindung herstellt. Erstellen Sie dann einen Nutzer für Looker mit db.createUser() mit der Rolle readWrite:

use looker_database

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

MongoBI-JDBC-Treiberdateien installieren

Für beide Optionen für den MongoDB Connector for BI müssen in Looker JDBC-Treiberdateien konfiguriert werden. Gehen Sie dazu so vor:

Laden Sie diese beiden JAR-Dateien herunter:

• mongosql auth 1.0.0
• mysql connector java 5.1.47

Folgen Sie der Anleitung auf der Dokumentationsseite Unpackaged JDBC drivers (JDBC-Treiber ohne Paket) und verwenden Sie die folgenden Werte:

Treibersymbol: mongobi

Fahrereingabe:

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

Wenn Sie Looker 6.2 oder früher verwenden:

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

Für den Schritt zum Platzieren 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 in Looker wichtige Tools, mit denen Sie Ihre Analysen noch umfassender gestalten können. In einigen Fällen tragen sie außerdem erheblich zur Steigerung der Abfrageleistung bei. Auf höherer Ebene bieten die abgeleiteten Tabellen von Looker die Möglichkeit zur Erstellung neuer Tabellen, die noch nicht in Ihrer Datenbank vorhanden sind.

Der MongoDB Connector for BI unterstützt temporäre reguläre abgeleitete Tabellen, aber 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 „MongoDB-Nutzer ändern“ auf dieser MongoDB-Dokumentationsseite zum Konfigurieren von Datenbanknutzern, um die Rolle dbOwner für looker_tmp 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

So erstellen Sie die Verbindung von Looker zu Ihrer Datenbank:

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ü Dialect (Dialekt) die Option MongoBI aus.

3. Geben Sie die Verbindungsdetails ein. Der Großteil der Einstellungen gilt für die meisten Datenbankdialekte. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.

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

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

SQL-Funktionen und ‑Operatoren mit dem MongoDB Connector for BI verwenden

Wenn Sie eine Verbindung mit dem MongoDB-Connector für BI entwickeln, 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 25.10 die folgenden Funktionen:

Außerdem gilt:

• MongoDB unterstützt keine Zeiträume in Millisekunden und Mikrosekunden für Dimensionsgruppen.
• MongoDB unterstützt die Typen „Millisekunde“, „MillisekundeX“ und „Mikrosekunde“ für Dimensionen nicht.
• In Looker werden alle Zeitstempel, auf die über MongoBI zugegriffen wird, als in der Zeitzone „Coordinated Universal Time“ (UTC) angegeben behandelt.