IBM Cloud Docs
Verbinden mit der MongoDB Shell

Verbinden mit der MongoDB Shell

Sie können über einen Befehlszeilenclient auf Ihre MongoDB-Datenbank zugreifen. Auf diese Weise wird eine direkte Interaktion und Überwachung der in der Datenbank erstellten Datenstrukturen ermöglicht. Mit diesem Programm können Sie Daten abfragen und aktualisieren sowie Verwaltungsoperationen ausführen und die Leistung überwachen.

Installation

Die MongoDB-Shell ist als Teil der MongoDB-Distribution verfügbar. Laden Sie es hierherunter.

Verbindungen herstellen

Verbindungszeichenfolgen werden in der Anzeige Endpunkte der Übersicht Ihrer Bereitstellung angezeigt und können auch vom Cloud Databases-CLI-Plug-in und der API abgerufen werden.

Die Informationen, die die MongoDB-Shell benötigt, um eine Verbindung zu Ihrer Instanz herzustellen, befinden sich im Abschnitt "cli" der Verbindungszeichenfolgen. Die Tabelle enthält eine Aufgliederung zu Referenzzwecken.

mongo/cli Verbindungsinformationen
Feldname Index Beschreibung
Bin Die empfohlene Binärdatei zum Erstellen einer Verbindung. In diesem Fall ist dies mongosh.
Composed Ein formatierter Befehl zum Aufbauen einer Verbindung zu Ihrer Bereitstellung. Der Befehl kombiniert die ausführbare Datei Bin, die Environment-Variableneinstellungen und verwendet
Environment Eine Liste von Schlüsseln/Werten, die Sie als Umgebungsvariablen festlegen.
Arguments 0... Die Informationen, die als Argumente an den im Feld 'Bin' angezeigten Befehl übergeben werden.
Certificate Base64 Ein diensteigenes Zertifikat, das verwendet wird, um zu bestätigen, dass eine Anwendung eine Verbindung zum entsprechenden Server herstellt. Das Zertifikat liegt in Base64-Codierung vor.
Certificate Name Der zugewiesene Name für das diensteigene Zertifikat.
Type Der Typ des Pakets, das diese Verbindungsinformationen verwendet; in diesem Fall cli.
  • 0... Gibt an, dass es möglicherweise weitere derartige Einträge in einem Array gibt.

MongoDB Shell-Beispiel

mongosh -u admin -p $PASSWORD --tls --tlsCAFile c5f07836-d94c-11e8-a2e9-62ec2ed68f84 --authenticationDatabase admin --host replset/bd574ce4-7b36-4274-9976-96db98a3ac10-0.b8a5e798d2d04f2e860e54e5d042c915.databases.appdomain.cloud:30484,bd574ce4-7b36-4274-9976-96db98a3ac10-1.b8a5e798d2d04f2e860e54e5d042c915.databases.appdomain.cloud:30484
  • mongosh- Der Befehl selbst.
  • -u - Der Parameter für den Benutzernamen.
  • -p - Der Parameter für das Kennwort
  • --tls --tlsCAFile- Der Pfad und Name des diensteigenen Zertifikats für Ihre Bereitstellung.
  • --authenticationDatabase - Die Datenbank, in der der Benutzer und die zugehörigen Berechtigungsnachweise erstellt und gespeichert wurden.
  • --host - Der Name der Replikatgruppe (Replica Set) gefolgt von einem Schrägstrich (/) und den Hostnamen der Replikatgruppenmember.

Shell MongoDB über die IBM Cloud-CLI starten

Wenn die MongoDB-Shell lokal installiert ist, können Sie den ibmcloud cdb deployment-connections-Befehl verwenden, um alles zu erledigen, was mit dem Aufbau der Client-Verbindung zu tun hat. Verwenden Sie z. B. zum Herstellen einer Verbindung zu einer Bereitstellung mit dem Namen 'example-mongo' als Benutzer 'example-user' den folgenden Befehl.

ibmcloud cdb deployment-connections --start -u example-user example-mongo

Der Befehl fragt nach dem Passwort des Benutzers und führt dann den Befehlszeilen-Client MongoDB aus, um eine Verbindung zur Datenbank herzustellen.

Die Option --start muss vor den Parametern stehen, sonst werden Verbindungsinformationen zurückgegeben und die MongoDB Shell wird nicht gestartet.

Verwendung des diensteigenen Zertifikats

  1. Kopieren Sie die Zertifikatsinformationen aus der Anzeige Endpunkte oder aus dem Feld Base64 der Verbindungsinformationen.
  2. Decodieren Sie bei Bedarf die Base64-Zeichenfolge in Text.
  3. Speichern Sie das Zertifikat in einer Datei. (Sie können den vorgegebenen Namen übernehmen oder einen eigenen Dateinamen angeben. )
  4. Geben Sie den Pfad zum Zertifikat im Parameter --tlsCAFile an.

Sie können das decodierte Zertifikat für Ihre Bereitstellung mit dem CLI-Plug-in anzeigen, indem Sie den folgenden Befehl verwenden:

ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>

Dadurch werden in Base64 codierte Zeichenfolgen in Text decodiert. Kopieren und speichern Sie die Ausgabe des Befehls in eine Datei und geben Sie den Pfad der Datei im Parameter --tlsCAFile an.