Após a criação de uma consulta, é possível especificar várias opções de recuperação para controlar ainda mais os resultados retornados. Acesse Consultas do Datastore para ver mais informações sobre a estruturação de consultas para o aplicativo.
Como iterar pelos resultados de consulta
Ao iterar os resultados de uma consulta usando o método Run
de um valor Query
, o Cloud Datastore recupera os resultados em lotes. Por padrão, cada lote contém 20 resultados. É possível continuar iterando pelos resultados da consulta até que todos sejam retornados ou a solicitação expire.
Run
para receber um Iterator
, com o qual é possível percorrer cada entidade usando o método Next
do Iterator
.
Para recuperar todas as entidades que correspondem à consulta de uma só vez, use o método GetAll
.
Como recuperar propriedades selecionadas de uma entidade
Para recuperar apenas as propriedades selecionadas de uma entidade, e não toda a entidade, use uma consulta de projeção. Esse tipo de consulta é executado com maior rapidez e custa menos que uma consulta que retorna entidades completas.
Da mesma forma, uma consulta somente de chaves economiza tempo e recursos ao retornar apenas as chaves das entidades correspondentes, e não as entidades completas. Para criar esse tipo de consulta, chame o método KeysOnly
ao criar Query
:
Como definir um limite para a consulta
Você pode especificar um limite para a consulta para controlar o número máximo de resultados retornados em um lote. No exemplo a seguir, recuperamos as cinco pessoas mais altas do Cloud Datastore:
Próximas etapas
- Conheça as restrições comuns para consultas no Cloud Datastore.
- Saiba mais sobre os cursores de consulta, que permitem que um aplicativo recupere os resultados de uma consulta em lotes convenientes.
- Entenda a consistência dos dados e como ela funciona com diferentes tipos de consultas no Cloud Datastore.
- Conheça a sintaxe básica e a estrutura das consultas do Cloud Datastore.