Guide de démarrage rapide: créer une base de données et s'y connecter

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 à l'aide de l'outil mongosh.

Avant de commencer

  1. 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.
  2. 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 :

  1. Dans la console Firebase, accédez à la page Base de données Firestore.

    Accéder à la base de données Firestore

  2. Cliquez sur la base de données que vous souhaitez authentifier.
  3. Dans le panneau Explorateur, cliquez sur Afficher plus.
  4. Sélectionnez Se connecter à l'aide des outils MongoDB.
  5. 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.

  1. Dans la console Google Cloud, accédez à la page Base de données.

    Accéder à la page "Bases de données"

  2. Sélectionnez la base de données dans la liste.
  3. Dans le menu de navigation, cliquez sur Authentification.
  4. Cliquez sur Ajouter un utilisateur.
  5. Indiquez un nom d'utilisateur.
  6. Sélectionnez un rôle Identity and Access Management pour l'utilisateur.
  7. 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