summaryrefslogtreecommitdiff
path: root/docs/ref/models
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-21[5.2.x] Refs #36095 -- Doc'd that ManyToManyField.through supports lazy ↵Clifford Gama
relationships. Backport of eb4ea9c3efca479b169bed88a5521c4cf47ed2a2 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.
2025-03-04[5.2.x] Fixed #36128 -- Clarified auto-generated unique constraint on m2m ↵Clifford Gama
through models. Backport of ae2736ca3bf4c6a27e23ee95530ad965b550d4cc from main.
2025-02-20[5.2.x] Clarified admonition in GeneratedField docs.Adam Zapletal
Backport of 43766c70bd2939771b7f37104866316faa34606b from main.
2025-02-14[5.2.x] Corrected wording in docs/ref/models/constraints.txt.Luke Cousins
Backport of 579a1c99962c8697053974a70de635a997be63dc from main.
2025-01-24[5.2.x] Fixed ambiguous pronoun reference in docs/ref/models/fields.txt.Clifford Gama
Backport of 9cc3970eaaf603832c075618e61aea9ea430f719 from main.
2025-01-15Refs #36070 -- Referred to pk as an attribute when a composite primary key ↵Jacob Walls
is defined. This is to avoid confusion that a field is often associated with having a single associated database column.
2025-01-14Fixed #36051 -- Declared arity on aggregate functions.Jacob Walls
Follow-up to 4a66a69239c493c05b322815b18c605cd4c96e7c.
2025-01-14Fixed #36075 -- Documented how to introspect composite primary keys.Simon Charette
Document _meta.pk_fields and interactions between Field.primary_key and CompositePrimaryKey. Thanks Mariusz for the review.
2025-01-13Fixed #36077 -- Corrected docs on pk value where Model.save() executes an ↵Jacob Walls
UPDATE. The empty string is no longer special-cased since c2ba59fc1da5287d6286e2c2aca4083d5bafe056.
2025-01-07Refs #36042 -- Raised ValueError when providing composite expressions to ↵Jacob Walls
aggregates.
2025-01-06Fixed #35718 -- Add JSONArray to django.db.models.functions.John Parton
Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com> Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2024-12-16Refs #35718, Refs #32179 -- Moved JSONObject to django.db.models.functions.json.Sage Abdullah
2024-11-29Fixed #373 -- Added CompositePrimaryKey.Bendeguz Csirmaz
Thanks Lily Foote and Simon Charette for reviews and mentoring this Google Summer of Code 2024 project. Co-authored-by: Simon Charette <charette.s@gmail.com> Co-authored-by: Lily Foote <code@lilyf.org>
2024-10-30Fixed #35856 -- Added QuerySet.explain() support for MEMORY/SERIALIZE option ↵Anthony Joseph
on PostgreSQL 17+.
2024-10-29Corrected note on importing fields in model field reference docs.aruseni
2024-10-29Fixed typo in ref/models/fields.txt.Clifford Gama
2024-10-23Fixed #35731 -- Extended db_default docs.Yash
This added a missing db_default reference in docs/topics/db/models.txt, and added a reference to the DatabaseDefault object.
2024-10-17Fixed #26322 -- Consolidated lazy relationships details in ↵Clifford Gama
docs/ref/models/fields.txt. Reorganized docs to list and explain the types of lazy relationships that can be defined in related fields. Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2024-10-10Fixed #35103 -- Used provided error code and message when fields is set ↵gabn88
without a condition on UniqueConstraint.
2024-09-19Fixed #35748 -- Documented that fields are excluded from a ModelForm when ↵Clifford Gama
formfield() returns None. Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com>
2024-09-16Fixed #34887 -- Added support for unlimited models.CharField on SQLite.saJaeHyukc
Signed-off-by: saJaeHyukc <wogur981208@gmail.com>
2024-09-09Refs #373 -- Added Model._is_pk_set() abstraction to check if a Model's PK ↵Csirmaz Bendegúz
is set.
2024-08-28Removed outdated note about lack of subquery support in MySQL.Adam Johnson
2024-08-28Fixed typo in docs/ref/models/expressions.txt.Mariusz Felisiak
2024-08-28Fixed typo in docs/ref/models/expressions.txt.Mariusz Felisiak
2024-08-20Fixed #35671 -- Clarified string-based fields behavior when null=False.Clifford Gama
2024-08-12Fixed #35586 -- Added support for set-returning database functions.Devin Cox
Aggregation optimization didn't account for not referenced set-returning annotations on Postgres. Co-authored-by: Simon Charette <charette.s@gmail.com>
2024-08-05Used :pypi: role in docs where appropriate.Mariusz Felisiak
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-30Made cosmetic edits to code snippets reformatted with blacken-docs.Mariusz Felisiak
2024-05-23Fixed #24076 -- Added warnings on usage of dates with DateTimeField and ↵Adam Zapletal
datetimes with DateField.
2024-05-22Removed versionadded/changed annotations for 5.0.Natalia
This also removes remaining versionadded/changed annotations for older versions.
2024-05-14Fixed #35275 -- Fixed Meta.constraints validation crash on UniqueConstraint ↵Mariusz Felisiak
with OpClass(). This also introduces Expression.constraint_validation_compatible that allows specifying that expression should be ignored during a constraint validation.
2024-05-02Clarified when ImageField attributes are set.John Parton
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>
2024-03-21Added RowNumber() link in Rank() docs.Adam Zapletal
2024-03-18Refs #34059, Refs #34060 -- Removed outdated warning about validation of ↵Mariusz Felisiak
JSONField constraints. Known issues have been fixed in: - 0d8fbe2ade29f1b7bd9e6ba7a0281f5478603a43, - c991602ce5798385261381025c06698d7fd30dc5, and - 26aae5614487f58ddb1df5726224393887373ecd.
2024-03-15Refs #33996 -- Updated CheckConstraint validation on NULL values on Oracle 23c+.Mariusz Felisiak
Oracle 23c supports comparing boolean expressions.
2024-03-01Refs #35234 -- Deprecated CheckConstraint.check in favor of .condition.Simon Charette
Once the deprecation period ends CheckConstraint.check() can become the documented method that performs system checks for BaseConstraint subclasses.
2024-02-28Refs #34964 -- Doc'd that Q expression order is preserved.David Sanders
2024-02-17Fixed #28011 -- Corrected Field.hidden docs.Adam Johnson
2024-01-15Fixed #34949 -- Clarified when UniqueConstraints with include/nulls_distinct ↵jordanbae
are not created.
2024-01-15Fixed #28344 -- Allowed customizing queryset in ↵Aivars Kalvans
Model.refresh_from_db()/arefresh_from_db(). The from_queryset parameter can be used to: - use a custom Manager - lock the row until the end of transaction - select additional related objects
2024-01-02Fixed #35060 -- Deprecated passing positional arguments to Model.save()/asave().Salvo Polizzi