Kurzanleitung: Datenbank erstellen und eine Verbindung dazu herstellen

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

Hinweise

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

  3. Verify that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: Cloud Datastore Owner

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      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. Wählen Sie in der Liste Rolle auswählen eine Rolle aus.
    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.

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

    Erstellen Sie in der Google Cloud -Console eine neue Firestore Enterprise Edition-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 Auth.
    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