Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
Guia de início rápido: 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

  • Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  • No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  • No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  • Se você não for o proprietário do projeto, sua conta precisará das seguintes permissões 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 "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 usá-lo 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 ver mais orientações sobre como selecionar um modo de banco de dados e uma comparação por recurso, consulte Como escolher entre o modo nativo e o modo Datastore.

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

    Um local multirregional maximiza 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 termina de ser inicializado, o Console do Google Cloud direciona você à 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, é 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 Kind. Deixe o Identificador de chave definido como o valor padrão 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.

Execute uma consulta

Os bancos de dados do modo Datastore são compatíveis com a consulta de dados por tipo ou por Linguagem de consulta do Google (GQL, na sigla em inglês). As instruções abaixo ajudam você a usar ambos para consultar seu banco de dados.

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 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 desde que o valor de done é false. Uma consulta de tipo com um filtro aplicado
  4. Mude a cláusula de consulta para WHERE, done, ==, boolean e true. Clique em Executar. 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.

Adicione um filtro de consulta para restringir 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. Uma consulta NNAPI 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, Excluir pode estar no menu Mais ações. Depois de ser excluída, a entidade é removida permanentemente do banco de dados.

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

A seguir