summaryrefslogtreecommitdiff
path: root/docs/internals
diff options
context:
space:
mode:
authorNick Pope <nick@nickpope.me.uk>2021-06-30 00:08:27 +0100
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2021-07-19 13:41:16 +0200
commitfee87345967b3d917b618533585076cbfa43451b (patch)
tree202561eec2284ce1bd3ae4793d32ac346b068848 /docs/internals
parent501a8db46595b2d5b99c1d3b1146a832f43cdf1c (diff)
Refs #10929 -- Deprecated forced empty result value for PostgreSQL aggregates.
This deprecates forcing a return value for ArrayAgg, JSONBAgg, and StringAgg when there are no rows in the query. Now that we have a ``default`` argument for aggregates, we want to revert to returning the default of ``None`` which most aggregate functions return and leave it up to the user to decide what they want to be returned by default.
Diffstat (limited to 'docs/internals')
-rw-r--r--docs/internals/deprecation.txt4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt
index c56b875aed..16801e0345 100644
--- a/docs/internals/deprecation.txt
+++ b/docs/internals/deprecation.txt
@@ -30,6 +30,10 @@ details on these changes.
* The ``extra_tests`` argument for ``DiscoverRunner.build_suite()`` and
``DiscoverRunner.run_tests()`` will be removed.
+* The ``django.contrib.postgres.aggregates.ArrayAgg``, ``JSONBAgg``, and
+ ``StringAgg`` aggregates will return ``None`` when there are no rows instead
+ of ``[]``, ``[]``, and ``''`` respectively.
+
.. _deprecation-removed-in-4.1:
4.1