Stocker et interroger des données dans Firestore en mode Datastore

Stocker et interroger des données dans Firestore en mode Datastore

Cette page explique comment stocker et interroger des données dans Firestore en mode Datastore à l'aide de la console Google Cloud.

Avant de commencer

• Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

• Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

  Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

  Accéder au sélecteur de projet

• Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

  Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

  Accéder au sélecteur de projet

• Si vous n'êtes pas le propriétaire du projet, votre compte doit disposer des autorisations suivantes pour suivre ce guide de démarrage rapide:

  • Votre compte nécessite le rôle Propriétaire Datastore, qui contient l'autorisation datastore.databases.create nécessaire à la création d'une instance en mode Datastore.
  • Le mode Datastore nécessite une application App Engine active. Si le projet n'a pas d'application, ce guide de démarrage rapide en crée une pour vous. Dans ce cas, vous avez besoin de l'autorisation appengine.applications.create. Le propriétaire du projet peut attribuer cette autorisation avec un rôle personnalisé IAM.

Créer une base de données

1. Pour créer une instance de base de données, ouvrez la section Datastore dans la console Google Cloud:
   Accéder à la page Datastore

2. Sélectionnez un mode de base de données.

   Lorsque vous créez une base de données Firestore, vous avez la possibilité d'utiliser Firestore en mode natif ou en mode Datastore. Vous ne pouvez pas utiliser les deux modes dans le même projet.

   Sélectionnez l'une des options de base de données suivantes :

   • Firestore en mode natif

     Option recommandée pour les applications Web et mobiles. Pour commencer à utiliser Firestore, avancez dans le guide de démarrage rapide de Firestore.

   • Firestore en mode Datastore

     Cette option est recommandée pour les architectures d'applications avec des serveurs backend.

   Pour en savoir plus sur la sélection d'un mode de base de données et pour une comparaison détaillée des fonctionnalités, consultez la section Choisir entre le mode natif et le mode Datastore.

3. Sélectionnez un emplacement de base de données. Le mode Datastore est compatible avec les emplacements multirégionaux et régionaux.

   Un emplacement multirégional maximise la disponibilité et la durabilité. Les emplacements régionaux offrent une latence d'écriture plus faible. Pour en savoir plus sur les types d'emplacements, consultez la section Emplacements en mode Datastore. L'emplacement s'applique aux bases de données en mode Datastore et aux applications App Engine pour votre projet Google Cloud.

   Avertissement :Une fois que vous avez créé votre base de données, vous ne pouvez plus modifier l'emplacement.

   Cliquez sur Créer une base de données. Une fois votre base de données initialisée, la console Google Cloud vous redirige vers la page "Entités Datastore".

Stocker des données

1. Accédez à la page "Entités Datastore" de la console Google Cloud.

   Accéder à la page "Entités"

   Cette page vous permet de stocker, d'interroger, de mettre à jour et de supprimer des données.

2. Cliquez sur Create entity (Créer une entité).

3. Sur la page Create an entity (Créer une entité), indiquez la valeur [default] (par défaut) pour Namespace (Espace de noms).

4. Saisissez Task dans le champ Kind (Genre). Laissez le champ Identifiant de clé défini sur la valeur par défaut Numeric ID (auto-generated).

5. Sous Properties (Propriétés), ajoutez les propriétés suivantes à l'aide du bouton Ajouter une propriété:

   Nom	Type	Value (Valeur)	Propriété indexée
   description	Chaîne	En savoir plus sur Datastore
   created	Date et heure	(date du jour)	✓
   OK	Valeur booléenne	false	✓

   Voici à quoi doit ressembler votre page :

   

6. Cliquez sur Créer. La console affiche l'entité Task que vous venez de créer.

Vous avez stocké des données dans votre base de données !

Exécuter une requête

Les bases de données en mode Datastore permettent d'interroger des données par genre ou par langage de requête Google (GQL). Les instructions ci-dessous vous expliquent comment utiliser les deux méthodes pour interroger votre base de données.

Exécuter des requêtes par genre

1. Cliquez sur Query by kind (Requête par genre).
2. Sélectionnez Task comme genre.

L'entité Task créée auparavant s'affiche dans les résultats de la requête.

Ensuite, ajoutez une clause de requête pour limiter les résultats aux entités répondant à des critères spécifiques:

1. Cliquez sur Ajouter une clause de requête.
2. Dans les listes déroulantes, sélectionnez WHERE, done, ==, boolean et false.
3. Cliquez sur Exécuter. L'entité Task que vous avez créée s'affiche dans les résultats, car sa valeur done est false.
4. Remplacez maintenant la clause de requête par WHERE, done, ==, boolean et true. Cliquez sur Run (Exécuter). L'entité Task que vous avez créée ne s'affiche pas dans les résultats, car sa valeur done n'est pas true.

Exécuter des requêtes GQL

1. Cliquez sur Query by GQL (Requête avec GQL).
2. Saisissez SELECT * FROM Task comme requête. Notez que Task est sensible à la casse.
3. Cliquez sur Run query (Exécuter la requête).

L'entité Task créée auparavant s'affiche dans les résultats de la requête.

Astuce

L'éditeur de requête GQL accepte la saisie semi-automatique pour les genres. Lorsque vous devez saisir un nom de genre, appuyez sur Ctrl+Espace pour afficher une liste des genres disponibles. Cette liste peut contenir jusqu'à 300 entrées, triées dans l'ordre alphabétique. Pour trouver plus facilement un genre, saisissez un ou plusieurs caractères.

Ajoutez un filtre de requête pour limiter les résultats aux entités répondant à des critères spécifiques:

1. Exécutez une requête telle que SELECT * FROM Task WHERE done=false. Notez que Task et done sont sensibles à la casse. L'entité Task que vous avez créée s'affiche dans les résultats, car sa valeur done (terminée) est false (fausse).
2. Exécutez maintenant une requête telle que SELECT * FROM Task WHERE done=true. L'entité Task que vous avez créée ne s'affiche pas dans les résultats, car sa valeur done (terminée) n'est pas true (vraie).

Effectuer un nettoyage

1. Cliquez sur Query by kind (Requête par genre) et vérifiez que Task est bien le genre sélectionné.
2. Cliquez sur Clear (Effacer) pour supprimer les clauses de requête.
3. Sélectionnez l'entité Task que vous avez créée.
4. Cliquez sur Supprimer, puis confirmez que vous souhaitez supprimer l'entité Task. En fonction de la taille de la fenêtre du navigateur, l'option Supprimer peut se trouver dans le menu Autres actions . Une fois supprimée, l'entité est définitivement supprimée de votre base de données.

Voilà ! Vous avez terminé le guide de démarrage rapide.

Étapes suivantes

• En savoir plus sur les requêtes Datastore.
• En savoir plus sur les bases de données en mode Datastore.