Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
Sign in to your Google Cloud account. If you're new to
Google Cloud,
create an account to evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
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
Pour créer une instance de base de données, ouvrez la section Datastore dans la console Google Cloud : Accéder à la page Datastore
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 :
Recommandé pour les architectures d'application avec des serveurs de 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.
Sélectionnez un emplacement pour la 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 du 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 l'initialisation de votre base de données terminée, la consoleGoogle Cloud vous redirige vers la page "Entités Datastore".
Stocker des données
Accédez à la page "Entités Datastore" de la console Google Cloud .
Cette page vous permet de stocker, d'interroger, de mettre à jour et de supprimer des données.
Cliquez sur Create entity (Créer une entité).
Sur la page Create an entity (Créer une entité), indiquez la valeur [default] (par défaut) pour Namespace (Espace de noms).
Saisissez Task dans le champ Type. Laissez le champ Identifiant de la clé défini sur la valeur par défaut Numeric ID (auto-generated).
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 :
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
Cliquez sur Query by kind (Requête par genre).
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 :
Cliquez sur Ajouter une clause de requête.
Dans les listes déroulantes, sélectionnez WHERE, done, ==, booléen et false.
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).
Modifiez maintenant la clause de requête en 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
Cliquez sur Query by GQL (Requête avec GQL).
Saisissez SELECT * FROM Task comme requête. Notez que Task est sensible à la casse.
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 :
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).
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
Cliquez sur Query by kind (Requête par genre) et vérifiez que Task est bien le genre sélectionné.
Cliquez sur Effacer pour supprimer les clauses de requête.
Sélectionnez l'entité Task que vous avez créée.
Cliquez sur Supprimer, puis confirmez que vous souhaitez supprimer l'entité Task.
Selon la taille de la fenêtre du navigateur, l'option Supprimer peut se trouver dans le menu more_vertAutres 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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/03 (UTC)."],[[["\u003cp\u003eThis guide demonstrates how to use the Google Cloud console to store and query data in Firestore's Datastore mode.\u003c/p\u003e\n"],["\u003cp\u003eCreating a Datastore mode instance requires the Datastore Owner role and an active App Engine application, or the \u003ccode\u003eappengine.applications.create\u003c/code\u003e permission.\u003c/p\u003e\n"],["\u003cp\u003eDatastore mode offers multi-region or regional locations, and once set, the database location cannot be changed.\u003c/p\u003e\n"],["\u003cp\u003eData can be stored as entities with properties (name, type, value), and the guide uses a \u003ccode\u003eTask\u003c/code\u003e entity example.\u003c/p\u003e\n"],["\u003cp\u003eData in Datastore can be queried by kind or using Google Query Language (GQL), with support for filtering results based on specific criteria.\u003c/p\u003e\n"]]],[],null,["# Quickstart: Store and query data in Firestore in Datastore mode\n\nStore and query data in Firestore in Datastore mode\n===================================================\n\nThis page shows you how to store and query data in Firestore in Datastore mode using the Google Cloud console.\n\nBefore you begin\n----------------\n\n- Sign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **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.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **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.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n\n If you are **not** the project owner, your account requires the\n following permissions to complete this quickstart:\n\n\n - Your account requires the [**Datastore Owner** role](/iam/docs/understanding-roles#cloud_datastore_roles) which contains the `datastore.databases.create` permission needed to create a Datastore mode instance.\n - Datastore mode requires an active App Engine application. If the project doesn't have an application, this quickstart creates one for you. In that case, you require the `appengine.applications.create` permission. The project owner can assign this permission with an [IAM custom role](/iam/docs/creating-custom-roles).\n\nCreate a database\n-----------------\n\n1. To create a new database instance, open the Datastore section\n in the Google Cloud console: \n\n [Go to the Datastore page](https://console.cloud.google.com/datastore/welcome)\n\n2. Select a database mode.\n\n When you create a new Firestore database, you have the option to use\n Firestore in either Native Mode or Datastore mode. You can't use both\n modes in the same project.\n\n Select from one of the database options:\n - **Firestore in Native Mode**\n\n Recommended for mobile and web apps. To get started with Firestore, continue in the [Firestore Quickstart](/firestore/docs/quickstart).\n - **Firestore in Datastore Mode**\n\n Recommended for app architectures with backend servers.\n\n For more guidance on selecting a database mode and for a feature-by-feature\n comparison, see\n [choosing between Native Mode and Datastore Mode](/datastore/docs/firestore-or-datastore).\n3. Select a database location. Datastore mode supports multi-region\n and regional locations.\n\n A multi-region location maximizes availability and durability. Regional\n locations offer lower write latency. To learn more about location types,\n see [Datastore mode locations](/datastore/docs/locations).\n The location applies to both Datastore mode databases and App Engine apps for\n your Google Cloud project.\n | **Warning:** Once you create your database, you cannot change the location.\n\n Click **Create database**. After your database finishes initializing, the\n Google Cloud console directs you to the Datastore Entities page.\n\nStore data\n----------\n\n1. Go to the Datastore Entities page in the Google Cloud console.\n\n [Go to the Entities page](https://console.cloud.google.com/datastore/entities/query)\n\n This page lets you store, query, update, and delete data.\n2. Click **Create entity**.\n\n3. On the **Create an entity** page, use `[default]` for **Namespace**.\n\n4. Type `Task` in the **Kind** field. Leave **Key identifier** set to the\n default value of `Numeric ID (auto-generated)`.\n\n5. Under **Properties** , use the **Add property** button to add these properties:\n\n Your creation page should now look like this:\n\n \u003cbr /\u003e\n\n6. Click **Create** . The console displays the `Task` entity that you just created.\n\nYou just stored data in your database!\n\nRun a query\n-----------\n\nDatastore mode databases support querying data by kind or by\nGoogle Query Language (GQL). The instructions below walk you through using both\nto query your database.\n\n### Run kind queries\n\n1. Click **Query by kind**.\n2. Select `Task` as the kind.\n\nThe query results show the `Task` entity that you created.\n\nNext, add a query clause to restrict the results to entities that meet specific\ncriteria:\n\n1. Click **Add query clause**.\n2. In the dropdown lists, select `WHERE`, `done`, `==`, **boolean** , and **false**.\n3. Click **Run** . The results show the `Task` entity that you created since its `done` value is `false`.\n4. Now change the query clause to `WHERE`, `done`, `==`, **boolean** , and **true** . Click **Run** . The results do not include the `Task` entity that you created, because its `done` value is not `true`.\n\n### Run GQL queries\n\n1. Click **Query by GQL**.\n2. Enter `SELECT * FROM Task` as the query. Note that `Task` is case sensitive.\n3. Click **Run query**.\n\nThe query results show the `Task` entity that you created.\n| **Tip**\n|\n| The GQL query editor supports autocompletion for kinds: When you\n| need to type a kind name, press Ctrl+Space to see a list of the available\n| kinds. Up to 300 alphabetically sorted kinds can appear in the list. For\n| better matches of kinds, type one or more characters.\n\nAdd a query filter to restrict the results to entities that meet\nspecific criteria:\n\n1. Run a query such as `SELECT * FROM Task WHERE done=false`. Note that `Task` and `done` are case sensitive. The results show the `Task` entity that you created, since its `done` value is `false`.\n2. Now run a query such as `SELECT * FROM Task WHERE done=true`. The results do not include the `Task` entity that you created, because its `done` value is not `true`.\n\nClean up\n--------\n\n1. Click **Query by kind** and ensure `Task` is the selected kind.\n2. Click **Clear** to remove any query clauses.\n3. Select the `Task` entity that you created.\n4. Click **Delete** , and then confirm you want to delete the `Task` entity. Depending on the size of the browser window, **Delete** might be under the more_vert **More actions** menu. Once deleted, the entity is permanently removed from your database.\n\nThat's it, you completed this quickstart!\n\nWhat's next\n-----------\n\n- Learn more about [Datastore Queries](/datastore/docs/concepts/queries).\n- Learn more about [Datastore mode](/datastore/docs) databases.\n\n\u003cbr /\u003e"]]
