Einführung in Databases for MongoDB

Dieses Tutorial führt Sie durch die Schritte für einen schnellen Start mit Databases for MongoDB, indem Sie eine Instanz bereitstellen, Ihr Admin-Passwort festlegen, sich mit ihr verbinden und ein einfaches Dokument schreiben und lesen.

Befolgen Sie diese Schritte, um das Lernprogramm abzuschließen:

Befolgen Sie diese Schritte, um das Lernprogramm abzuschließen:

Befolgen Sie diese Schritte, um das Lernprogramm abzuschließen:

Befolgen Sie diese Schritte, um das Lernprogramm abzuschließen:

Vorbereitende Schritte

Schritt 1: Wählen Sie Ihren Plan

Databases for MongoDB bietet zwei verschiedene Pläne:

  • Databases for MongoDB Standard ist ein vollständig verwalteter NoSQL-Datenbankdienst auf Basis der MongoDB Community Edition.

  • Databases for MongoDB Enterprise bietet erweiterte Funktionen, wie die MongoDB Ops Manager und Point-in-Time-Recovery.

APIs verwenden

Verwenden Sie die API vonCloud Databases, um mit Ihrer Databases for MongoDB-Instanz zu arbeiten. Die Ressourcencontroller-API wird verwendet, um eine Instanz bereitzustellen.

Sie benötigen einen API-Schlüssel, um Aktionen über die API durchzuführen. Führen Sie diese Schritte aus, um einen IBM Cloud-API-Schlüssel zu erstellen, mit dem Sie die API zur Bereitstellung von Infrastruktur in Ihrem Konto verwenden können. Sie können bis zu 20 API-Schlüssel erstellen.

Aus Sicherheitsgründen kann der API-Schlüssel nur zum Zeitpunkt seiner Erstellung kopiert oder heruntergeladen werden. Wenn der API-Schlüssel verloren geht, müssen Sie einen neuen API-Schlüssel erzeugen.

Schritt 2: Bereitstellung über die Konsole

  1. Melden Sie sich bei der IBM Cloud-Konsole an.
  2. Klicken Sie auf den Databases for MongoDB Dienst im Katalog.
  3. Befolgen Sie diese Schritte, um eine Databases for MongoDB-Instanz bereitzustellen.
  4. Wenn Ihre Instanz bereitgestellt ist, klicken Sie auf den Instanznamen, um weitere Informationen anzuzeigen.

Schritt 2: Bereitstellung über die Befehlszeilenschnittstelle

Sie können eine Databases for MongoDB-Instanz über die Befehlszeilenschnittstelle bereitstellen. Wenn Sie es noch nicht haben, müssen Sie die IBM Cloud-CLIinstallieren.

Sie können diese Schritte ausführen, um eine Databases for MongoDB-Instanz bereitzustellen.

Schritt 2: Bereitstellung über die Ressourcencontroller-API

Führen Sie diese Schritte aus, um eine Databases for MongoDB-Instanz mit der Resource Controller API bereitzustellen.

Schritt 2: Bereitstellung über Terraform

Sie benötigen einen API-Schlüssel, um Aktionen über Terraform durchzuführen. Folgen Sie diesen Schritten, um einen IBM Cloud API-Schlüssel zu erstellen, der es Terraform ermöglicht, die Infrastruktur in Ihrem Konto bereitzustellen. Sie können bis zu 20 API-Schlüssel erstellen.

Aus Sicherheitsgründen kann der API-Schlüssel nur zum Zeitpunkt seiner Erstellung kopiert oder heruntergeladen werden. Wenn der API-Schlüssel verloren geht, müssen Sie einen neuen API-Schlüssel erzeugen.

Sobald Sie einen API-Schlüssel haben, folgen Sie diesen Schritten, um eine Databases for MongoDB-Instanz mit Terraform bereitzustellen.

Schritt 3: Festlegen des Admin-Passworts

Benutzer mit Administratorberechtigung

