MongoDB-Connector für BI

Looker kann über den MongoDB-Connector für BI auf MongoDB zugreifen. Dabei stehen zwei Optionen zur Verfügung:

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

MongoDB Atlas

Für MongoDB Atlas muss ein M10-Cluster oder höher verwendet werden. Damit Looker eine MongoDB-Datenbank verwenden kann, die auf 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 M10-Cluster verwendet werden.

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 können, muss Ihr MongoDB- oder Atlas-Administrator den MongoDB-Connector für BI mithilfe der folgenden Schritte einrichten, die auf dieser Seite erläutert werden:

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

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

  1. Ermitteln Sie die Looker-IP-Adresse.
  2. Folgen Sie der Anleitung unter Atlas-IP-Zugriffsliste einrichten, um die Looker-IP-Adresse zur 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 „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, muss Ihr MongoDB-Administrator MongoDB und den Mongo-Connector für BI mithilfe der folgenden Schritte 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 auf der MongoDB-Dokumentationsseite Install BI Connector On Premises (BI-Connector lokal installieren) beschrieben.

Netzwerkverkehr verschlüsseln

Für den MongoDB Connector for BI ist die Verwendung der 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-Nutzer und -Berechtigungen einrichten

Geben Sie in der MongoDB-Shell den Befehl use ein, um zur Datenbank zu wechseln, zu der Looker eine Verbindung herstellen soll. 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 Optionen des MongoDB-Connectors für BI müssen Sie JDBC-Treiberdateien in Looker konfigurieren. Gehen Sie dazu so vor:

Laden Sie die folgenden beiden JAR-Dateien herunter:

Folgen Sie der Anleitung auf der Dokumentationsseite Unverpackte JDBC-Treiber und verwenden Sie dabei die folgenden Werte:

Fahrersymbol: mongobi

driver entry:

- 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

Für den Schritt zum Platzieren des Treibers im Verzeichnis Ihres Dialects 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. Sie können auch einen wichtigen Beitrag zur Steigerung der Abfrageleistung leisten. Die Funktion für abgeleitete Tabellen in Looker bietet 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, aber keine persistenten abgeleiteten Tabellen.

Da reguläre abgeleitete Tabellen temporär sind, müssen sie nicht gespeichert werden. Sie müssen also kein Schema für sie erstellen. Sie müssen der Rolle dbOwner jedoch die Berechtigung looker_tmp für das Schema erteilen, auch wenn dieses Schema noch nicht vorhanden ist.

Folgen Sie dem Abschnitt „MongoDB-Nutzer ändern“ auf dieser MongoDB-Dokumentationsseite zur Konfiguration von Datenbanknutzern, um dem Nutzer, über den Looker eine Verbindung herstellen soll, die Rolle dbOwner für looker_tmp hinzuzufügen.

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 Verwaltung 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. 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 Testen, 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 für BI verwenden

Wenn Sie einen MongoDB-Connector für eine BI-Verbindung verwenden, 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.0 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
Abfrage beenden
Ja
SQL-basierte Pivot-Tabellen
Nein
Zeitzonen
Nein
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Ja
Listentyp
Nein
Perzentil
Nein
Perzentil der unterschiedlichen Werte
Nein
SQL Runner-Prozesse anzeigen
Ja
SQL Runner Describe Table
Ja
SQL Runner-Indexe für Serien
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 Aufrufe
Nein

Außerdem gilt: