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

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. 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.

      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. Dans la liste Sélectionner un rôle, sélectionnez un 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

    6. 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 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

    Étapes suivantes