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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
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.
- Sua conta requer o papel
Proprietário do Datastore
que contém a permissão
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 DatastoreSelecione 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.
-
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
Acesse a página "Entidades do Datastore" no console do Google Cloud.
Nessa página, é possível armazenar, consultar, atualizar e excluir dados.
Clique em Create entity.
Na página Criar uma entidade, use
[default]
para Namespace.Digite
Task
no campo Tipo. Deixe o Identificador de chave definido como o valor padrão deNumeric ID (auto-generated)
.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 ✓ 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
- Clique em Consulta por tipo.
- 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:
- Clique em Adicionar cláusula de consulta.
- Nas listas suspensas, selecione
WHERE
,done
,==
, boolean e false. - Clique em Executar. Os resultados mostram a entidade
Task
que você criou, já que o valordone
éfalse
. - Agora altere a cláusula de consulta para
WHERE
,done
,==
, boolean e true. Clique em Executar. Os resultados não incluem a entidadeTask
que você criou, porque o valordone
não étrue
.
Execute consultas GQL
- Clique em Consulta por GQL.
- Digite
SELECT * FROM Task
como a consulta.Task
diferencia maiúsculas de minúsculas. - 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:
- Execute uma consulta como
SELECT * FROM Task WHERE done=false
. Observe queTask
edone
diferenciam maiúsculas de minúsculas. Os resultados mostram a entidadeTask
que você criou porque o valordone
éfalse
. - Agora execute uma consulta como
SELECT * FROM Task WHERE done=true
. Os resultados não incluem a entidadeTask
criada, porque o valordone
não étrue
.
Limpar
- Clique em Consulta por tipo e verifique se
Task
é o tipo selecionado. - Clique em Limpar para remover todas as cláusulas de consulta.
- Selecione a entidade
Task
que você criou. - 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
- Saiba mais sobre Consultas do Datastore.
- Saiba mais sobre os bancos de dados do modo Datastore.