Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Almacena y consulta datos en Firestore en modo Datastore
En esta página, se muestra cómo almacenar y consultar datos en Firestore en modo Datastore con la consola de Google Cloud .
Antes de comenzar
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 no eres el propietario del proyecto, tu cuenta requiere los siguientes permisos para completar esta guía de inicio rápido:
Tu cuenta requiere la función de propietario de Datastore, que contiene el permiso datastore.databases.create necesario para crear una instancia de Datastore.
El modo Datastore requiere una aplicación activa de App Engine.
Si el proyecto no tiene una aplicación, esta guía de inicio rápido crea una para ti. En ese caso, necesitas el permiso appengine.applications.create. El propietario del proyecto puede asignar este permiso con una función de IAM personalizada.
Crea una base de datos
Para crear una instancia de base de datos nueva, abre la sección Datastore en la Google Cloud consola: Ir a la página de Datastore
Selecciona un modo de base de datos.
Cuando creas una nueva base de datos de Firestore, tienes la opción de usar Firestore en modo nativo o en modo Datastore. No puedes usar ambos modos en el mismo proyecto.
Selecciona una de las opciones de bases de datos:
Firestore en modo nativo
Se recomienda para aplicaciones web y para dispositivos móviles. Para comenzar con Firestore, continúa en la Guía de inicio rápido de Firestore.
Firestore en modo Datastore
Se recomienda para arquitecturas de apps con servidores de backend.
Selecciona una ubicación para la base de datos. El modo Datastore admite ubicaciones multirregionales y regionales.
Una ubicación multirregional maximiza la disponibilidad y la durabilidad. Las ubicaciones regionales ofrecen una latencia de escritura más baja. Para obtener más información sobre los tipos de ubicaciones, consulta Ubicaciones del modo Datastore.
La ubicación se aplica a las bases de datos del modo Datastore y a las apps de App Engine de tu Google Cloud proyecto.
Haz clic en Crear base de datos. Una vez que finalice la inicialización de la base de datos, la consolaGoogle Cloud te redireccionará a la página Entidades de Datastore.
Almacenar datos
Ve a la página Entidades de Datastore en la Google Cloud consola.
Esta página te permite almacenar, consultar, actualizar y borrar datos.
Haz clic en Create entity.
En la página Create an entity (Crear una entidad), usa [default] en Namespace (Espacio de nombres).
Escribe Task en el campo Kind. Deja el identificador de clave establecido en el valor predeterminado de Numeric ID (auto-generated).
En Propiedades, usa el botón Agregar propiedad para agregar estas propiedades:
Nombre
Tipo
Valor
Indexado
description
String
Obtén más información sobre Datastore.
created
Fecha y hora
(la fecha de hoy)
✓
done
Booleano
Falso
✓
Ahora tu página de creación debería verse así:
Haz clic en Crear. La consola muestra la entidad Task que acabas de crear.
Acabas de almacenar datos en tu base de datos.
Ejecuta una consulta
Las bases de datos en modo Datastore permiten consultar datos por tipo o mediante Google Query Language (GQL). Las instrucciones que se indican a continuación te guiarán para usar ambos métodos y consultar tu base de datos.
Ejecuta consultas por tipo
Haz clic en Consulta por tipo (Query by kind).
Selecciona Task como el tipo.
Los resultados de la consulta muestran la entidad Task que creaste.
A continuación, agrega una cláusula de consulta para restringir los resultados a entidades que cumplan con ciertos criterios:
Haz clic en Agregar cláusula de consulta.
En las listas desplegables, selecciona WHERE, done, ==, booleano y falso.
Haz clic en Ejecutar. Los resultados muestran la entidad Task que creaste, ya que su valor done es false.
Ahora cambia la cláusula de consulta a WHERE, done, ==, boolean y true. Haz clic en Ejecutar. Los resultados no incluyen la entidad Task que creaste, porque su valor done no es true.
Ejecuta consultas en GQL
Haz clic en Consulta por GQL (Query by GQL).
Ingresa SELECT * FROM Task como la consulta. Ten en cuenta que Task distingue entre mayúsculas y minúsculas.
Haz clic en Ejecutar consulta (Run query).
Los resultados de la consulta muestran la entidad Task que creaste.
Agrega un filtro de consulta para restringir los resultados a entidades que cumplan con ciertos criterios:
Ejecuta una consulta como SELECT * FROM Task WHERE done=false. Ten en cuenta que Task y done distinguen entre mayúsculas y minúsculas.
Los resultados muestran la entidad Task que creaste, ya que su valor done es false.
Ahora, ejecuta una consulta como SELECT * FROM Task WHERE done=true. Los resultados no incluyen la entidad Task que creaste, porque su valor done no es true.
Realiza una limpieza
Haz clic en Consulta por categoría (Query by kind) y asegúrate de que Task sea la categoría seleccionada.
Haz clic en Borrar para quitar las cláusulas de consulta.
Selecciona la entidad Task que creaste.
Haz clic en Borrar y confirma que deseas borrar la entidad Task.
Según el tamaño de la ventana del navegador, Borrar podría estar en el menú Más acciones de more_vert. Una vez borrada, la entidad se quita de forma permanente de la base de datos.
Eso es todo, finalizaste la guía de inicio rápido.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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"]]
