现已推出具有 MongoDB 兼容性的 Firestore 企业版!
了解详情。
Kurzanleitung: Datenbank erstellen und Verbindung dazu herstellen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Nur für die Cloud Firestore Enterprise-Edition relevant.
|
Hier erfahren Sie, wie Sie eine Cloud Firestore-Datenbank mit MongoDB-Kompatibilität erstellen und mit dem Tool mongosh
eine Verbindung zu ihr herstellen.
Hinweis
-
Falls noch nicht geschehen, erstellen Sie ein Firebase-Projekt: Klicken Sie in der Firebase Console auf Projekt hinzufügen und folgen Sie der Anleitung auf dem Bildschirm, um ein Firebase-Projekt zu erstellen oder Firebase-Dienste für ein vorhandenes Google Cloud-Projekt hinzuzufügen.
- Installieren Sie das
mongosh
-Tool.
Cloud Firestore-Datenbank mit MongoDB-Kompatibilität erstellen und Verbindungsstring abrufen
Erstellen Sie in der
Firebase Console eine neue Firestore Enterprise-Datenbank.
Für Cloud Firestore mit MongoDB-Kompatibilität ist die Firestore Enterprise-Edition erforderlich:
-
Rufen Sie in der Firebase-Konsole die Seite Firestore-Datenbank auf.
Zur Firestore-Datenbank
- Klicken Sie auf die Datenbank, die Sie authentifizieren möchten.
- Klicken Sie im Bereich Explorer auf more_vert Mehr ansehen.
- Wählen Sie Verbindung mit MongoDB-Tools herstellen aus.
- Kopieren Sie die Verbindungszeichenfolge.
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 Console einen neuen Datenbanknutzer und weisen Sie ihm IAM-Berechtigungen (Identity and Access Management) zu.
-
Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.
Zur Seite „Datenbanken“
- Wählen Sie die Datenbank aus der Liste der Datenbanken aus.
- Klicken Sie im Navigationsmenü auf Auth.
- Klicken Sie auf Nutzer hinzufügen.
- Geben Sie einen Benutzernamen ein.
- Wählen Sie eine IAM-Rolle für den Nutzer aus.
- 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
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[],[],null,["\u003cbr /\u003e\n\n\n|--------------------------------------------------------|\n| *Relevant to Cloud Firestore Enterprise edition only.* |\n\n\u003cbr /\u003e\n\nLearn how to create a Cloud Firestore with MongoDB compatibility database and connect to it with the\n`mongosh` tool.\n\nBefore you begin\n\n1. If you haven't already, create a Firebase project: In the [Firebase console](//console.firebase.google.com/), click **Add project** , then follow the on-screen instructions to create a Firebase project or to add Firebase services to an existing Google Cloud project.\n2. [Install the `mongosh` tool](https://www.mongodb.com/docs/mongodb-shell/install/)\n\n\u003cbr /\u003e\n\nCreate a Cloud Firestore with MongoDB compatibility database and retrieve the connection string In the Firebase console, create a new Firestore Enterprise edition database. Cloud Firestore with MongoDB compatibility requires Firestore Enterprise edition:\n1. In the Firebase console, go to the **Firestore Database** page.\n\n [Go to Firestore Database](//console.firebase.google.com/project/_/firestore/databases/-default-/data/)\n2. Click the database that you want to authenticate.\n3. In the **Explorer** panel, click more_vert **View more**.\n4. Select **Connect using MongoDB tools**.\n5. Copy the connection string.\n\n\u003cbr /\u003e\n\nThe connection string depends on the UID of the database (system-generated)\nand the location of database: \n\n```text\nUID.LOCATION.firestore.goog\n```\n\nCreate a user for SCRAM authentication\n\nIn the Google Cloud console, create a new database user and assign\nthe user Identity and Access Management permissions.\n\n1. In the Google Cloud console, go to the **Databases** page.\n\n [Go to Databases](https://console.cloud.google.com/firestore/databases)\n2. Select the database from the list of databases.\n3. In the navigation menu, click **Auth**.\n4. Click **Add User**.\n5. Enter a username.\n6. Select an Identity and Access Management role for the user.\n7. Click create. The database creates a user and shows you the user's generated password. **Copy and save this password. You will not be able to retrieve\n this password later.**.\n\nConnect using `mongosh`\n\nUse the connection string, username, and password to connect to your\ndatabase, run `mongosh` locally with the following configuration options. \n\n```gdscript\nmongosh 'mongodb://\u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e:\u003cvar translate=\"no\"\u003ePASSWORD\u003c/var\u003e@\u003cvar translate=\"no\"\u003eCONNECTION_STRING\u003c/var\u003e:443/\u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e: the name of the database user you created.\n- \u003cvar translate=\"no\"\u003ePASSWORD\u003c/var\u003e: the generated password for the database user you created.\n- \u003cvar translate=\"no\"\u003eCONNECTION_STRING\u003c/var\u003e: the database connection string.\n- \u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e: a database ID\n\nOnce connected, you can create and read data, for example: \n\n```text\ndb.pages.insertOne({ message: \"Hello World!\"})\ndb.pages.find({})\nexit\n```\n\nWhat's next\n\n- [See a list of supported features](/docs/firestore/enterprise/supported-data-types-drivers)\n- [Learn about behavior differences in Cloud Firestore with MongoDB compatibility](/docs/firestore/enterprise/behavior-differences)\n- [Learn about additional authentication methods](/docs/firestore/enterprise/connect)"]]