Browse files

Changed "exact" matches in MySQL to use the database's native collation.

This effectively reverses the change in [7798]. It was proving too difficult to
successfully manage all the side effects here and provide a satisfactory
solution for everybody. Many thanks to arne, Martin von Löwis and, particular,
Karen Tracey, for doing a lot of research and proto-patches here to establish what was possible and practical.

This is backwards incompatible if you were relying on the behaviour after
[7798]. The docs have been updated to indicate the solution.

Refs #2170, #7789, #8102.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
malcolmt committed Aug 12, 2008
1 parent ca71eac commit 6294fc7179011847d8a9f906cf4939ebf9852265
Showing with 15 additions and 8 deletions.
  1. +2 −2 django/db/backends/mysql/
  2. +13 −0 docs/db-api.txt
  3. +0 −6 tests/regressiontests/string_lookup/
@@ -153,9 +153,9 @@ def year_lookup_bounds(self, value):
return [first % value, second % value]
class DatabaseWrapper(BaseDatabaseWrapper):
operators = {
- 'exact': '= BINARY %s',
+ 'exact': '= %s',
'iexact': 'LIKE %s',
'contains': 'LIKE BINARY %s',
'icontains': 'LIKE %s',
@@ -1327,6 +1327,19 @@ changed in the development version. Previously, it was (intentionally)
converted to ``WHERE id = NULL`` at the SQL level, which would never match
anything. It has now been changed to behave the same as ``id__isnull=True``.
+.. admonition:: MySQL comparisons
+ In MySQL, whether or not ``exact`` comparisons are case-sensitive depends
+ upon the collation setting of the table involved. The default is usually
+ ``latin1_swedish_ci`` or ``utf8_swedish_ci``, which results in
+ case-insensitive comparisons. Change the collation to
+ ``latin1_swedish_cs`` or ``utf8_bin`` for case sensitive comparisons.
+ For more details, refer to the MySQL manual section about `character sets
+ and collations`_.
+.. _character sets and collations:
@@ -97,12 +97,6 @@ def __str__(self):
>>> Article.objects.get(text__exact='The quick brown fox jumps over the lazy dog.')
<Article: Article Test>
-# Regression tests for #2170: test case sensitiveness
->>> Article.objects.filter(text__exact='tHe qUick bRown fOx jUmps over tHe lazy dog.')
->>> Article.objects.filter(text__iexact='tHe qUick bRown fOx jUmps over tHe lazy dog.')
-[<Article: Article Test>]
>>> Article.objects.get(text__contains='quick brown fox')
<Article: Article Test>

0 comments on commit 6294fc7

Please sign in to comment.