Accéder à votre base de données

Cette page explique comment accéder à une base de données Firestore en mode Datastore à partir de différentes plates-formes.

Avant de commencer

Ce document suppose que vous avez déjà créé une base de données en mode Datastore. Si vous n'avez pas encore créé de base de données, suivez les instructions du guide de démarrage rapide de Firestore en mode Datastore.

Accéder à votre base de données depuis App Engine

Pour commencer à utiliser le mode Datastore et App Engine, consultez l'une des pages suivantes, propres à chaque langage :

Environnement standard App Engine Environnement flexible App Engine

Autorisations en mode Datastore pour App Engine

Les applications App Engine peuvent accéder par défaut à une base de données en mode Datastore dans le même projet. Chaque application App Engine utilise un compte de service par défaut App Engine permettant de gérer l'accès aux services Google Cloud tels que Firestore. Par défaut, le compte de service par défaut d'App Engine est doté du rôle IAM "Éditeur de projet", qui inclut un accès complet en lecture et en écriture au mode Datastore.

Vous pouvez modifier les autorisations IAM du compte de service App Engine par défaut, mais votre application risque de perdre l'accès à Firestore. Pour éviter cela, vous pouvez lui attribuer un rôle IAM disposant des autorisations Firestore requises. Par exemple, les rôles IAM Propriétaire Datastore et Utilisateur Datastore autorisent l'accès en lecture et en écriture à Firestore en mode Datastore.

Si vous désactivez ou supprimez votre compte de service App Engine par défaut, votre application App Engine perdra l'accès à votre base de données en mode Datastore. Si vous avez désactivé votre compte de service App Engine, vous pouvez le réactiver. Consultez la section Activer un compte de service. Si vous avez supprimé votre compte de service App Engine au cours des 30 derniers jours, vous pouvez le restaurer, comme décrit dans la section Annuler la suppression d'un compte de service.

Accéder à votre base de données depuis une instance Compute Engine

Cette section explique comment activer une base de données en mode Datastore et y accéder depuis une instance de VM Compute Engine dans un nouveau projet ou un projet existant.

Autorisations en mode Datastore pour Compute Engine

Les applications Compute Engine peuvent accéder par défaut à une base de données en mode Datastore dans le même projet. Chaque application Compute Engine utilise un compte de service Compute Engine par défaut pour gérer l'accès aux services Google Cloud tels que Firestore. Le compte de service par défaut de Compute Engine est doté du rôle IAM "Éditeur de projet", qui inclut un accès complet en lecture et en écriture au mode Datastore.

Pour accéder à votre base de données depuis une instance Compute Engine, procédez comme suit:

  1. Activez l'API Google Compute Engine pour votre projet.
    Activer l'API Compute Engine

  2. Make sure that billing is enabled for your Google Cloud project.

  3. Créer une instance Compute Engine.

Console

  1. Dans la console Google Cloud, accédez à la page Instances de VM.
  2. Cliquez sur le bouton Créer une instance.
  3. Dans la section Identité et accès à l'API, définissez les Champs d'application d'accès pour donner l'accès à Datastore. Cliquez sur Autoriser un accès complet à toutes les API Cloud pour accorder l'accès à toutes les API Google Cloud, ou choisissez Définir l'accès pour chaque API et cliquez sur le menu déroulant Datastore, puis sur Activé pour accorder l'accès à Datastore.
  4. Cliquez sur le bouton Créer pour créer l'instance de VM.
  5. Confirmez que l'instance est en cours d'exécution.
  6. Pour utiliser cette nouvelle instance de VM Compute Engine, connectez-vous à celle-ci à l'aide de votre navigateur.

gcloud

  1. Si ce n'est pas déjà fait, installez la Google Cloud CLI et configurez gcloud compute.

  2. Ajoutez une instance de VM Compute Engine et démarrez-la en suivant les instructions de la section Démarrer une instance, issue de la documentation Compute Engine. Spécifiez l'ID du projet, le nom de l'instance de VM et la portée cloud-platform ou datastore, comme illustré dans l'exemple suivant.

    export PROJECT_ID=[YOUR_PROJECT_ID]
export INSTANCE_NAME=[YOUR_INSTANCE_NAME]
gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore

    Remplacez [YOUR_PROJECT_ID] par l'ID du projet que vous avez créé précédemment et [YOUR_INSTANCE_NAME] par le nom que vous souhaitez utiliser pour votre instance de VM.

  3. Confirmez que l'instance est en cours d'exécution.

  4. Pour utiliser cette nouvelle instance de VM, connectez-vous à la VM.

À ce stade, tous les services et autorisations sont configurés pour votre projet, et vous pouvez commencer à écrire du code ou à explorer l'API.

Accéder à votre base de données depuis une autre plate-forme

Cette section explique comment accéder à votre base de données en mode Datastore à partir d'une application externe exécutée sur une plate-forme en dehors de Google Cloud.

Commencez par créer un compte de service :

  1. Dans la console Google Cloud, accédez à la page Créer un compte de service.

    Accéder à la page "Créer un compte de service"

  2. Sélectionnez un projet.

  3. Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.

  4. Facultatif : Dans le champ Description du compte de service, saisissez une description.

  5. Cliquez sur Créer.

  6. Cliquez sur le champ Sélectionner un rôle.

    Sous Tous les rôles, sélectionnez un rôle qui accorde l'accès à votre base de données, tel que Datastore > Utilisateur Cloud Datastore.

  7. Cliquez sur Continuer.

  8. Cliquez sur OK pour terminer la création du compte de service.

    Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin pour la procédure suivante.

Créez ensuite une clé de compte de service :

  1. Dans Google Cloud Console, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
  2. Cliquez sur Clés.
  3. Cliquez sur AJOUTER UNE CLÉ -> Créer une clé.
  4. Cliquez sur Créer. Un fichier de clé JSON est téléchargé sur votre ordinateur.
  5. Cliquez sur Close (Fermer).

Ce compte de service vous permet de configurer les identifiants de votre code d'application comme décrit dans la section Fournir les identifiants du compte de service.

Quotas et facturation

Vous disposez gratuitement d'une certaine quantité de quotas, comme décrit dans la section Tarifs et quotas. Cela signifie que vous n'êtes pas obligé d'activer la facturation pour commencer ou pour pouvoir utiliser Firestore en mode Datastore jusqu'à la limite de quotas gratuite. Toutefois, si vous avez besoin de plus de ressources que celles fournies par le quota gratuit, vous devez activer la facturation.

Étape suivante

Pour activer la facturation, consultez la section Activer la facturation pour un projet.