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.
-
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
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.
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 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
- 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. - Clique em Criar entidade.
Se a página a seguir for exibida, selecione um local. Caso contrário, pule para a próxima etapa.
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.Na página Criar uma entidade, use
[default]
para Namespace.Digite
Task
para Tipo.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 ✓ 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
- Clique em Consulta por tipo.
- 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:
- Clique em Filtrar entidades.
- Nas listas suspensas, selecione
done
, é um booleano e é falso. - Clique em Aplicar filtros. Os resultados mostram a entidade
Task
criada, porque o valordone
éfalse
. - Tente uma consulta de
done
, é um booleano e é verdadeiro. Os resultados não incluem a entidadeTask
criada, porque o valordone
não étrue
.
Executar 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.
Mais uma vez, adicione um filtro de consulta para limitar os resultados às entidades que atendem 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 filtros.
- Selecione a entidade
Task
que você criou - 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.