现已推出具有 MongoDB 兼容性的 Firestore 企业版！
了解详情。
Guide de démarrage rapide: créer une base de données et s'y connecter
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
|
Ne concerne que l'édition Cloud Firestore Enterprise.
|
Découvrez comment créer une base de données Cloud Firestore compatible avec MongoDB et vous y connecter avec l'outil mongosh.
Avant de commencer
-
Si vous ne l'avez pas encore fait, créez un projet Firebase : dans la console Firebase, cliquez sur Ajouter un projet, puis suivez les instructions à l'écran pour créer un projet Firebase ou ajouter des services Firebase à un projet Google Cloud existant.
- Installer l'outil
mongosh
Créer une base de données Cloud Firestore compatible avec MongoDB et récupérer la chaîne de connexion
Dans la console
Firebase, créez une base de données Firestore Enterprise Edition.
Cloud Firestore compatible avec MongoDB nécessite l'édition Firestore Enterprise :
-
Dans la console Firebase, accédez à la page Base de données Firestore.
Accéder à la base de données Firestore
- Cliquez sur la base de données que vous souhaitez authentifier.
- Dans le panneau Explorateur, cliquez sur more_vert Afficher plus.
- Sélectionnez Se connecter à l'aide des outils MongoDB.
- Copiez la chaîne de connexion.
La chaîne de connexion dépend de l'UID de la base de données (généré par le système) et de l'emplacement de la base de données :
UID.LOCATION.firestore.goog
Créer un utilisateur pour l'authentification SCRAM
Dans la console Google Cloud, créez un utilisateur de base de données et attribuez-lui des autorisations Identity and Access Management.
-
Dans la console Google Cloud, accédez à la page Base de données.
Accéder à la page "Bases de données"
- Sélectionnez la base de données dans la liste.
- Dans le menu de navigation, cliquez sur Authentification.
- Cliquez sur Ajouter un utilisateur.
- Indiquez un nom d'utilisateur.
- Sélectionnez un rôle Identity and Access Management pour l'utilisateur.
- Cliquez sur "Créer". La base de données crée un utilisateur et affiche le mot de passe généré. Copiez et enregistrez ce mot de passe. Vous ne pourrez plus récupérer ce mot de passe par la suite.
Se connecter avec mongosh
Utilisez la chaîne de connexion, le nom d'utilisateur et le mot de passe pour vous connecter à votre base de données, puis exécutez mongosh en local avec les options de configuration suivantes.
mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'
Remplacez les éléments suivants :
- USERNAME : nom de l'utilisateur de la base de données que vous avez créé.
- PASSWORD : mot de passe généré pour l'utilisateur de la base de données que vous avez créé.
- CONNECTION_STRING : chaîne de connexion à la base de données.
- DATABASE_ID : ID de la base de données
Une fois connecté, vous pouvez créer et lire des données, par exemple :
db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit
Étape suivante
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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)"]]
