Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Armazenar e consultar dados no Firestore no modo Datastore
Nesta página, mostramos como armazenar e consultar dados no Firestore em modo Datastore usando o console Google Cloud .
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 você não for o proprietário do projeto, será necessário ter as
seguintes permissões na sua conta para concluir este guia de início rápido:
Sua conta requer o papel
Proprietário do Datastore
que contém a permissão datastore.databases.create
necessária para criar uma instância do modo Datastore.
O modo Datastore requer um aplicativo ativo do App Engine.
Se o projeto não tiver um, este início rápido o criará
para você. Nesse caso, é necessária a permissão
appengine.applications.create. O proprietário do projeto
pode atribuir essa permissão com um
papel personalizado do IAM.
Criar um banco de dados
Para criar uma nova instância de banco de dados, abra a seção do Datastore
no console Google Cloud : Acessar a página do Datastore
Selecione um modo de banco de dados.
Ao criar um banco de dados do Firestore, você pode usar o Firestore no modo nativo ou no modo Datastore. Não é possível usar os dois
modos no mesmo projeto.
Selecione uma das opções de banco de dados:
Firestore no modo nativo
Recomendado para apps da Web e para dispositivos móveis. Para começar a usar o Firestore, continue no Guia de início rápido do Firestore.
Firestore no modo Datastore
Recomendado para arquiteturas de apps com servidores de back-end.
Selecione um local para o banco de dados. O modo Datastore oferece suporte a locais multirregionais e regionais.
Um local multirregional maximiza a disponibilidade e a durabilidade. As regiões oferecem menor latência de gravação. Para saber mais sobre os tipos de locais,
consulte Locais do modo Datastore.
O local se aplica aos bancos de dados do modo Datastore e aos apps do App Engine para seu projeto Google Cloud .
Clique em Criar banco de dados. Depois que o banco de dados terminar de ser inicializado, o
consoleGoogle Cloud vai direcionar você para a página "Entidades do Datastore".
Armazenar dados
Acesse a página "Entidades do Datastore" no Google Cloud console.
Nela, é possível armazenar, consultar, atualizar e excluir dados.
Clique em Create entity.
Na página Criar uma entidade, use [default] para Namespace.
Digite Task no campo Tipo. Deixe o Identificador da chave definido como o valor padrão Numeric ID (auto-generated).
Em Propriedades, use o botão Adicionar propriedade para adicionar estas propriedades:
Nome
Tipo
Valor
Indexada
description
String
Saiba mais sobre o Datastore.
created
Data e hora
(data de hoje)
✓
done
Booleano
Falso
✓
A página de criação deve ter esta aparência:
Clique em Criar. O console exibe a entidade Task que você acabou de criar.
Você acabou de armazenar dados no banco de dados.
Executar uma consulta
Os bancos de dados do modo Datastore são compatíveis com a consulta de dados por tipo ou por Google Query Language (GQL). As instruções abaixo mostram como usar os dois para consultar seu banco de dados.
Execute consultas por tipo
Clique em Consulta por tipo.
Selecione Task como o tipo.
Os resultados da consulta mostram a entidade Task que você criou.
Em seguida, adicione uma cláusula de consulta para restringir os resultados às entidades que atendem a critérios
específicos:
Clique em Adicionar cláusula de consulta.
Nas listas suspensas, selecione WHERE, done, ==, booleano e falso.
Clique em Executar. Os resultados mostram a entidade Task que você
criou porque o valor done é false.
Agora mude a cláusula de consulta para WHERE, done, ==, booleano e verdadeiro. Clique em Executar. Os resultados não incluem a entidade Task que você
criou, porque o valor done não é true.
Execute consultas GQL
Clique em Consulta por GQL.
Digite SELECT * FROM Task como a consulta. Task diferencia maiúsculas de minúsculas.
Clique em Executar consulta.
Os resultados da consulta mostram a entidade Task que você criou.
Adicione um filtro de consulta para restringir os resultados às entidades que atendem a critérios específicos:
Execute uma consulta como SELECT * FROM Task WHERE done=false. Observe que Task
e done diferenciam maiúsculas de minúsculas.
Os resultados mostram a entidade Task que você criou porque o valor done é false.
Agora execute uma consulta como SELECT * FROM Task WHERE done=true. Os resultados não
incluem a entidade Task criada, porque o valor done
não é true.
Limpar
Clique em Consulta por tipo e verifique se Task é o tipo selecionado.
Clique em Limpar para remover todas as cláusulas de consulta.
Selecione a entidade Task que você criou.
Clique em Excluir e confirme se você quer excluir a entidade Task.
Dependendo do tamanho da janela do navegador, a opção Excluir pode estar no menu
more_vertMais ações. Depois de excluída, ela será permanentemente removida do banco de dados.
Pronto, você concluiu as etapas deste início rápido.
[[["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-09-05 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"]]