Commit 14dead04 authored by Ian Foote's avatar Ian Foote Committed by Marc Tamlyn
Browse files

Fixed #24925 -- Document using Coalesce on MySQL

Add warning for using Coalesce with python values on MySQL and document
workaround.
parent 4ab53a55
Loading
Loading
Loading
Loading
+11 −0
Original line number Diff line number Diff line
@@ -55,6 +55,17 @@ Usage examples::
    >>> print(aggregated['combined_age_default'])
    None

.. warning::

    A python value passed to ``Coalesce`` on MySQL may be converted to an
    incorrect type unless explicitly cast to the correct database type:

    >>> from django.db.models.expressions import RawSQL
    >>> from django.utils import timezone
    >>> now = timezone.now()
    >>> now_sql = RawSQL("cast(%s as datetime)", (now,))
    >>> Coalesce('updated', now_sql)

Concat
------