Se connecter avec mongosh

Découvrez comment créer une base de données Firestore compatible avec MongoDB et vous y connecter à l'aide de l'outil mongosh.

Avant de commencer

  1. Dans la console Google Cloud , accédez à la page de sélection du projet.

    Accéder au sélecteur de projet

  2. Sélectionnez ou créez un projet Google Cloud .

    Rôles requis pour sélectionner ou créer un projet

    • Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
    • Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

  3. Vérifiez que la facturation est activée pour votre projet Google Cloud .

  4. Assurez-vous de disposer des rôles suivants sur le projet : Propriétaire Cloud Datastore

    Vérifier les rôles

    1. Dans la console Google Cloud , accédez à la page IAM.

      Accéder à IAM
    2. Sélectionnez le projet.

    3. Dans la colonne Compte principal, recherchez toutes les lignes qui vous identifient ou identifient un groupe dont vous faites partie. Pour savoir à quels groupes vous appartenez, contactez votre administrateur.

    4. Pour toutes les lignes qui vous spécifient ou vous incluent, consultez la colonne Rôle pour vous assurer que la liste inclut les rôles requis.

    Attribuer les rôles

    1. Dans la console Google Cloud , accédez à la page IAM.

      Accéder à IAM
    2. Sélectionnez le projet.
    3. Cliquez sur  Accorder l'accès.

    4. Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.

    5. Cliquez sur Sélectionner un rôle, puis recherchez le rôle.
    6. Pour attribuer des rôles supplémentaires, cliquez sur  Ajouter un autre rôle et ajoutez tous les rôles supplémentaires.
    7. Cliquez sur Enregistrer.
  5. Installer l'outil mongosh

Créer une base de données Firestore compatible avec MongoDB et récupérer la chaîne de connexion

Dans la console Google Cloud , créez une base de données Firestore Enterprise Edition. Firestore compatible avec MongoDB nécessite l'édition Firestore Enterprise :

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

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

  2. Cliquez sur Créer une base de données Firestore.
  3. Saisissez un ID de base de données.
  4. Sélectionnez l'édition Enterprise.
  5. Sélectionnez un emplacement pour votre base de données.

  6. Cliquez sur Créer une base de données.

    Une fois la base de données initialisée, la console ouvre Firestore Studio pour votre base de données.

  7. Dans la section Se connecter à Firestore à l'aide d'un outil MongoDB externe, 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 Bases 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 Sécurité.
  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 ultérieurement.

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

Étapes suivantes