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

Backport of 69e0d9c553bb55dde8d7d1d479a78bfa7093f406 from master
This commit is contained in:
Tobias Krönke 2020-06-12 14:54:23 +02:00 committed by Mariusz Felisiak
parent b61af177ee
commit 0afe8ba2d6

View File

@ -2100,6 +2100,17 @@ that fail constraints such as duplicate unique values. Enabling this parameter
disables setting the primary key on each model instance (if the database disables setting the primary key on each model instance (if the database
normally supports it). 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/
.. versionchanged:: 2.2 .. versionchanged:: 2.2
The ``ignore_conflicts`` parameter was added. The ``ignore_conflicts`` parameter was added.