Guia de início rápido

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

Antes de começar

• Faça login na sua conta do Google.

  Se você ainda não tiver uma, inscreva-se.

• 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 a página do seletor de projetos

• 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

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

Firestore: modo nativo ou modo Datastore

Ao criar um novo banco de dados do Firestore, você tem a opção de usar o Firestore em modo nativo ou em modo Datastore.

Aviso: depois de selecionar um modo de banco de dados e executar a primeira gravação no banco de dados, não será mais possível mudá-lo. Não é possível usar o modo nativo e o modo Datastore no mesmo projeto.

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

• Firestore no modo nativo

  Use o Firestore no modo nativo para dispositivos móveis e apps da Web. Para começar a usar o Firestore, continue no Guia de início rápido do Firestore.

• Firestore no modo Datastore

  Use o Firestore no modo Datastore para novos projetos de servidor. Selecione o Firestore no modo Datastore para usar a camada de armazenamento do Firestore melhorada e manter o comportamento do sistema em modo Datastore.

  Observação: futuramente, todos os projetos do Datastore atuais serão atualizados automaticamente para o Firestore em modo Datastore.

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 Cloud Firestore e o Cloud Datastore.

Armazene os dados

1. Acesse a página "Entidades do Datastore" no Console do Google Cloud.
   Acessar a página "Entidades do Datastore"
   Esta página permite armazenar, consultar, atualizar e excluir dados.
2. Clique em Criar entidade.

3. Se a página a seguir for exibida, selecione um local. Caso contrário, pule para a próxima etapa.
   

   Aviso: não será possível alterar o local depois de salvá-lo.

   

   O local se aplica aos bancos de dados do modo Datastore e aos aplicativos do App Engine do seu projeto do Google Cloud.
   Para salvar um local, selecione um dos valores de local e clique em Próximo.

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

5. Digite Task para Tipo.

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

   Nome	Tipo	Valor	Indexada
   description	String	Saiba mais sobre o modo Google Datastore
   created	Data e hora	(data de hoje)	✓
   done	Booleano	Falso	✓

   A página de criação terá esta aparência:

   

7. 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). A seguir, você verá instruções para os dois tipos de consulta.

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 um filtro de consulta para limitar os resultados às entidades que atendem a critérios específicos:

1. Clique em Filtrar entidades.
2. Nas listas suspensas, selecione done, é um booleano e é falso.
3. Clique em Aplicar filtros. Os resultados mostram a entidade Task criada, porque o valor done é false.
4. Tente uma consulta de done, é um booleano e é verdadeiro. 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.

Mais uma vez, 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 filtros.
3. Selecione a entidade Task que você criou
4. Clique em Excluir e confirme se você quer excluir a entidade Task. 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.