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.

  3. Make sure 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 chaque rôle supplémentaire.
    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 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

    Effectuer un nettoyage

    Pour nettoyer les ressources utilisées sur cette page, supprimez l'utilisateur et la base de données.

    Supprimer l'utilisateur de la base de données

    Supprimez l'utilisateur de la base de données pour supprimer l'utilisateur et les autorisations Identity and Access Management attribuées.

    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 Actions dans la colonne Actions de l'utilisateur que vous souhaitez supprimer. Cliquez sur Supprimer le compte utilisateur. Une boîte de dialogue s'affiche.
    5. Confirmez la suppression, puis cliquez sur Supprimer.
    6. Une boîte de dialogue affiche un lien vers la page IAM. Cliquez sur le lien pour supprimer les autorisations attribuées à l'utilisateur de la base de données.

    7. Recherchez la ligne contenant le compte principal dont vous souhaitez révoquer l'accès. Cliquez ensuite sur Modifier le compte principal sur cette ligne.

      Le principal de l'utilisateur de base de données que vous avez créé utilise le format de nom suivant :

      principal://firestore.googleapis.com/projects/PROJECT_NUMBER/name/databases/DATABASE_ID/userCreds/USER_ID
    8. Cliquez sur le bouton Supprimer () correspondant au rôle que vous souhaitez révoquer, puis cliquez sur Enregistrer.

    Supprimer la base de données

    Pour supprimer la base de données, procédez comme suit :

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

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

    2. Dans la colonne Actions de la base de données que vous souhaitez supprimer, cliquez sur Afficher plus. Cliquez sur Supprimer. Une boîte de dialogue s'affiche.

    3. Dans la boîte de dialogue Supprimer la base de données ?, confirmez la suppression en saisissant l'ID de la base de données dans le champ de texte. Cliquez sur Supprimer. La console vous informe de la réussite ou de l'échec de l'opération.

      Si l'opération échoue, affichez les détails de la base de données et vérifiez que la protection contre la suppression est désactivée. Pour désactiver la protection contre la suppression, consultez Mettre à jour le paramètre de protection contre la suppression.

    Étapes suivantes