Ticket #17788: 17788-warning-for-1.4.diff

docs/ref/models/querysets.txt

@@ -1371 +1371 @@
 * If the model's primary key is an :class:`~django.db.models.AutoField` it
   does not retrieve and set the primary key attribute, as ``save()`` does.
 
+.. admonition:: Limits of SQLite
+
+    SQLite sets a limit on the number of parameters per SQL statement. The
+    maximum is defined by the SQLITE_MAX_VARIABLE_NUMBER_ compilation option,
+    which defaults to 999. For instance, if your model has 8 fields (including
+    the primary key), you cannot create more than 999 // 8 = 124 instances at
+    a time. If you exceed this limit, you will get an exception::
+
+        django.db.utils.DatabaseError: too many SQL variables
+
+    If your application's performance requirements exceed SQLite's limits, it's
+    recommended to switch to another database engine, such as PostgreSQL.
+
+.. _SQLITE_MAX_VARIABLE_NUMBER: http://sqlite.org/limits.html#max_variable_number
+
 count
 ~~~~~