Looker kann über den MongoDB-Connector für BI auf MongoDB zugreifen. Dafür gibt es zwei Optionen:
- 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
Ihr MongoDB Atlas muss einen Cluster ab M10 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. Für die Aktivierung des BI-Connectors für Atlas muss MongoDB Atlas einen Cluster ab M10 verwenden.
Sie müssen außerdem ein Nutzerkonto erstellen, das über Leseberechtigungen für die gewünschte Datenbank verfügt.
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, die auf dieser Seite erläutert werden:
- Looker-Server der IP-Zugriffsliste von Atlas hinzufügen
- MongoDB-Connector für BI aktivieren
- Verwendung regulärer abgeleiteter Tabellen zulassen (empfohlen)
Looker-Server zur IP-Zugriffsliste von Atlas hinzufügen
Atlas lässt nur Clientverbindungen aus Einträgen in der IP-Zugriffsliste des Projekts zu. Fügen Sie die Looker-IP-Adresse der IP-Zugriffsliste des Atlas-Projekts hinzu:
- Rufen Sie die Looker-IP-Adresse ab.
- Folgen Sie der Anleitung unter Atlas-IP-Zugriffsliste einrichten, um die Looker-IP-Adresse der Atlas-IP-Zugriffsliste hinzuzufügen.
MongoDB-Connector für BI aktivieren
Aktivieren Sie den MongoDB-Connector für BI:
- Prüfen Sie, ob Sie sich in einem Cluster ab M10 befinden.
- Öffnen Sie in Atlas die Seite „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 für BI mithilfe der folgenden Schritte einrichten, die auf dieser Seite erläutert werden:
- 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 ist die 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 zu der Datenbank zu wechseln, mit der Looker eine Verbindung herstellt. 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
Bei beiden Optionen für MongoDB-Connector für BI muss in Looker die JDBC-Treiberdateien konfiguriert werden. Gehen Sie dazu so vor:
Laden Sie diese beiden JAR-Dateien herunter:
Führen Sie die Schritte auf der Dokumentationsseite für entpackte JDBC-Treiber aus und geben Sie dabei die folgenden Werte an:
Fahrersymbol: mongobi
Fahrereintrag:
- 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
Im Schritt zum Ablegen des Treibers im Verzeichnis Ihres Dialekts sehen die Pfade zu diesen Dateien wie folgt 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 Ihre Analysen noch detaillierter gestalten können. Sie können auch eine wichtige Rolle bei der Verbesserung der Abfrageleistung spielen. Auf übergeordneter Ebene bietet die Funktion für abgeleitete Tabellen von Looker eine 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, jedoch keine nichtflüchtigen abgeleiteten Tabellen.
Da reguläre abgeleitete Tabellen temporär sind, müssen sie nicht gespeichert werden. Daher müssen Sie für sie kein Schema erstellen. Allerdings müssen Sie dem looker_tmp
-Schema die Rolle dbOwner
zuweisen, auch wenn das Schema nicht vorhanden ist.
Folgen Sie dem Abschnitt zum Ändern von MongoDB-Benutzern auf dieser MongoDB-Dokumentationsseite zum Konfigurieren von Datenbanknutzern, um die Rolle dbOwner
für den Nutzer looker_tmp
für den Nutzer hinzuzufügen, den Looker für die Verbindung verwenden wird.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
Looker-Verbindung zu Ihrer Datenbank erstellen
Führen Sie die folgenden Schritte aus, um die Verbindung von Looker zu Ihrer Datenbank zu erstellen:
- Wählen Sie im Bereich Admin von Looker die Option Verbindungen aus und klicken Sie dann auf Verbindung hinzufügen.
Wählen Sie im Drop-down-Menü Dialekt die Option MongoBI aus.
Geben Sie die Verbindungsdetails ein. Die meisten Einstellungen sind den meisten Datenbankdialekten gemeinsam. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.
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.
Klicken Sie auf Verbinden, um diese Einstellungen zu speichern.
SQL-Funktionen und Operatoren mit MongoDB-Connector für BI verwenden
Für die Entwicklung mit einem MongoDB-Connector für eine BI-Verbindung können Sie die SQL-Funktionen und -Operatoren verwenden, die in der MongoDB-Dokumentation aufgeführt sind.
Unterstützte Funktionen
Damit Looker einige Funktionen unterstützen kann, müssen diese auch von Ihrem Datenbankdialekt unterstützt werden.
MongoBI unterstützt ab Looker 24.8 die folgenden Funktionen:
Funktion | Unterstützt? |
---|---|
Supportstufe | Unterstützt |
Looker (Google Cloud Core) | Nein |
Symmetrische Summen | Nein |
Abgeleitete Tabellen | Yes |
Abgeleitete SQL-Tabellen | Nein |
Nichtflüchtige native abgeleitete Tabellen | Nein |
Stabile Ansichten | Nein |
Abfrage beenden | Yes |
SQL-basierte Pivots | Nein |
Zeitzonen | Nein |
SSL | Yes |
Zwischensummen | Nein |
Zusätzliche JDBC-Parameter | Yes |
Groß-/Kleinschreibung beachten | Yes |
Standorttyp | Yes |
Listentyp | Nein |
Perzentil | Nein |
Unterschiedliche Perzentile | Nein |
SQL-Runner-Show-Prozesse | Yes |
SQL-Runner – Tabelle beschreiben | Yes |
SQL Runner – Indexe anzeigen | Yes |
SQL Runner Select 10 | Yes |
Anzahl der SQL-Runner | Yes |
SQL erklären | Yes |
OAuth-Anmeldedaten | Nein |
Kontextkommentare | Yes |
Verbindungs-Pooling | Nein |
HLL-Skizzen | Nein |
Aggregatfunktion | Nein |
Inkrementelle PDTs | Nein |
Millisekunden | Nein |
Mikrosekunden | Nein |
Materialisierte Ansicht | Nein |
Ungefähre Anzahl unterschiedlich | Nein |
Außerdem gilt:
- MongoDB unterstützt keine Millisekunden- und Mikrosekunden-Zeitrahmen für Dimensionsgruppen.
- MongoDB unterstützt keine Dimensionen für Millisekunden, MillisekundeX und Mikrosekunden.
- Looker behandelt alle Zeitstempel, auf die von MongoBI zugegriffen wird, so, als würden sie sich in der koordinierten Weltzeit (UTC) befinden.