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 Cloud, na página do seletor de projetos, selecione ou crie um projeto do Cloud.

    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.

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

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.

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

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

    Captura de tela da página

    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:

    Captura de tela da janela de criação de entidade com as propriedades configuradas

  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. Captura de tela de uma consulta de tipo com um filtro aplicado
  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.

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. Captura de tela de uma consulta GQL com um filtro aplicado
  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.

A seguir