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 Google Cloud console.

Avant de commencer

Connectez-vous à votre Google Cloud compte. Si vous n'avez jamais utilisé Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

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

  • 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 Google Cloud console :
   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

     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, reportez-vous à 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 Emplacements en mode Datastore. L'emplacement s'applique à la fois aux bases de données en mode Datastore et aux applications App Engine de votre Google Cloud projet.

   **Avertissement** : Une fois votre base de données créée, vous ne pouvez plus modifier son emplacement.

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

Stocker des données

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

   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 Key identifier (Identifiant de clé) défini sur la valeur par défaut Numeric ID (auto-generated) (ID numérique (généré automatiquement)).

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 guident pas à pas pour chacune de ces méthodes.

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 en procédant comme suit :

1. Cliquez sur Add query clause (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 est false.
4. Modifiez maintenant la clause de requête en WHERE, done, ==, booléen, 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 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 qui répondent à des critères spécifiques :

1. Exécutez maintenant 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 toutes les clauses de requête.
3. Sélectionnez l'entité Task que vous avez créée.
4. Cliquez sur Delete (Supprimer), puis confirmez que vous souhaitez supprimer l'entité Task. Selon la taille de la fenêtre du navigateur, l'option Delete (Supprimer) peut se trouver dans le menu More actions (Autres actions). Cette opération supprimera définitivement l'entité de votre base de données.

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

Étape suivante

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