MongoDB-Connector für BI

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

  • MongoDB Connector for BI in MongoDB Atlas verwenden
  • MongoDB Connector for BI verwenden, der auf demselben Server wie die MongoDB-Datenbank installiert ist

MongoDB Atlas

Für MongoDB Atlas muss ein M10+-Cluster verwendet werden. Wenn Looker eine MongoDB-Datenbank verwenden soll, 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 M10+-Cluster verwendet werden.

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

MongoDB Connector for BI konfigurieren

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

Looker-Server zur 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. Rufen Sie die Looker-IP-Adresse ab.
  2. Folgen Sie der Anleitung zum Einrichten der Atlas-IP-Zugriffsliste, um die Looker-IP-Adresse der Atlas-IP-Zugriffsliste hinzuzufügen.

MongoDB Connector for BI aktivieren

So aktivieren Sie den MongoDB Connector for BI:

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

Mongo Connector for BI installieren

Installieren Sie den MongoDB Connector for BI auf demselben Server wie die MongoDB-Datenbank. Eine Anleitung finden Sie auf der Install BI Connector On Premises MongoDB-Dokumentationsseite.

Netzwerk-Datenverkehr 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 zum Einrichten von SSL auf der Configure SSL for BI Connector MongoDB-Dokumentationsseite.

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 herstellen soll. 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" ]
              })

JDBC-Treiberdateien für MongoBI installieren

Für beide Optionen des MongoDB Connector for BI muss in Looker JDBC-Treiberdateien konfiguriert werden. Gehen Sie dazu so vor:

Laden Sie diese beiden JAR-Dateien herunter:

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

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 eine frühere Version verwenden:

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

Für den Schritt, in dem Sie den Treiber in das Verzeichnis Ihres Dialekts einfügen, 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 wertvollen Beitrag zur Verbesserung der Abfrageleistung leisten. Mit der Funktion für abgeleitete Tabellen in Looker können Sie neue Tabellen erstellen, 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 jedoch die Rolle dbOwner für das Schema looker_tmp gewähren, auch wenn dieses Schema nicht vorhanden ist.

Folgen Sie der Anleitung im Abschnitt Modify MongoDB Users (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 verbinden Sie Looker mit Ihrer Datenbank

  1. Wählen Sie im Bereich Admin von Looker die Option Connections (Verbindungen) aus und klicken Sie dann auf Add Connection (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 ist für die meisten Datenbankdialekte gleich. 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 Datenbankverbindung für vom Kunden gehostete Instanzen testen.

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

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

Wenn Sie mit einer MongoDB Connector for BI-Verbindung entwickeln, können Sie die SQL-Funktionen und -Operatoren verwenden, die in der MongoDB-Dokumentation aufgeführt sind.

Funktionsunterstützung

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

MongoBI unterstützt ab Looker 26.4 die folgenden Funktionen:

Funktion Unterstützt?
Looker (Google Cloud Core)
Symmetrische Aggregate
Abgeleitete Tabellen
Persistente abgeleitete SQL-Tabellen
Persistente native abgeleitete Tabellen
Stabile Ansichten
Abfrageeabruch
SQL-basierte Pivottabellen
Zeitzonen
SSL
Zwischensummen
Zusätzliche JDBC-Parameter
Groß- und Kleinschreibung
Standorttyp
Listentyp
Perzentil
Perzentil der unterschiedlichen Werte
SQL Runner-Befehl – Prozesse anzeigen
SQL-Runner-Funktion – Tabelle beschreiben
SQL Runner-Befehl – Indexe anzeigen
SQL Runner-Befehl – 10 auswählen
SQL-Runner – Anzahl
SQL – Erklären
OAuth 2.0-Anmeldedaten
Kontextkommentare
Verbindungs-Pooling
HLL-Skizzen
Aggregate Awareness
Inkrementelle PDTs
Millisekunden
Mikrosekunden
Materialisierte Ansichten
Vergleich zum vorherigen Zeitraum
Ungefähre Anzahl einzelner Aufrufe

Außerdem gilt: