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

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

  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.

  Go to project selector

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

  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.

  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.

Crie um banco de dados

1. Para criar uma nova instância de banco de dados, abra a seção do 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 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 como selecionar um modo de 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 do banco de dados. O modo Datastore oferece suporte a locais multirregionais e regionais.

   Um local multirregional maximiza a disponibilidade e a durabilidade. Os locais regionais oferecem latência de gravação mais baixa. 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 do seu projeto do Google Cloud.

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

   Clique em Criar banco de dados. Depois que o banco de dados terminar a inicialização, o console do Google Cloud vai direcionar você para a 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, você pode 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 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.
   criada	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 limitar 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 Run. 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.

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 limitar 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 Mais ações. Depois de excluída, a entidade é removida permanentemente 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.