Les queryset sont une des composantes importantes de Django. Comment en effet interagir avec la BD sans eux ?<\/p>\n
Mais est ce que cet outil si important et si souvent utilis\u00e9 est si bien connu que \u00e7a ?<\/p>\n
Parce que tout le monde connait count(), filter(), all() et exclude(). Mais qu’n est-il des autres m\u00e9thodes ? Perso, je suis le premier \u00e0 aller dans la doc, pour rev\u00e9rifier si ce que je voudrais n’existe pas d\u00e9j\u00e0…<\/p>\n
C’est le pourquoi de ce billet, lister quelques m\u00e9thodes ‘\u00e0 conna\u00eetre’ des querysets (et puis comme \u00e7a la prochaine fois que j’aurais besoin de v\u00e9rifier un truc, je pourrais le faire en lisant du fran\u00e7ais et pas de l’anglais). (Ce n’est au final qu’une redite de la page de doc qui va bien, mais \u00e7a peut servir).<\/p>\n
une petite m\u00e9thode bien pratique, qui permet de rajouter des colonnes calcul\u00e9es (en utilisant les classes d’agr\u00e9gat Sum,Count, etc d\u00e9fini par django) pour chaque objets r\u00e9cup\u00e9r\u00e9s dans le queryset.<\/p>\n
Et \u00e7a, c’est plut\u00f4t fort. Surtout que l’on peut, bien entendu, ‘traverser’ les foreign key
\nL’un des exemples de la doc, montre cela en calculant pour un magasin le prix minimum et maximum des livres en vente :<\/p>\n
Deux m\u00e9thodes plus que miam.
\nValues retourne un ValuesQuerySet qui est en fait un queryset compos\u00e9 d’une liste de dictionnaires au lieu d’une liste d’instance d’objet mod\u00e8le. Chaque dictionnaire repr\u00e9sente un objet, les paire cl\u00e9s \/ valeur repr\u00e9sentant le nom de l’attribut (la key) et la valeur de l’attribut (sa valeur).
\nOn peut passer \u00e0 values un param\u00e8tre optionnel *fields, qui permet de sp\u00e9cifier la liste des noms d’attribut (des strings donc) que l’on veut r\u00e9cup\u00e9rer.
\nExemple :<\/p>\n
Deux choses importantes \u00e0 se rappeler, values ne r\u00e9cup\u00e8re rien pour les manytomany et dans le cas des FK, la cl\u00e9 du dico est le nom ‘vrai’ de l’attribut dans la table (souvent avec _id donc) et la valeur, la valeur de la PK de la FK. Et comme le voit dans l’exemple, si on veut passer le nom explicite de l’attribut de la fk, on peut au choix mettre ou pas le _id, le r\u00e9sultat est le m\u00eame.<\/p>\n
Exemple :<\/p>\n
values_list c’est \u00e0 peu pr\u00e8s la m\u00eame chose que values, sauf que c’est une liste de tuple et pas une liste de dico. On peut en plus lui passer un param\u00eatre flat que l’on peut mettre \u00e0 true , pour ‘aplatir’ les tuples quand l’on demande qu’un seul champ (juste coolos quand on veut une liste de pk)<\/p>\n
L’int\u00e9r\u00eat c’est qu’un ValuesQuerySet, c’est comme un queryset. Et que donc on peut utiliser toutes les m\u00e9thodes des queryset dessus. Y compris refiltrer, order_by, etc etc ..<\/p>\n
Et que dans le m\u00eame temps, on peut all\u00e9ger la charge, surtout si on a des gros models dont l’on ne veut utiliser que quelques champs.<\/p>\n
Permet d’indiquer au queryset de ne pas r\u00e9cup\u00e9rer automatiquement le contenu des champs qui sont pass\u00e9s en param\u00eatre du defer. Ca peut \u00eatre utile dans le cas de gros champ texte par exemple (imaginons une vue en liste de billet de blog o\u00f9 l’on ne veut que les titres des billets et pas leur contenu, utiliser un defer(‘body’) pourrait \u00eatre une possibilit\u00e9 , utiliser un values en serait une autre)<\/p>\n
les champs deferred seront r\u00e9cup\u00e9r\u00e9s quand on les appelera explicitement. Pour annuler les defer d’un queryset, il suffit d’appeler la fonction avec None en param\u00eatre.<\/p>\n
C’est l’inverse du defer, on ne r\u00e9cup\u00e8re que certains champs.<\/p>\n
Cette petite fonction bien sympa prend une liste de pk et renvoie un dico des objets qui correspondent (les cl\u00e9s \u00e9tant les pk)<\/p>\n
Renvoie le dernier objet, ins\u00e9r\u00e9 dans la base, en se basant sur les dates et en utilisant le champ pass\u00e9 en param\u00e8tre (qui doit donc \u00eatre un champ\u00a0 date).
\nSi le model en question d\u00e9finit la Meta get_latest_by, on peut appeler latest sans argument.<\/p>\n
Ok, cette fonction ‘ne sert \u00e0 rien’ \u00e0 part pour rendre plus lisible le code. Mais bon, \u00e7a ne mange pas de pain. Et l’utilisation de la Meta get_latest_by permet de ‘centraliser’ la fa\u00e7on de rechercher le dernier, ce qui rendra une modification plus facile.<\/p>\n
Retourne un dico des valeurs d’aggr\u00e9gat calcul\u00e9s non pas objet par objet comme avec annotate, mais sur tout le queryset.<\/p>\n
A vous les sommes de champ, les moyennes ou autre. Vive les rapports :).<\/p>\n
et comme pour annotate, on peut contr\u00f4ler le nom, ici de la cl\u00e9, que notre valeur calcul\u00e9e.<\/p>\n
cette fonction n’existe pas encore dans django, elle sera pr\u00e9sente dans la 1.2. Elle permet tout simplement de savoir si le queryset est vide ou pas. (oui je sais, devoir attendre la 1.2 pour avoir cette fonction.. mais bon \ud83d\ude42 ).<\/p>\n","protected":false},"excerpt":{"rendered":"
Les queryset sont une des composantes importantes de Django. Comment en effet interagir avec la BD sans eux ? Mais est ce que cet outil si important et si souvent utilis\u00e9 est si bien connu que \u00e7a ? Parce que tout le monde connait count(), filter(), all() et exclude(). Mais qu’n est-il des autres m\u00e9thodes … Continue reading Petits tours des m\u00e9thodes des querysets.<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[6],"tags":[99,98],"class_list":["post-539","post","type-post","status-publish","format-standard","hentry","category-django","tag-django","tag-python"],"aioseo_notices":[],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p12cdp-8H","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/539","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/comments?post=539"}],"version-history":[{"count":2,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/539\/revisions"}],"predecessor-version":[{"id":541,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/posts\/539\/revisions\/541"}],"wp:attachment":[{"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/media?parent=539"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/categories?post=539"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/j-mad.com\/blog\/wp-json\/wp\/v2\/tags?post=539"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}