Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Firestore é um banco de dados de documentos NoSQL criado para oferecer escalonamento automático,
alto desempenho e facilidade no desenvolvimento de aplicativos. O Firestore é a mais nova versão do Datastore e apresenta
várias melhorias em relação
a ele.
Como o Firestore no modo Datastore (Datastore) é
otimizado para casos de uso do servidor e para o App Engine, recomendamos usar
o Datastore para bancos de dados que serão usados principalmente por
aplicativos do App Engine. O Firestore no modo nativo é mais útil para
casos de uso de notificações móveis e em tempo real. Para mais informações sobre
os modos do Firestore, consulte Como escolher entre o modo nativo e o
modo Datastore.
Este documento descreve como usar as
Bibliotecas de cliente do Cloud para armazenar e
e recuperar dados em um banco de dados no modo Datastore.
Pré-requisitos e configuração
Configure o ambiente e o projeto para entender como os apps são estruturados no App Engine. Anote e salve o ID do projeto. Você precisará dele para executar o aplicativo de amostra descrito neste documento.
Clonar o repositório
Faça o download ou clone da amostra:
Editar a configuração do projeto e definir as dependências
Código do aplicativo
Como usar arquivos index.yaml
O aplicativo de exemplo realiza consultas. Consultas mais elaboradas
do modo Datastore exigem um ou mais
índices, que você precisa especificar em um
arquivo index.yaml
que você envia com seu app. Esse arquivo pode ser criado manualmente ou
ser gerado automaticamente ao testar seu app localmente.
[[["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-11 UTC."],[[["\u003cp\u003eFirestore in Datastore mode is a NoSQL document database optimized for server use cases and App Engine, making it ideal for applications primarily used within App Engine.\u003c/p\u003e\n"],["\u003cp\u003eFirestore in Native mode is better suited for mobile applications and those requiring real-time notifications, offering a different set of functionalities compared to Datastore mode.\u003c/p\u003e\n"],["\u003cp\u003eUsing Datastore mode queries often requires defining indexes in an \u003ccode\u003eindex.yaml\u003c/code\u003e file, which can be created manually or generated automatically during local testing of your application.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the Datastore mode emulator for local development and testing of applications, allowing for a simulated environment before deployment.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive information on Datastore mode, including optimizations and core concepts, can be found in the Firestore in Datastore mode documentation.\u003c/p\u003e\n"]]],[],null,["# Use Firestore in Datastore mode (Datastore)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nGo Java Node.js PHP Python Ruby .NET Custom\n\nFirestore is a NoSQL document database built for automatic scaling,\nhigh performance, and ease of application development. It is the newest version\nof Datastore and introduces several improvements over\nDatastore.\nBecause [Firestore in Datastore mode (Datastore)](/datastore/docs)\nis optimized for server use cases and for App Engine, we recommend using\nDatastore for databases that will be used primarily by\nApp Engine apps. Firestore in Native mode is most useful for\nmobile and real-time notification use cases. For more information about\nFirestore modes, see [Choosing between Native Mode and\nDatastore mode](/datastore/docs/firestore-or-datastore).\n\nThis document describes how to use the\n[Cloud Client Libraries](/datastore/docs/reference/libraries) to store and\nretrieve data in a Datastore mode database.\n\nPrerequisites and setup\n-----------------------\n\n- [Set up your environment and project](/appengine/docs/flexible/setting-up-environment) to understand how apps are structured in App Engine. Write down and save your project ID, because you will need it to run the sample application described in this document.\n\nClone the repository\n--------------------\n\nDownload (clone) the sample:\n\n\u003cbr /\u003e\n\nEdit project configuration and set dependencies\n-----------------------------------------------\n\n\u003cbr /\u003e\n\nApplication code\n----------------\n\n\nUsing `index.yaml` files\n------------------------\n\nThe sample app performs queries. More elaborate Datastore mode queries require one or more [indexes](/datastore/docs/concepts/indexes), which you must specify in an [`index.yaml` file](/appengine/docs/flexible/configuring-datastore-indexes-with-index-yaml) that you upload along with your app. This file may be created manually, or generated automatically while testing your app locally.\n\nLocal testing\n-------------\n\nIf you need to develop and test your application locally, you can [use the\nDatastore mode emulator](/datastore/docs/tools/datastore-emulator).\n\nFor more information\n--------------------\n\nFor complete information on Datastore mode, including\noptimizations and concepts, see the\n[Firestore in Datastore mode documentation](/datastore/docs/overview)."]]