Armazenar e consultar dados no Firestore no modo Datastore

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.

Go to project selector

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

• 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

1. 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

2. 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.

   Para mais orientações sobre a seleção de um banco de dados e uma comparação de cada recurso, consulte Como escolher entre o modo nativo e o modo Datastore.

3. 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

1. Acesse a página "Entidades do Datastore" no Google Cloud console.

   Acessar a página "Entidades"

   Nela, é possível armazenar, consultar, atualizar e excluir dados.

2. Clique em Create entity.

3. Na página Criar uma entidade, use [default] para Namespace.

4. Digite Task no campo Tipo. Deixe o Identificador da chave definido como o valor padrão Numeric ID (auto-generated).

5. 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:

   

6. 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

1. Clique em Consulta por tipo.
2. 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:

1. Clique em Adicionar cláusula de consulta.
2. Nas listas suspensas, selecione WHERE, done, ==, booleano e falso.
3. Clique em Executar. Os resultados mostram a entidade Task que você criou porque o valor done é false.
4. 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

1. Clique em Consulta por GQL.
2. Digite SELECT * FROM Task como a consulta. Task diferencia maiúsculas de minúsculas.
3. 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:

1. 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.
2. 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

1. Clique em Consulta por tipo e verifique se Task é o tipo selecionado.
2. Clique em Limpar para remover todas as cláusulas de consulta.
3. Selecione a entidade Task que você criou.
4. 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_vert Mais ações. Depois de excluída, ela será permanentemente removida do banco de dados.

Pronto, você concluiu as etapas deste início rápido.

Próximas etapas

• Saiba mais sobre Consultas do Datastore.
• Saiba mais sobre os bancos de dados do modo Datastore.