Armazenar e consultar dados no Firestore no modo Datastore

Guia de início rápido: armazenar e consultar dados no Firestore no modo Datastore

Armazenar e consultar dados no Firestore no modo Datastore

Nesta página, mostramos como armazenar e consultar dados no Firestore no modo Datastore usando o Console do Google Cloud.

Antes de começar

• Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

• No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

  Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

  Acessar o seletor de projetos

• No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

  Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

  Acessar o seletor de projetos

• Se você não for o proprietário do projeto, sua conta precisará das seguintes permissões 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.

Crie um banco de dados

1. Para criar uma nova instância de banco de dados, abra a seção "Datastore" no Console do Google Cloud:
   Acessar a página do Datastore

2. Selecione um modo de banco de dados.

   Ao criar um novo banco de dados do Firestore, você tem a opção de usá-lo 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 ver mais orientações sobre como selecionar um modo de banco de dados e uma comparação por recurso, consulte Como escolher entre o modo nativo e o modo Datastore.

3. Selecione o local do banco de dados. O modo Datastore é compatível com locais multirregionais e regionais.

   Um local multirregional maximiza a disponibilidade e a durabilidade. Os locais regionais oferecem menor latência de gravação. Para saber mais sobre os tipos de local, consulte Locais do modo Datastore. O local se aplica aos bancos de dados do modo Datastore e aos aplicativos do App Engine para seu projeto do Google Cloud.

   Aviso: depois de criar o banco de dados, não será possível alterar o local.

   Clique em Criar banco de dados. Depois que o banco de dados termina de ser inicializado, o Console do Google Cloud direciona você à página "Entidades do Datastore".

Armazenar dados

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

   Acessar a página "Entidades"

   Nesta página, é 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 Kind. Deixe o Identificador de chave definido como o valor padrão Numeric ID (auto-generated).

5. Em Propriedades, use o botão Adicionar propriedade para incluir estas propriedades:

   Nome	Tipo	Valor	Indexada
   description	String	Saiba mais sobre o Datastore.
   created	Data e hora	(data de hoje)	✓
   concluído	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 Linguagem de consulta do Google (GQL, na sigla em inglês). As instruções abaixo ajudam você a usar ambos para consultar seu banco de dados.

Executar 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, ==, boolean e false.
3. Clique em Executar. Os resultados mostram a entidade Task que você criou desde que o valor de done é false.
4. Mude a cláusula de consulta para WHERE, done, ==, boolean e true. Clique em Executar. Os resultados não incluem a entidade Task criada, porque o valor done não é true.

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

Dica

O editor de consulta GQL é compatível com o preenchimento automático de tipos. Ao digitar um nome de tipo, pressione Ctrl+espaço para ver uma lista dos tipos disponíveis. Ela pode exibir até 300 tipos em ordem alfabética. Para melhor correspondência dos tipos, digite um ou mais caracteres.

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, Excluir pode estar no menu Mais ações. Depois de ser excluída, a entidade é removida permanentemente do banco de dados.

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

A seguir

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