summaryrefslogtreecommitdiff
path: root/docs/ref/contrib/postgres
diff options
context:
space:
mode:
authorMariusz Felisiak <felisiak.mariusz@gmail.com>2023-01-06 13:53:42 +0100
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2023-01-17 11:49:15 +0100
commit0be8095b254fad65b2480d677ebe6098c41bbad6 (patch)
tree0c084fdc30cbcc0e7cb7e76955b20316da137396 /docs/ref/contrib/postgres
parent43b01300b7c7e9d24b549a408010e52a09726060 (diff)
downloaddjango-0be8095b254fad65b2480d677ebe6098c41bbad6.tar.gz
Refs #10929 -- Stopped forcing empty result value by PostgreSQL aggregates.
Per deprecation timeline.
Diffstat (limited to 'docs/ref/contrib/postgres')
-rw-r--r--docs/ref/contrib/postgres/aggregates.txt27
1 files changed, 12 insertions, 15 deletions
diff --git a/docs/ref/contrib/postgres/aggregates.txt b/docs/ref/contrib/postgres/aggregates.txt
index 79cfa8432b..d304a75ce1 100644
--- a/docs/ref/contrib/postgres/aggregates.txt
+++ b/docs/ref/contrib/postgres/aggregates.txt
@@ -52,12 +52,11 @@ General-purpose aggregation functions
from django.db.models import F
F('some_field').desc()
- .. deprecated:: 4.0
+ .. versionchanged:: 5.0
- If there are no rows and ``default`` is not provided, ``ArrayAgg``
- returns an empty list instead of ``None``. This behavior is deprecated
- and will be removed in Django 5.0. If you need it, explicitly set
- ``default`` to ``Value([])``.
+ In older versions, if there are no rows and ``default`` is not
+ provided, ``ArrayAgg`` returned an empty list instead of ``None``. If
+ you need it, explicitly set ``default`` to ``Value([])``.
``BitAnd``
----------
@@ -173,12 +172,11 @@ General-purpose aggregation functions
{'parking': True, 'double_bed': True}
]}]>
- .. deprecated:: 4.0
+ .. versionchanged:: 5.0
- If there are no rows and ``default`` is not provided, ``JSONBAgg``
- returns an empty list instead of ``None``. This behavior is deprecated
- and will be removed in Django 5.0. If you need it, explicitly set
- ``default`` to ``Value('[]')``.
+ In older versions, if there are no rows and ``default`` is not
+ provided, ``JSONBAgg`` returned an empty list instead of ``None``. If
+ you need it, explicitly set ``default`` to ``Value([])``.
``StringAgg``
-------------
@@ -232,12 +230,11 @@ General-purpose aggregation functions
'headline': 'NASA uses Python', 'publication_names': 'Science News, The Python Journal'
}]>
- .. deprecated:: 4.0
+ .. versionchanged:: 5.0
- If there are no rows and ``default`` is not provided, ``StringAgg``
- returns an empty string instead of ``None``. This behavior is
- deprecated and will be removed in Django 5.0. If you need it,
- explicitly set ``default`` to ``Value('')``.
+ In older versions, if there are no rows and ``default`` is not
+ provided, ``StringAgg`` returned an empty string instead of ``None``.
+ If you need it, explicitly set ``default`` to ``Value("")``.
Aggregate functions for statistics
==================================