Browse Source

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

Tobias Krönke 4 years ago
parent
commit
69e0d9c553
1 changed files with 11 additions and 0 deletions
  1. 11 0
      docs/ref/models/querysets.txt

+ 11 - 0
docs/ref/models/querysets.txt

@@ -2119,6 +2119,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