O Firestore é um banco de dados de documentos NoSQL criado para fornecer 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 é otimizado para casos de uso do servidor e para o App Engine, recomendamos o uso do Firestore no modo 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.
Neste documento, descrevemos como usar a biblioteca de cliente do Google Cloud para armazenar e recuperar dados em um banco de dados no modo Datastore.
Pré-requisitos e configuração
Siga as instruções em "Hello, World!" para Node.js no App Engine e configure o ambiente e o projeto. Saiba também como os apps Node.js são estruturados no App Engine. Anote e salve o ID do projeto. Você precisará dele para executar o aplicativo de exemplo descrito neste documento.
Clonar o repositório
Faça o download ou clone da amostra:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
cd nodejs-docs-samples/appengine/datastore
Editar a configuração do projeto e definir as dependências
Em package.json
, defina @google-cloud/datastore
como uma dependência, que fornece
as funções para usar o modo Datastore.
Código do aplicativo
O aplicativo de amostra registra, recupera e exibe IPs de visitantes. A entrada
de registro é uma classe simples de dois campos que recebe o tipo visit
,
sendo salva no modo Datastore por meio do comando
save (em inglês) do conjunto de dados. Em seguida, as dez visitas mais recentes são recuperadas em ordem decrescente,
por meio do comando
runQuery
do conjunto de dados.
Como usar arquivos index.yaml
O app de exemplo faz consultas simples. Consultas mais elaboradas do modo Datastore exigem um ou mais índices, que você precisa especificar em um arquivo index.yaml
enviado com o aplicativo. Esse arquivo pode ser criado ou gerado automaticamente ao testar seu aplicativo localmente.
Teste local
Se precisar desenvolver e testar seu aplicativo localmente, é possível usar o emulador de modo Datastore.
Para saber mais
Para informações completas sobre o modo Datastore, incluindo otimizações e conceitos, veja a documentação do Cloud Firestore no modo Datastore.