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, exécutez 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 trouvé dans l'index, qui correspond à la requête.

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

Lors de l'itération des 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 en appelant la méthode batch_size. 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, exécutez 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)

Et ensuite ?

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Environnement standard App Engine pour Python 2