Récupérer des résultats de requête

Une fois que vous avez créé une requête, vous pouvez spécifier un certain nombre d'options de récupération de façon à mieux contrôler les résultats qu'elle renvoie. Pour en savoir plus sur la structuration des requêtes pour l'application, consultez la page Requêtes Datastore.

Récupérer une seule entité

Pour récupérer une seule entité correspondant à votre requête, utilisez la méthode Query.get() (ou GqlQuery.get()) :

q = Person.all()
q.filter("last_name =", target_last_name)

result = q.get()

Cette méthode renvoie le premier résultat de l'index correspondant à la requête.

Appliquer une itération aux résultats de la requête

Lors d'une itération sur les résultats d'une requête à l'aide de la méthode run() d'un objet Query ou GqlQuery, Cloud Datastore récupère les résultats sous forme de lots. Par défaut, chaque lot contient 20 résultats, mais vous pouvez modifier cette valeur à l'aide du paramètre batch_size de la méthode. Vous pouvez continuer à appliquer l'itération aux résultats de la requête jusqu'à ce que tous les résultats soient renvoyés ou jusqu'à l'expiration de la requête.

Récupérer certaines propriétés d'une entité

Pour ne récupérer que certaines propriétés d'une entité plutôt que l'entité entière, utilisez une requête de projection. Ce type de requête s'exécute plus rapidement et coûte moins cher qu'une requête renvoyant des entités entières.

De même, une requête ne contenant que des clés permet de gagner du temps et d'économiser des ressources en ne renvoyant que les clés aux entités auxquelles elle correspond, plutôt que les entités entières elles-mêmes. Pour créer ce type de requête, définissez keys_only=True lors de la construction de l'objet de la requête :

q = Person.all(keys_only=True)

Définir une limite pour la requête

Vous pouvez spécifier une limite pour la requête afin de contrôler le nombre maximal de résultats renvoyés dans un lot. L'exemple suivant récupère les cinq personnes les plus grandes depuis Cloud Datastore :

q = Person.all()
q.order("-height")

for p in q.run(limit=5):
  print "%s %s, %d inches tall" % (p.first_name, p.last_name, p.height)

Étapes suivantes