summaryrefslogtreecommitdiff
path: root/docs/ref/models/querysets.txt
AgeCommit message (Collapse)Author
2025-04-02[5.2.x] Fixed #36213 -- Doc'd MySQL's handling of self-select updates in ↵Babak Mahmoudy
QuerySet.update(). Co-authored-by: Andro Ranogajec <ranogaet@gmail.com> Backport of be1b776ad8d6f9bccfbdf63f84b16fb81a13119e from main.
2025-03-14[5.2.x] Fixed pronoun disagreement in docs/ref/models/querysets.txt.Clifford Gama
Backport of ef6a83789b310a441237a190a493c9586a4cb260 from main.
2025-03-14[5.2.x] Corrected aggregation example in docs/ref/models/querysets.txt.Clifford Gama
Backport of 3235e76eb50be20756f82cb3bbe8e32cc586f7bb from main.
2025-03-13[5.2.x] Fixed incorrect formatting for inline pluralized code references in ↵Clifford Gama
docs. Backport of efe3ca09e029c63e25f6e19843cb0c68cc7fa816 from main.
2025-03-10[5.2.x] Fixed #36066 -- Documented that Q objects can be used directly in ↵samruddhiDharankar
annotations. Backport of 9120a19c4ecb643111b073dd1069e6b410a03c23 from main.
2024-10-30Fixed #35856 -- Added QuerySet.explain() support for MEMORY/SERIALIZE option ↵Anthony Joseph
on PostgreSQL 17+.
2024-08-28Removed outdated note about lack of subquery support in MySQL.Adam Johnson
2024-07-03Refs #28900 -- Made SELECT respect the order specified by values(*selected).Simon Charette
Previously the order was always extra_fields + model_fields + annotations with respective local ordering inferred from the insertion order of *selected. This commits introduces a new `Query.selected` propery that keeps tracks of the global select order as specified by on values assignment. This is crucial feature to allow the combination of queries mixing annotations and table references. It also allows the removal of the re-ordering shenanigans perform by ValuesListIterable in order to re-map the tuples returned from the database backend to the order specified by values_list() as they'll be in the right order at query compilation time. Refs #28553 as the initially reported issue that was only partially fixed for annotations by d6b6e5d0fd4e6b6d0183b4cf6e4bd4f9afc7bf67. Thanks Mariusz Felisiak and Sarah Boyce for review.
2024-05-22Removed versionadded/changed annotations for 5.0.Natalia
This also removes remaining versionadded/changed annotations for older versions.
2024-05-02Fixed rendering XOR section in docs.Mariusz Felisiak
2024-04-15Extended docs for Q() objects mentioning the ~ (NOT) operator.Mohammad Kazemi
Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com>
2023-11-29Updated conditions to retrieve primary keys in bulk_create() docs.KimSia Sim
2023-11-28Fixed #34633 -- Made create() method of reverse many-to-one managers clear ↵Aman Pandey
prefetch_related() cache.
2023-10-25Added missing pycon directives in various docs.Mariusz Felisiak
2023-10-25Fixed #27403 -- Doc'd that QuerySet.prefetch_related() doesn't guarantee ↵Tim Bell
transactional consistency. Added a note about the potential race condition in prefetch_related() that could produce an inconsistent result, one that does not correspond to any point in the database history.
2023-10-11Fixed #34808 -- Doc'd aggregate function's default argument.lufafajoshua
2023-09-26Fixed #34873 -- Added QuerySet.explain() support for GENERIC_PLAN option on ↵Mariusz Felisiak
PostgreSQL 16+.
2023-09-21Refs #34808 -- Doc'd that aggregation functions on empty groups can return None.David Sanders
2023-09-19Fixed #34850 -- Dropped support for MariaDB 10.4.Mariusz Felisiak
2023-09-18Removed versionadded/changed annotations for 4.2.Mariusz Felisiak
This also removes remaining versionadded/changed annotations for older versions.
2023-09-18Fixed #33651 -- Added support for prefetching GenericForeignKey.Clément Escolano
Co-authored-by: revanthgss <revanthgss@almabase.com> Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2023-09-16Corrected QuerySet.prefetch_related() note about GenericRelation().Mariusz Felisiak
GenericRelation is a reverse generic relationship so it's always homogeneous. Mentioning this as a restriction is confusing.
2023-08-04Fixed #34760 -- Dropped support for SQLite < 3.27.Mariusz Felisiak
2023-08-03Fixed #34761 -- Dropped support for MySQL < 8.0.11.Mariusz Felisiak
2023-07-31Fixed #34331 -- Added QuerySet.aiterator() support for prefetch_related().John Parton
2023-07-28Fixed #34749 -- Corrected QuerySet.acreate() signature in docs.John Parton
2023-07-20Fixed typo in docs/ref/models/querysets.txt.nessita
Removed assignment in example for Blog annotation to match shown result.
2023-07-20Refs #30052 -- Clarified that defer() and only() do not work with aggregated ↵Vyacheslav Dmitriev
fields.
2023-07-10Fixed #34698 -- Made QuerySet.bulk_create() retrieve primary keys when ↵Thomas Chaumeny
updating conflicts.
2023-06-27Fixed typo in docs/ref/models/querysets.txt.Mariusz Felisiak
2023-06-23Improved style of n-tuple wording in docs and comments.Nick Pope
2023-06-08Fixed #34604 -- Corrected fallback SQL for n-ary logical XOR.Anders Kaseorg
An n-ary logical XOR Q(…) ^ Q(…) ^ … ^ Q(…) should evaluate to true when an odd number of its operands evaluate to true, not when exactly one operand evaluates to true.
2023-04-27Doc'd that Count("*") is equivalent to COUNT(*) SQL.Tom Forbes
2023-04-21Added meaningful titles to ..admonition:: directives.Mariusz Felisiak
2023-04-20Fixed #34440 -- Doc'd that & queryset operator works similar to chaining.David Sanders
2023-03-01Fixed #34140 -- Reformatted code blocks in docs with blacken-docs.django-bot
2023-02-14Fixed #34280 -- Allowed specifying different field values for create ↵tschilling
operation in QuerySet.update_or_create().
2023-02-10Refs #34140 -- Applied rst code-block to non-Python examples.Carlton Gibson
Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for reviews.
2023-01-17Refs #29984 -- Made QuerySet.iterator() without chunk_size raise ValueError ↵Mariusz Felisiak
after prefetch_related(). Per deprecation timeline.
2023-01-17Refs #32365 -- Removed is_dst argument for various methods and functions.Mariusz Felisiak
Per deprecation timeline.
2023-01-17Removed versionadded/changed annotations for 4.1.Mariusz Felisiak
2022-12-06Fixed #24048 -- Corrected QuerySet.only() docs about interaction with defer().Ryan Cheley
2022-11-14Fixed #34099 -- Added release notes for QuerySet.update_or_create() changes.sarahboyce
Follow up to 6cc0f22a73970dd7c0d29d4d8d2ff9e1cc862b30. Thanks Phil Gyford for the report.
2022-11-10Updated documentation and comments for RFC updates.Nick Pope
- Updated references to RFC 1123 to RFC 5322 - Only partial as RFC 5322 sort of sub-references RFC 1123. - Updated references to RFC 2388 to RFC 7578 - Except RFC 2388 Section 5.3 which has no equivalent. - Updated references to RFC 2396 to RFC 3986 - Updated references to RFC 2616 to RFC 9110 - Updated references to RFC 3066 to RFC 5646 - Updated references to RFC 7230 to RFC 9112 - Updated references to RFC 7231 to RFC 9110 - Updated references to RFC 7232 to RFC 9110 - Updated references to RFC 7234 to RFC 9111 - Tidied up style of text when referring to RFC documents
2022-10-21Fixed typo in docs/ref/models/querysets.txt.Ryan Cheley
2022-07-26Fixed #33820 -- Doc'd "true"/"false"/"null" caveat for JSONField key ↵Mariusz Felisiak
transforms on SQLite. Thanks Johnny Metz for the report. Regression in 71ec102b01fcc85acae3819426a4e02ef423b0fa.
2022-05-17Removed versionadded/changed annotations for 4.0.Carlton Gibson
2022-04-26Fixed #33646 -- Added async-compatible interface to QuerySet.Andrew Godwin
Thanks Simon Charette for reviews. Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es> Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2022-03-17Added missing backticks to function names.Mariusz Felisiak
2022-03-04Fixed #29865 -- Added logical XOR support for Q() and querysets.Ryan Heard