summaryrefslogtreecommitdiff
path: root/docs/ref/models
AgeCommit message (Collapse)Author
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
2023-12-30Fixed #29049 -- Added slicing notation to F expressions.Nick Pope
Co-authored-by: Priyansh Saxena <askpriyansh@gmail.com> Co-authored-by: Niclas Olofsson <n@niclasolofsson.se> Co-authored-by: David Smith <smithdc@gmail.com> Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com> Co-authored-by: Abhinav Yadav <abhinav.sny.2002@gmail.com>
2023-12-28Corrected code-block directives in docs.Mariusz Felisiak
2023-12-15Added missing import in docs/ref/models/expressions.txt.Viicos
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-11-14Fixed #34944 -- Made GeneratedField.output_field required.Mariusz Felisiak
Regression in f333e3513e8bdf5ffeb6eeb63021c230082e6f95.
2023-11-09Fixed typos in docs/ref/models/fields.txt.Jacob Walls
2023-10-30Refs #29850 -- Added exclusion support to window frames.Sarah Boyce
2023-10-28Refs #29850 -- Added RowRange support for positive integer start and ↵Sarah Boyce
negative integer end.
2023-10-28Fixed typos in docs/ref/models/expressions.txt.Sarah Boyce