Armazene e consulte 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 não for o proprietário do projeto, a sua conta requer as seguintes autorizações para concluir este início rápido:

  • A sua conta requer a função de proprietário do Datastore que contém a autorização datastore.databases.create necessária para criar uma instância do modo Datastore.
  • O modo Datastore requer uma aplicação do App Engine ativa. Se o projeto não tiver uma aplicação, este início rápido cria uma para si. Nesse caso, precisa da autorização appengine.applications.create. O proprietário do projeto pode atribuir esta autorização com uma função personalizada do IAM.

Crie uma base de dados

1. Para criar uma nova instância da base de dados, abra a secção Datastore na Google Cloud consola:
   Aceda à página Datastore

2. Selecione um modo de base de dados.

   Quando cria uma nova base de dados do Firestore, tem a opção de usar o Firestore no modo nativo ou no modo Datastore. Não pode usar ambos os modos no mesmo projeto.

   Selecione uma das opções de base de dados:

   • Firestore no modo nativo

     Recomendado para apps para dispositivos móveis e Web. Para começar a usar o Firestore, continue no 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 modo de base de dados e uma comparação detalhada das funcionalidades, consulte o artigo Escolher entre o modo nativo e o modo Datastore.

3. Selecione uma localização da base de dados. O modo Datastore suporta localizações multirregionais e regionais.

   Uma localização multirregional maximiza a disponibilidade e a durabilidade. As localizações regionais oferecem uma latência de escrita mais baixa. Para saber mais sobre os tipos de localizações, consulte o artigo Localizações do modo Datastore. A localização aplica-se a bases de dados do modo Datastore e a apps do App Engine para o seu Google Cloud projeto.

   Clique em Criar base de dados. Depois de a base de dados terminar a inicialização, a Google Cloud consola direciona-o para a página Entidades do Datastore.

Armazene dados

1. Aceda à página Entidades do Datastore na Google Cloud consola.

   Aceda à página Entidades

   Esta página permite-lhe armazenar, consultar, atualizar e eliminar dados.

2. Clique em Criar entidade.

3. Na página Criar uma entidade, use [default] para Espaço de nomes.

4. Introduza Task no campo Tipo. Deixe a opção Identificador principal definida com o valor predefinido de Numeric ID (auto-generated).

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

   Nome	Tipo	Valor	Indexados
   descrição	String	Saiba mais sobre o Datastore.
   criado	Data e hora	(data de hoje)	✓
   concluído	Booleano	Falso	✓

   A página de criação deve ter agora o seguinte aspeto:

   

6. Clique em Criar. A consola apresenta a entidade Task que acabou de criar.

Acabou de armazenar dados na sua base de dados!

Execute uma consulta

As bases de dados do modo Datastore suportam a consulta de dados por tipo ou por linguagem de consulta da Google (GQL). As instruções abaixo explicam como usar ambos os métodos para consultar a sua base de dados.

Execute consultas de tipo

1. Clique em Consultar por tipo.
2. Selecione Task como o tipo.

Os resultados da consulta mostram a entidade Task que criou.

Em seguida, adicione uma cláusula de consulta para restringir os resultados a entidades que cumprem critérios específicos:

1. Clique em Adicionar cláusula de consulta.
2. Nas listas pendentes, selecione WHERE, done, ==, booleano e falso.
3. Clique em Executar. Os resultados mostram a entidade Task que criou, uma vez que o respetivo valor done é false.
4. Agora, altere a cláusula de consulta para WHERE, done, ==, booleano e verdadeiro. Clique em Executar. Os resultados não incluem a entidade Task que criou, porque o respetivo valor done não é true.

Execute consultas GQL

1. Clique em Consultar por GQL.
2. Introduza SELECT * FROM Task como a consulta. Tenha em atenção que Task é sensível a maiúsculas e minúsculas.
3. Clique em Executar consulta.

Os resultados da consulta mostram a entidade Task que criou.

Adicione um filtro de consulta para restringir os resultados a entidades que cumprem critérios específicos:

1. Execute uma consulta como SELECT * FROM Task WHERE done=false. Tenha em atenção que Task e done são sensíveis a maiúsculas e minúsculas. Os resultados mostram a entidade Task que criou, uma vez que o respetivo valor done é false.
2. Agora, execute uma consulta como SELECT * FROM Task WHERE done=true. Os resultados não incluem a entidade Task que criou, porque o respetivo valor done não é true.

Limpar

1. Clique em Consultar por tipo e certifique-se de que Task é o tipo selecionado.
2. Clique em Limpar para remover todas as cláusulas de consulta.
3. Selecione a entidade Task que criou.
4. Clique em Eliminar e, de seguida, confirme que quer eliminar a entidade Task. Consoante o tamanho da janela do navegador, a opção Eliminar pode estar no menu more_vert Mais ações. Depois de eliminada, a entidade é removida permanentemente da sua base de dados.

É tudo. Concluiu este início rápido!

O que se segue?

• Saiba mais sobre as consultas da Datastore.
• Saiba mais sobre as bases de dados do modo Datastore.