Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Armazene e consulte dados no Firestore no modo Datastore
Esta página mostra como armazenar e consultar dados no Firestore no modo Datastore através da Google Cloud consola.
Antes de começar
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.
Se não for o proprietário do projeto, a sua conta requer as seguintes autorizações para concluir este início rápido:
A sua conta requer a função de
proprietário do Datastore
que contém a autorização datastore.databases.create
necessária para criar uma instância do modo Datastore.
O modo Datastore requer uma aplicação do App Engine ativa.
Se o projeto não tiver uma aplicação, este início rápido cria uma para si. Nesse caso, precisa da autorização appengine.applications.create. O proprietário do projeto
pode atribuir esta autorização com uma
função personalizada do IAM.
Crie uma base de dados
Para criar uma nova instância da base de dados, abra a secção Datastore
na Google Cloud consola: Aceda à página Datastore
Selecione um modo de base de dados.
Quando cria uma nova base de dados do Firestore, tem a opção de usar o Firestore no modo nativo ou no modo Datastore. Não pode usar ambos os modos no mesmo projeto.
Selecione uma das opções de base de dados:
Firestore no modo nativo
Recomendado para apps para dispositivos móveis e Web. Para começar a usar o Firestore, continue no Início rápido do Firestore.
Firestore no modo Datastore
Recomendado para arquiteturas de apps com servidores de back-end.
Selecione uma localização da base de dados. O modo Datastore suporta localizações multirregionais e regionais.
Uma localização multirregional maximiza a disponibilidade e a durabilidade. As localizações
regionais oferecem uma latência de escrita mais baixa. Para saber mais sobre os tipos de localizações,
consulte o artigo Localizações do modo Datastore.
A localização aplica-se a bases de dados do modo Datastore e a apps do App Engine para o seu Google Cloud projeto.
Clique em Criar base de dados. Depois de a base de dados terminar a inicialização, a
Google Cloud consola direciona-o para a página Entidades do Datastore.
Armazene dados
Aceda à página Entidades do Datastore na Google Cloud consola.
Esta página permite-lhe armazenar, consultar, atualizar e eliminar dados.
Clique em Criar entidade.
Na página Criar uma entidade, use [default] para Espaço de nomes.
Introduza Task no campo Tipo. Deixe a opção Identificador principal definida com o valor predefinido de Numeric ID (auto-generated).
Em Propriedades, use o botão Adicionar propriedade para adicionar estas propriedades:
Nome
Tipo
Valor
Indexados
descrição
String
Saiba mais sobre o Datastore.
criado
Data e hora
(data de hoje)
✓
concluído
Booleano
Falso
✓
A página de criação deve ter agora o seguinte aspeto:
Clique em Criar. A consola apresenta a entidade Task que acabou de criar.
Acabou de armazenar dados na sua base de dados!
Execute uma consulta
As bases de dados do modo Datastore suportam a consulta de dados por tipo ou por
linguagem de consulta da Google (GQL). As instruções abaixo explicam como usar ambos os métodos para consultar a sua base de dados.
Execute consultas de tipo
Clique em Consultar por tipo.
Selecione Task como o tipo.
Os resultados da consulta mostram a entidade Task que criou.
Em seguida, adicione uma cláusula de consulta para restringir os resultados a entidades que cumprem critérios
específicos:
Clique em Adicionar cláusula de consulta.
Nas listas pendentes, selecione WHERE, done, ==, booleano e
falso.
Clique em Executar. Os resultados mostram a entidade Task que criou, uma vez que o respetivo valor done é false.
Agora, altere a cláusula de consulta para WHERE, done, ==, booleano e
verdadeiro. Clique em Executar. Os resultados não incluem a entidade Task que criou, porque o respetivo valor done não é true.
Execute consultas GQL
Clique em Consultar por GQL.
Introduza SELECT * FROM Task como a consulta. Tenha em atenção que Task é sensível a maiúsculas e minúsculas.
Clique em Executar consulta.
Os resultados da consulta mostram a entidade Task que criou.
Adicione um filtro de consulta para restringir os resultados a entidades que cumprem
critérios específicos:
Execute uma consulta como SELECT * FROM Task WHERE done=false. Tenha em atenção que Task
e done são sensíveis a maiúsculas e minúsculas.
Os resultados mostram a entidade Task que criou, uma vez que o respetivo valor done é false.
Agora, execute uma consulta como SELECT * FROM Task WHERE done=true. Os resultados não incluem a entidade Task que criou, porque o respetivo valor done não é true.
Limpar
Clique em Consultar por tipo e certifique-se de que Task é o tipo selecionado.
Clique em Limpar para remover todas as cláusulas de consulta.
Selecione a entidade Task que criou.
Clique em Eliminar e, de seguida, confirme que quer eliminar a entidade Task.
Consoante o tamanho da janela do navegador, a opção Eliminar pode estar no menu
more_vertMais ações. Depois de eliminada, a entidade é removida permanentemente da sua base de dados.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 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"]]