Wenn Sie einen Databases for MongoDB Einsatz bereitstellen, wird automatisch ein admin Benutzer erstellt.

Legen Sie das Administratorkennwort fest, bevor Sie es für die Verbindung verwenden.

Festlegen des Admin-Passworts über die Benutzeroberfläche

Legen Sie Ihr Admin-Passwort über die Benutzeroberfläche fest, indem Sie Ihre Instanz aus der IBM Cloud Ressourcenliste auswählen. Wählen Sie anschließend Einstellungen aus. Wählen Sie dann Datenbankadministratorkennwort ändernaus.

Setzen Sie das Admin-Passwort über die CLI

Verwenden Sie den Befehl cdb user-password aus dem Plug-in IBM Cloud der Befehlszeilenschnittstelle Cloud Databases, um das Administratorkennwort festzulegen.

Um beispielsweise das Administratorkennwort für Ihre Bereitstellung festzulegen, verwenden Sie den folgenden Befehl:

ibmcloud cdb user-password <INSTANCE_NAME_OR_CRN> admin <NEWPASSWORD>

Festlegen des Admin-Kennworts über die API

Sie können den Parameter id, den Sie in der Antwort auf Schritt 2 oben erhalten haben, mit dem Endpunkt Passwort des angegebenen Benutzers festlegen verwenden, um das Administratorkennwort festzulegen.

curl -X PATCH -H "Authorization: Bearer <TOKEN>" \
     -H 'Content-Type: application/json' \
     -d '{"password":"newrootpasswordsupersecure21"}' \
      "https://api.<REGION>.databases.cloud.ibm.com/v5/ibm/deployments/<DEPLOYMENT_ID>/users/database/admin"

Der Parameter id muss URL-kodiert sein, damit der obige API-Aufruf funktioniert.

Festlegen des Admin-Passworts über Terraform

Das Admin-Passwort wird als einer der Datenbank-Ressourcenparameter im Terraform-Skript übergeben. Es besteht kein weiterer Handlungsbedarf.

Schritt 4: Verbinden Sie sich mit Ihrer Databases for MongoDB-Instanz

Sie können sich ganz einfach mit Ihrer Instanz verbinden, indem Sie entweder die Mongo Shell (eine Befehlszeilenschnittstelle) oder Mongo Compass, eine leistungsstarke grafische Benutzeroberfläche zur Abfrage und Analyse Ihrer Daten, verwenden. Beide Tools werden von MongoDB bereitgestellt.

Verwendung der Mongo-Shell

Folgen Sie diesen Anweisungen, um die Mongo Shell herunterzuladen und sich mit ihr zu verbinden.

Sie können dann Ihre Bereitstellung testen, indem Sie ein Dokument in eine Sammlung einfügen:

use sample_mflix

db.movies.insertOne(
  {
    title: "The Favourite",
    genres: [ "Drama", "History" ],
    runtime: 121,
    rated: "R",
    year: 2018,
    directors: [ "Yorgos Lanthimos" ],
    cast: [ "Olivia Colman", "Emma Stone", "Rachel Weisz" ],
    type: "movie"
  }
)

Der obige Befehl wechselt zu einer Datenbank mit dem Namen sample_mflix (und erstellt sie, wenn sie noch nicht existiert), und fügt dann ein Dokument in die Sammlung movies ein (die ebenfalls erstellt wird, wenn sie noch nicht existiert).

Sie können das Dokument dann mit abrufen:

db.movies.find( { title: "The Favourite" } )

Sie haben nun eine Verbindung zu Ihrer Datenbank hergestellt und mit der Mongo Shell Daten geschrieben und gelesen.

MongoDB Compass verwenden

Folgen Sie dieser Anleitung, um MongoDB Compass herunterzuladen und sich damit mit Ihrer Databases for MongoDB Instanz zu verbinden. Sie können Daten mit Hilfe der MongoDB Compass Dokumentation schreiben und lesen.

Nächste Schritte