Browse Source

Fixed #24925 -- Document using Coalesce on MySQL

Add warning for using Coalesce with python values on MySQL and document
workaround.
Ian Foote 9 years ago
parent
commit
14dead04ac
1 changed files with 11 additions and 0 deletions
  1. 11 0
      docs/ref/models/database-functions.txt

+ 11 - 0
docs/ref/models/database-functions.txt

@@ -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
 ------