[3.1.x] Fixed #31689 -- Doc'd caveat about using bulk_create()'s ignore_conflicts on MariDB and MySQL.

Backport of 69e0d9c553 from master
This commit is contained in:
Tobias Krönke 2020-06-12 14:54:23 +02:00 committed by Mariusz Felisiak
parent 450df4a45a
commit 5ba2dfb9d0
1 changed files with 11 additions and 0 deletions

View File

@ -2108,6 +2108,17 @@ that fail constraints such as duplicate unique values. Enabling this parameter
disables setting the primary key on each model instance (if the database
normally supports it).
.. warning::
On MySQL and MariaDB, setting the ``ignore_conflicts`` parameter to
``True`` turns certain types of errors, other than duplicate key, into
warnings. Even with Strict Mode. For example: invalid values or
non-nullable violations. See the `MySQL documentation`_ and
`MariaDB documentation`_ for more details.
.. _MySQL documentation: https://dev.mysql.com/doc/refman/en/sql-mode.html#ignore-strict-comparison
.. _MariaDB documentation: https://mariadb.com/kb/en/ignore/
Returns ``objs`` as cast to a list, in the same order as provided.
.. versionchanged:: 3.1