Mit MongoDB verbinden
Konzept-Informationen
MongoDB ist ein Cloud-Datendienst. Sie können den MongoDB-Datenkonnektor verwenden, um die in MongoDB gespeicherten Daten Ihrer Organisation zu importieren.
Hinweis
Analytics bietet MongoDB als optionalen Konnektor an. Falls er in Ihrem Fenster „Datenzugriff“ nicht verfügbar ist, wurde er während der Installation wahrscheinlich nicht ausgewählt. Weitere Informationen finden Sie unter Optionale Analytics-Datenkonnektoren und Python Engine installieren.
Vorbereitungen
Für eine Verbindung mit MongoDB müssen Sie die folgenden Informationen einholen:
-
Servername oder IP-Adresse des Servers, der die MongoDB-Datenbank hostet
- korrekter Verbindungsport
- Name der MongoDB-Datenbank
Hilfe für die Zusammenstellung der Verbindungsvoraussetzungen erhalten Sie vom MongoDB-Administrator Ihrer Organisation. Falls Ihr Administrator Ihnen nicht weiterhelfen kann, sollten Sie oder Ihr Administrator den MongoDB-Support kontaktieren.
MongoDB-Verbindung erstellen
- Wählen Sie aus dem Analytics-Hauptmenü Importieren > Datenbank und Anwendung.
- Auf der Registerkarte Neue Verbindungen im Abschnitt ACL-Konnektoren wählen Sie MongoDB.
Tipp
Sie können die Liste verfügbarer Konnektoren filtern, indem Sie in das Feld Verbindungen filtern eine Suchzeichenfolge eingeben. Die Konnektoren sind alphabetisch aufgelistet.
- Im Bereich Datenverbindungseinstellungen rufen Sie die Verbindungseinstellungen auf und klicken unten innerhalb des Bereichs auf Speichern und verbinden.
Sie können den standardmäßigen Verbindungsnamen akzeptieren oder einen neuen Namen eingeben.
Die Verbindung für MongoDB wird in der Registerkarte Bestehende Verbindungen gespeichert. In Zukunft können Sie sich über die gespeicherte Verbindung erneut mit MongoDB verbinden.
Sobald die Verbindung hergestellt ist, wird das Fenster „Datenzugriff“ im Stagingbereich geöffnet und Sie können den Datenimport beginnen. Hilfe für den Datenimport aus MongoDB finden Sie unter Mit dem Fenster „Datenzugriff“ arbeiten.
Verbindungseinstellungen
Grundlegende Einstellungen
| Einstellung | Beschreibung | Beispiel |
|---|---|---|
| Server | Hostname oder IP-Adresse des Servers, der die MongoDB-Datenbank hostet. | |
| Port |
Der TCP-Port, den der MongoDB-Server verwendet, um auf eingehende Client-Verbindungen zu warten. Der Standardwert ist 27017. |
27017 |
| Datenbank | Der Name der MongoDB-Datenbank. | |
| Mit Replikatgruppe verbinden |
Legt fest, ob der Treiber auf Replikatgruppen in Ihrer MongoDB-Implementierung zugreifen kann:
|
Deaktiviert |
| Name der Replikatgruppe | Der Name der Replikatgruppe, auf die der Treiber zugreifen kann. | |
| Sekundäre Server |
Eine durch Kommas getrennte Liste der Server, die für eine Verbindung mit einer Replikatgruppe verwendet werden sollen. Um den TCP-Port anzugeben, über den der Server auf Client-Verbindungen wartet, hängen Sie einen Doppelpunkt (:) und die Portnummer an den Servernamen oder die IP-Adresse an. |
|
| Authentifizierungsmechanismus |
Der Authentifizierungsmechanismus, den MongoDB zur Authentifizierung der Verbindung verwendet:
|
Keine Authentifizierung |
| Dienstname | Der Kerberos-Dienstprinzipalname des MongoDB-Servers. | mongodb |
| Authentifizierungsquelle |
Der Name der MongoDB-Datenbank für die Authentifizierung. Der Wert wird nur benötigt, wenn sich die Authentifizierungsdatenbank von der Datenbank unterscheidet, aus der Daten abgerufen werden. |
admin |
| Benutzername | Der Benutzername für die Authentifizierung an MongoDB. | |
| Kennwort | Das Kennwort für die Authentifizierung an MongoDB. |
Erweiterte Einstellungen
| Einstellung | Beschreibung | Beispiel |
|---|---|---|
| SSL aktivieren | Gibt an, ob der Treiber SSL für Verbindungen mit dem Server verwendet. | Deaktiviert |
| Selbstsigniertes Zertifikat erlauben | Gibt an, ob der Treiber selbstsignierte SSL-Zertifikate des Servers gestattet. | Deaktiviert |
| PEM-Schlüsseldatei | Der vollständige Pfad der .pem-Datei, die das Zertifikat zur Verifizierung des Clients enthält. | |
| PEM-Schlüsselkennwort | Das Kennwort für die Clientzertifikatsdatei, die im Feld „PEM-Schlüsseldatei“ festgelegt wurde. | |
| Datei der Zertifizierungsstelle | Der vollständige Pfad der .pem-Datei, die Sie zur Verifizierung des Servers verwenden. | |
| Verzeichnis für Zertifizierungsstelle | Der vollständige Pfad des Verzeichnisses mit den .pem-Dateien zur Verifizierung des Servers. Diese Einstellung ermöglicht dem Treiber, zur SSL-Verifizierung auf mehrere .pem-Dateien zuzugreifen. | |
| Datei für Zertifikatsperrliste | Der vollständige Pfad der .pem-Datei mit der Liste gesperrter Zertifikate. | |
| Doppelte Pufferung aktivieren |
Legt fest, ob der Treiber die Daten mit doppelter Pufferung abruft. Der MongoDB-Treiber kann doppelte Pufferung verwenden, um die Treiberperformance bei bestimmten SELECT-Operationen zu verbessern. |
Aktiviert |
| Zeichenfolgen als SQL_WVARCHAR verfügbar machen |
Legt fest, ob der Zeichenfolge-Datentyp SQL_WVARCHAR oder SQL_VARCHAR zugeordnet wird. |
Aktiviert |
| Binäre Werte als SQL_LONGVARBINARY verfügbar machen | Gibt an, ob der Treiber binäre Spalten als Datentyp SQL_LONGVARBINARY oder SQL_VARBINARY zurückgibt. | Aktiviert |
| Passdown aktivieren | Legt fest, ob der Treiber Zusammenführungen zwischen virtuellen Tabellen optimiert und Filter- sowie Aggregationsoptimierungen der MongoDB-Datenbank überlässt. | Aktiviert |
| Pro Block abzurufende Dokumente |
Maximale Anzahl von Dokumenten, die eine Abfrage auf einmal zurückgibt. Die Einstellung legt auch die Puffergröße fest, die bei einer Aktivierung der doppelten Pufferung verwendet wird. Der Standardwert ist 4096. |
4096 |
| Größe von Zeichenfolgenspalte |
Maximale Zeichenanzahl, die STRING-Spalten enthalten dürfen. Der Standardwert ist 255. |
255 |
| Größe binärer Spalte |
Die maximale Datenlänge binärer Spalten. Der Standardwert ist 32767. |
32767 |
| Metadatenmechanismus |
Gibt an, wo der Treiber nach der Schemadefinition sucht:
|
Datenbank |
| Lokale Datei | Der vollständige Pfad zu einer lokalen JSON-Datei mit der Schemadefinition, die der Treiber bei der Verbindung mit MongoDB verwenden soll. | |
| Stichprobenverfahren |
Legt fest, wie der Treiber Daten abfragt, falls er eine temporäre Schemadefinition erstellt:
|
Vorwärts |
| Dokumente für Stichprobe (0 für alle Dokumente) |
Maximale Anzahl der Datensätze, die der Treiber abfragen kann, um eine temporäre Schemadefinition zu erstellen. Falls diese Option auf „0“ festgelegt wurde, fragt der Treiber jedes Dokument in der Datenbank ab. Der Standardwert ist 100. |
100 |
| Schrittgröße für Stichprobe |
Das Intervall, in dem der Treiber die Datensatz-Stichprobe durchführt, wenn er die Datenbank abfragt und eine temporäre Schemadefinition erstellt. Falls diese Option beispielsweise auf „2“ festgelegt wurde, fragt der Treiber jeden zweiten Datensatz in der Datenbank ab. Der Standardwert ist „1“. |
1 |
| Batchgröße für Rückschreiben (1-1000) |
Die maximale Anzahl an Dokumenten, die der Treiber mit einer einzigen Schreiboperation handhaben kann. Der Standardwert ist „500“. |
500 |
| Write Concern |
Gesamtanzahl primärer und sekundärer Server, die eine Schreiboperation bestätigen müssen, damit der Treiber eine erfolgreiche Schreiboperation meldet. Falls diese Option auf „0“ festgelegt wurde, müssen Schreiboperationen des Treibers nicht bestätigt werden. Der Standardwert ist „1“. |
1 |
| Write-Concern-Zeitüberschreitung |
Maximale Anzahl an Sekunden, die der Treiber auf die Bestätigung der Schreiboperation durch den sekundären Server wartet, bis er die Operation als gescheitert meldet. Falls diese Option auf „0“ festgelegt wurde, gibt es keine Zeitüberschreitungen des Treibers. Stattdessen wartet der Treiber, bis alle sekundären Server die Schreiboperation bestätigen. Dann meldet er, dass die Operation erfolgreich war. Der Standardwert ist „0“. |
0 |
| Im Journal erfasste Write-Concern-Schreibzugriffe | Legt fest, ob der Treiber verlangt, dass die Daten einer Schreiboperation in das Journal übermittelt werden, bevor die Schreiboperation bestätigt wird. | Deaktiviert |
Updates von Datenkonnektoren
Wenn Sie Analytics, oder den Robots-Agent aktualisieren, sollten Sie Ihre Skripts für Datenimporte mit einem der Analytics-Datenkonnektoren (Befehl ACCESSDATA) testen.
Es besteht die Möglichkeit, dass Änderungen eines Drittanbieters von Datenquellen oder eines Herstellers von ODBC-Treibern Aktualisierungen eines oder mehrerer Datenkonnektoren erfordert. Über Skripts hergestellte Datenverbindungen müssen unter Umständen aktualisiert werden, um nach wie vor ordnungsgemäß zu arbeiten.
- Import erneut durchführen Die einfachste Möglichkeit, eine Verbindung zu aktualisieren, ist die manuelle Durchführung eines Imports mit dem Fenster „Datenzugriff“ der aktualisierten Version von Analytics. Kopieren Sie den Befehl ACCESSDATA aus dem Protokoll, und verwenden Sie ihn zur Aktualisierung Ihres Skripts.
Hinweis
Bevor Sie sich mit einer Datenquelle verbinden und den Import erneut ausführen, löschen Sie den Cache des Konnektors, um bestehende Tabellennamen zu entfernen.
In der Registerkarte Bestehende Verbindungen des Fensters „Datenzugriff“ wählen Sie
> Cache löschen. - Feldspezifikationen aktualisieren Unter Umständen müssen Sie auch Feldspezifikationen im Skriptkörper aktualisieren, um die Änderungen des Tabellenschemas in der Datenquelle oder dem ODBC-Treiber anzupassen. Mögliche Änderungen beinhalten Feldnamen, Datentypen von Feldern sowie Feld- und Datensatzlängen.
- Ergebnisse von Filtern überprüfen Sie sollten auch Ergebnisse von Filtern überprüfen, die Sie im Rahmen des Datenimports nutzen. Stellen Sie sicher, dass der Importfilter Datensätze ordnungsgemäß ein- und ausschließt.
Änderungen des MongoDB-Datenkonnektors
Spezifische Änderungen des MongoDB-Datenkonnektors sind im Folgenden aufgelistet.
| Analytics-Version | Änderung |
|---|---|
|
14.2 |
Der Konnektor unterstützt keine Verbindungen zu MongoDB 3.0 und 3.2 mehr. Verbindungen können mit MongoDB 3.4, 3.6 und 4.0 aufgenommen werden. |
