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

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

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

   • Firestore en mode Datastore

     Recommandé pour les architectures d'application 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 de chaque option, 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 zones multirégionales et régionales.

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

   Cliquez sur Créer une base de données. Une fois la 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 (Type). Laissez Identifiant de clé défini sur la valeur par défaut Numeric ID (auto-generated).

5. Sous Properties (Propriétés), utilisez le bouton Add property (Ajouter une propriété) pour ajouter les propriétés suivantes:

   Nom	Type	Valeur	Propriété indexée
   description	Chaîne	En savoir plus sur Datastore
   créé	Date et heure	(date du jour)	✓
   done	booléen	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 avec Google Query Language (GQL). Les instructions ci-dessous vous expliquent comment utiliser les deux 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.

Pour affiner les résultats en fonction de critères spécifiques, ajoutez une clause de requête:

1. Cliquez sur Ajouter une clause de requête.
2. Dans les listes déroulantes, sélectionnez WHERE, done, ==, booléen 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 (terminée) est false (fausse).
4. Remplacez maintenant la clause de requête par WHERE, done, ==, boolean et true. Cliquez sur Exécuter. 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).

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.

Ajoutez un filtre de requête pour limiter les résultats aux entités qui répondent à 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).