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.

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

  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 a seleção de um banco de dados e uma comparação recurso a recurso, consulte Como escolher entre o modo nativo e o modo Datastore.

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

    Um local multirregional aumenta 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.

    Clique em Criar banco de dados. Depois que o banco de dados terminar a inicialização, o console do Google Cloud 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"

    Nessa 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 Tipo. Deixe o Identificador de chave definido como o valor padrão de 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:

    Janela de criação de entidade com várias propriedades definidas

  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 orientam você no uso de ambos para consultar o 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 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, já que o valor done é false. Uma consulta de tipo com um filtro aplicado
  4. Agora altere a cláusula de consulta para WHERE, done, ==, boolean e true. Clique em Executar. 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.

Adicione um filtro de consulta para restringir os resultados a entidades que atendam 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. 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 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 ser excluída, a entidade é permanentemente removida do banco de dados.

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

A seguir