]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commit
- Document the most transparent way to set JSON.NULL for
authorMike Bayer <mike_mp@zzzcomputing.com>
Thu, 18 May 2017 21:44:10 +0000 (17:44 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Thu, 18 May 2017 21:46:18 +0000 (17:46 -0400)
commit32300ea9faf7fe0681a90bf096ae7d3c891637d8
treeffb7890cf789770202ef2a607609e846a98fc4e4
parentc050a449def1d01d0bf0d108f4b1d18696da1a89
- Document the most transparent way to set JSON.NULL for
a column default.

The JSON.NULL value is special in that while it is a Python-side
value, it represents "do this special behavior", and is not at all
like any other Python-side value for which normally, that's exactly
the type of data we want back.   So in this case, encourage the user
to use a SQL expression that is exact, so in the ORM context, you get
back what was actually persisted in the column.  There's some variants
of this such as literal(JSON.NULL, JSON) but text("'null'") is simpler.

Change-Id: I0339fafdc03e4b2f533d53970b2f74c774f2687b
Fixes: #3923
(cherry picked from commit 4d4ea792e7ea7945de9c9b1e005ce09b2feb45b5)
lib/sqlalchemy/sql/sqltypes.py