Mit mongosh verbinden

Hier erfahren Sie, wie Sie eine Firestore-Datenbank mit MongoDB-Kompatibilität erstellen und mit dem mongosh-Tool eine Verbindung dazu herstellen.

Hinweis

  1. Rufen Sie in der Google Cloud Console die Seite für die Projektauswahl auf.

    Zur Projektauswahl

  2. Wählen Sie ein Google Cloud Projekt aus oder erstellen Sie eines.

    Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

    • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
    • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen

  3. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

  4. Prüfen Sie, ob Sie die folgende Rolle oder die folgenden Rollen für das Projekt haben: Cloud Datastore-Inhaber

    Rollen prüfen

    1. Rufen Sie in der Google Cloud Console die Seite IAM auf.

      IAM aufrufen
    2. Wählen Sie das Projekt aus.

    3. Suchen Sie in der Spalte Hauptkonto nach allen Zeilen, in denen Sie oder eine Gruppe, zu der Sie gehören, angegeben sind. Fragen Sie Ihren Administrator, zu welchen Gruppen Sie gehören.

    4. Prüfen Sie in allen Zeilen, in denen Sie angegeben oder enthalten sind, die Spalte Rolle, um zu sehen, ob die Liste der Rollen die erforderlichen Rollen enthält.

    Rollen zuweisen

    1. Rufen Sie in der Google Cloud Console die Seite IAM auf.

      IAM aufrufen
    2. Wählen Sie das Projekt aus.
    3. Klicken Sie auf Zugriffsrechte erteilen.

    4. Geben Sie im Feld Neue Hauptkonten Ihre Nutzer-ID ein. Das ist in der Regel die E‑Mail-Adresse eines Google-Kontos.

    5. Klicken Sie auf Rolle auswählen und suchen Sie nach der Rolle.
    6. Klicken Sie auf Weitere Rolle hinzufügen, wenn Sie weitere Rollen zuweisen möchten.
    7. Klicken Sie auf Speichern.
  5. Installieren Sie das mongosh-Tool.

Firestore-Datenbank mit MongoDB-Kompatibilität erstellen und Verbindungsstring abrufen

Erstellen Sie in der Google Cloud Console eine neue Firestore Enterprise-Datenbank. Für Firestore mit MongoDB-Kompatibilität ist die Firestore Enterprise-Edition erforderlich:

  1. Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.

    Zur Seite „Datenbanken“

  2. Klicken Sie auf Firestore-Datenbank erstellen.
  3. Geben Sie eine Datenbank-ID ein.
  4. Wählen Sie die Enterprise Edition aus.
  5. Wählen Sie einen Speicherort für Ihre Datenbank aus.

  6. Klicken Sie auf Datenbank erstellen.

    Wenn die Initialisierung der Datenbank abgeschlossen ist, wird in der Konsole Firestore Studio für Ihre Datenbank geöffnet.

  7. Kopieren Sie im Abschnitt Mit externem MongoDB-Tool Verbindung zu Firestore herstellen den Verbindungsstring.

Der Verbindungsstring hängt von der UID der Datenbank (systemgeneriert) und dem Speicherort der Datenbank ab:

UID.LOCATION.firestore.goog

Nutzer für die SCRAM-Authentifizierung erstellen

Erstellen Sie in der Google Cloud -Konsole einen neuen Datenbanknutzer und weisen Sie ihm IAM-Berechtigungen (Identity and Access Management) zu.

  1. Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.

    Zur Seite „Datenbanken“

  2. Wählen Sie die Datenbank aus der Liste der Datenbanken aus.
  3. Klicken Sie im Navigationsmenü auf Sicherheit.
  4. Klicken Sie auf Add User (Nutzer hinzufügen).
  5. Geben Sie einen Benutzernamen ein.
  6. Wählen Sie eine Identity and Access Management-Rolle für den Nutzer aus.
  7. Klicken Sie auf „Erstellen“. Die Datenbank erstellt einen Nutzer und zeigt Ihnen das generierte Passwort des Nutzers an. Kopieren Sie dieses Passwort und speichern Sie es. Sie können dieses Passwort später nicht mehr abrufen.

Verbinden über mongosh

Verwenden Sie den Verbindungsstring, den Nutzernamen und das Passwort, um eine Verbindung zu Ihrer Datenbank herzustellen und mongosh lokal mit den folgenden Konfigurationsoptionen auszuführen.

mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'

Ersetzen Sie Folgendes:

  • USERNAME: der Name des von Ihnen erstellten Datenbanknutzers.
  • PASSWORD: Das generierte Passwort für den von Ihnen erstellten Datenbanknutzer.
  • CONNECTION_STRING: Der Datenbankverbindungsstring.
  • DATABASE_ID: eine Datenbank-ID

Nachdem Sie eine Verbindung hergestellt haben, können Sie Daten erstellen und lesen, z. B.:

db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit

Nächste Schritte