2017-06-27 19:15:15 +00:00
|
|
|
from django.conf import settings
|
|
|
|
from django.db import connection, models
|
2018-09-13 07:34:02 +00:00
|
|
|
from django.db.models.query_utils import Q
|
2019-01-12 21:14:54 +00:00
|
|
|
from django.test import SimpleTestCase, TestCase, skipUnlessDBFeature
|
2017-12-05 20:05:10 +00:00
|
|
|
from django.test.utils import isolate_apps
|
2016-06-25 16:32:56 +00:00
|
|
|
|
2017-03-17 15:25:12 +00:00
|
|
|
from .models import Book, ChildModel1, ChildModel2
|
2016-06-25 16:32:56 +00:00
|
|
|
|
|
|
|
|
2019-01-12 21:14:54 +00:00
|
|
|
class SimpleIndexesTests(SimpleTestCase):
|
2017-02-15 18:33:55 +00:00
|
|
|
|
|
|
|
def test_suffix(self):
|
|
|
|
self.assertEqual(models.Index.suffix, 'idx')
|
2016-06-25 16:32:56 +00:00
|
|
|
|
|
|
|
def test_repr(self):
|
|
|
|
index = models.Index(fields=['title'])
|
|
|
|
multi_col_index = models.Index(fields=['title', 'author'])
|
2018-09-13 07:34:02 +00:00
|
|
|
partial_index = models.Index(fields=['title'], name='long_books_idx', condition=Q(pages__gt=400))
|
2016-06-25 16:32:56 +00:00
|
|
|
self.assertEqual(repr(index), "<Index: fields='title'>")
|
|
|
|
self.assertEqual(repr(multi_col_index), "<Index: fields='title, author'>")
|
2018-09-13 07:34:02 +00:00
|
|
|
self.assertEqual(repr(partial_index), "<Index: fields='title', condition=(AND: ('pages__gt', 400))>")
|
2016-06-25 16:32:56 +00:00
|
|
|
|
|
|
|
def test_eq(self):
|
|
|
|
index = models.Index(fields=['title'])
|
|
|
|
same_index = models.Index(fields=['title'])
|
|
|
|
another_index = models.Index(fields=['title', 'author'])
|
2016-06-20 15:50:05 +00:00
|
|
|
index.model = Book
|
|
|
|
same_index.model = Book
|
|
|
|
another_index.model = Book
|
2016-06-25 16:32:56 +00:00
|
|
|
self.assertEqual(index, same_index)
|
|
|
|
self.assertNotEqual(index, another_index)
|
|
|
|
|
2016-08-14 00:00:51 +00:00
|
|
|
def test_index_fields_type(self):
|
2018-03-08 15:56:55 +00:00
|
|
|
with self.assertRaisesMessage(ValueError, 'Index.fields must be a list or tuple.'):
|
2016-08-14 00:00:51 +00:00
|
|
|
models.Index(fields='title')
|
|
|
|
|
2018-03-08 15:56:55 +00:00
|
|
|
def test_fields_tuple(self):
|
|
|
|
self.assertEqual(models.Index(fields=('title',)).fields, ['title'])
|
|
|
|
|
2016-06-25 16:32:56 +00:00
|
|
|
def test_raises_error_without_field(self):
|
|
|
|
msg = 'At least one field is required to define an index.'
|
|
|
|
with self.assertRaisesMessage(ValueError, msg):
|
|
|
|
models.Index()
|
|
|
|
|
2017-10-11 17:25:52 +00:00
|
|
|
def test_opclasses_requires_index_name(self):
|
|
|
|
with self.assertRaisesMessage(ValueError, 'An index must be named to use opclasses.'):
|
|
|
|
models.Index(opclasses=['jsonb_path_ops'])
|
|
|
|
|
|
|
|
def test_opclasses_requires_list_or_tuple(self):
|
|
|
|
with self.assertRaisesMessage(ValueError, 'Index.opclasses must be a list or tuple.'):
|
|
|
|
models.Index(name='test_opclass', fields=['field'], opclasses='jsonb_path_ops')
|
|
|
|
|
|
|
|
def test_opclasses_and_fields_same_length(self):
|
|
|
|
msg = 'Index.fields and Index.opclasses must have the same number of elements.'
|
|
|
|
with self.assertRaisesMessage(ValueError, msg):
|
|
|
|
models.Index(name='test_opclass', fields=['field', 'other'], opclasses=['jsonb_path_ops'])
|
|
|
|
|
2018-09-13 07:34:02 +00:00
|
|
|
def test_condition_requires_index_name(self):
|
|
|
|
with self.assertRaisesMessage(ValueError, 'An index must be named to use condition.'):
|
|
|
|
models.Index(condition=Q(pages__gt=400))
|
|
|
|
|
|
|
|
def test_condition_must_be_q(self):
|
|
|
|
with self.assertRaisesMessage(ValueError, 'Index.condition must be a Q instance.'):
|
|
|
|
models.Index(condition='invalid', name='long_book_idx')
|
|
|
|
|
2016-06-25 16:32:56 +00:00
|
|
|
def test_name_auto_generation(self):
|
|
|
|
index = models.Index(fields=['author'])
|
2016-07-18 14:29:47 +00:00
|
|
|
index.set_name_with_model(Book)
|
2016-06-25 16:32:56 +00:00
|
|
|
self.assertEqual(index.name, 'model_index_author_0f5565_idx')
|
|
|
|
|
2016-07-22 12:52:44 +00:00
|
|
|
# '-' for DESC columns should be accounted for in the index name.
|
|
|
|
index = models.Index(fields=['-author'])
|
|
|
|
index.set_name_with_model(Book)
|
|
|
|
self.assertEqual(index.name, 'model_index_author_708765_idx')
|
|
|
|
|
2016-06-25 16:32:56 +00:00
|
|
|
# fields may be truncated in the name. db_column is used for naming.
|
|
|
|
long_field_index = models.Index(fields=['pages'])
|
2016-07-18 14:29:47 +00:00
|
|
|
long_field_index.set_name_with_model(Book)
|
2016-06-25 16:32:56 +00:00
|
|
|
self.assertEqual(long_field_index.name, 'model_index_page_co_69235a_idx')
|
|
|
|
|
|
|
|
# suffix can't be longer than 3 characters.
|
|
|
|
long_field_index.suffix = 'suff'
|
|
|
|
msg = 'Index too long for multiple database support. Is self.suffix longer than 3 characters?'
|
|
|
|
with self.assertRaisesMessage(AssertionError, msg):
|
2016-07-18 14:29:47 +00:00
|
|
|
long_field_index.set_name_with_model(Book)
|
2016-06-25 16:32:56 +00:00
|
|
|
|
2017-12-05 20:05:10 +00:00
|
|
|
@isolate_apps('model_indexes')
|
|
|
|
def test_name_auto_generation_with_quoted_db_table(self):
|
|
|
|
class QuotedDbTable(models.Model):
|
|
|
|
name = models.CharField(max_length=50)
|
|
|
|
|
|
|
|
class Meta:
|
|
|
|
db_table = '"t_quoted"'
|
|
|
|
|
|
|
|
index = models.Index(fields=['name'])
|
|
|
|
index.set_name_with_model(QuotedDbTable)
|
|
|
|
self.assertEqual(index.name, 't_quoted_name_e4ed1b_idx')
|
|
|
|
|
2016-06-25 16:32:56 +00:00
|
|
|
def test_deconstruction(self):
|
2017-06-27 19:15:15 +00:00
|
|
|
index = models.Index(fields=['title'], db_tablespace='idx_tbls')
|
2016-06-20 15:50:05 +00:00
|
|
|
index.set_name_with_model(Book)
|
2016-06-25 16:32:56 +00:00
|
|
|
path, args, kwargs = index.deconstruct()
|
|
|
|
self.assertEqual(path, 'django.db.models.Index')
|
|
|
|
self.assertEqual(args, ())
|
2017-06-27 19:15:15 +00:00
|
|
|
self.assertEqual(
|
|
|
|
kwargs,
|
|
|
|
{'fields': ['title'], 'name': 'model_index_title_196f42_idx', 'db_tablespace': 'idx_tbls'}
|
|
|
|
)
|
2017-03-17 15:25:12 +00:00
|
|
|
|
2018-09-13 07:34:02 +00:00
|
|
|
def test_deconstruct_with_condition(self):
|
|
|
|
index = models.Index(
|
|
|
|
name='big_book_index',
|
|
|
|
fields=['title'],
|
|
|
|
condition=Q(pages__gt=400),
|
|
|
|
)
|
|
|
|
index.set_name_with_model(Book)
|
|
|
|
path, args, kwargs = index.deconstruct()
|
|
|
|
self.assertEqual(path, 'django.db.models.Index')
|
|
|
|
self.assertEqual(args, ())
|
|
|
|
self.assertEqual(
|
|
|
|
kwargs,
|
|
|
|
{
|
|
|
|
'fields': ['title'],
|
|
|
|
'name': 'model_index_title_196f42_idx',
|
|
|
|
'condition': Q(pages__gt=400),
|
|
|
|
}
|
|
|
|
)
|
|
|
|
|
2017-03-17 15:25:12 +00:00
|
|
|
def test_clone(self):
|
|
|
|
index = models.Index(fields=['title'])
|
|
|
|
new_index = index.clone()
|
|
|
|
self.assertIsNot(index, new_index)
|
|
|
|
self.assertEqual(index.fields, new_index.fields)
|
|
|
|
|
2017-06-07 14:13:12 +00:00
|
|
|
def test_name_set(self):
|
|
|
|
index_names = [index.name for index in Book._meta.indexes]
|
2019-07-05 12:15:41 +00:00
|
|
|
self.assertCountEqual(
|
|
|
|
index_names,
|
|
|
|
[
|
|
|
|
'model_index_title_196f42_idx',
|
|
|
|
'model_index_isbn_34f975_idx',
|
|
|
|
'model_indexes_book_barcode_idx',
|
|
|
|
],
|
|
|
|
)
|
2017-06-07 14:13:12 +00:00
|
|
|
|
2017-03-17 15:25:12 +00:00
|
|
|
def test_abstract_children(self):
|
|
|
|
index_names = [index.name for index in ChildModel1._meta.indexes]
|
2019-07-05 12:15:41 +00:00
|
|
|
self.assertEqual(
|
|
|
|
index_names,
|
|
|
|
['model_index_name_440998_idx', 'model_indexes_childmodel1_idx'],
|
|
|
|
)
|
2017-03-17 15:25:12 +00:00
|
|
|
index_names = [index.name for index in ChildModel2._meta.indexes]
|
2019-07-05 12:15:41 +00:00
|
|
|
self.assertEqual(
|
|
|
|
index_names,
|
|
|
|
['model_index_name_b6c374_idx', 'model_indexes_childmodel2_idx'],
|
|
|
|
)
|
2017-06-27 19:15:15 +00:00
|
|
|
|
2019-01-12 21:14:54 +00:00
|
|
|
|
|
|
|
class IndexesTests(TestCase):
|
|
|
|
|
2017-06-27 19:15:15 +00:00
|
|
|
@skipUnlessDBFeature('supports_tablespaces')
|
|
|
|
def test_db_tablespace(self):
|
2019-01-12 19:26:24 +00:00
|
|
|
editor = connection.schema_editor()
|
|
|
|
# Index with db_tablespace attribute.
|
|
|
|
for fields in [
|
|
|
|
# Field with db_tablespace specified on model.
|
|
|
|
['shortcut'],
|
|
|
|
# Field without db_tablespace specified on model.
|
|
|
|
['author'],
|
|
|
|
# Multi-column with db_tablespaces specified on model.
|
|
|
|
['shortcut', 'isbn'],
|
|
|
|
# Multi-column without db_tablespace specified on model.
|
|
|
|
['title', 'author'],
|
|
|
|
]:
|
|
|
|
with self.subTest(fields=fields):
|
|
|
|
index = models.Index(fields=fields, db_tablespace='idx_tbls2')
|
|
|
|
self.assertIn('"idx_tbls2"', str(index.create_sql(Book, editor)).lower())
|
|
|
|
# Indexes without db_tablespace attribute.
|
|
|
|
for fields in [['author'], ['shortcut', 'isbn'], ['title', 'author']]:
|
|
|
|
with self.subTest(fields=fields):
|
|
|
|
index = models.Index(fields=fields)
|
|
|
|
# The DEFAULT_INDEX_TABLESPACE setting can't be tested because
|
|
|
|
# it's evaluated when the model class is defined. As a
|
|
|
|
# consequence, @override_settings doesn't work.
|
|
|
|
if settings.DEFAULT_INDEX_TABLESPACE:
|
|
|
|
self.assertIn(
|
|
|
|
'"%s"' % settings.DEFAULT_INDEX_TABLESPACE,
|
|
|
|
str(index.create_sql(Book, editor)).lower()
|
|
|
|
)
|
|
|
|
else:
|
|
|
|
self.assertNotIn('TABLESPACE', str(index.create_sql(Book, editor)))
|
|
|
|
# Field with db_tablespace specified on the model and an index without
|
|
|
|
# db_tablespace.
|
|
|
|
index = models.Index(fields=['shortcut'])
|
|
|
|
self.assertIn('"idx_tbls"', str(index.create_sql(Book, editor)).lower())
|