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: roles/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

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 édition Enterprise. La compatibilité de Firestore avec MongoDB nécessite l'édition Firestore Enterprise:

  1. Dans la Google Cloud console, 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 l'initialisation de la base de données terminé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 les autorisations Identity and Access Management.

  1. Dans la Google Cloud console, 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 IAM 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é pour cet utilisateur. Copiez et enregistrez ce mot de passe. Vous ne pourrez plus récupérer ce mot de passe plus tard.

Se connecter à l'aide de 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 localement avec les options de configuration suivantes.

mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&authMechanismProperties=ENVIRONMENT:gcp,TOKEN_RESOURCE:FIRESTORE&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 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 de la base de données 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 d'Identity and Access Management qui lui sont attribuées.

  1. Dans la Google Cloud console, 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 d'attribution 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 Google Cloud console, accédez à la page Bases de données.

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

  2. Cliquez sur  Afficher plus dans la colonne Actions de la base de données que vous souhaitez supprimer. 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 indique si l'opération a réussi ou échoué.

    Si l'opération échoue, consultez 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 la section Mettre à jour le paramètre de protection contre la suppression.

Étape suivante