Индексы моделей, специфичные для PostgreSQL¶
Ниже перечислены специфические для PostgreSQL indexes, доступные из модуля django.contrib.postgres.indexes.
BloomIndex¶
-
class
BloomIndex(*expressions, length=None, columns=(), **options)[исходный код]¶ Создает индекс bloom.
Чтобы использовать этот индексный доступ, необходимо активировать расширение bloom на PostgreSQL. Вы можете установить его с помощью операции миграции
BloomExtension.Задайте целое число бит от 1 до 4096 в параметре
lengthдля указания длины каждой записи индекса. По умолчанию в PostgreSQL используется значение 80.Аргумент
columnsпринимает кортеж или список до 32 значений, которые представляют собой целое число битов от 1 до 4095.Changed in Django 3.2:Позиционный аргумент
*expressionsбыл добавлен для поддержки функциональных индексов.
BrinIndex¶
-
class
BrinIndex(*expressions, autosummarize=None, pages_per_range=None, **options)[исходный код]¶ Создает BRIN index.
Установите параметр
autosummarizeв значениеTrue, чтобы включить automatic summarization для выполнения автовакуумирования.Аргумент
pages_per_rangeпринимает целое положительное число.Changed in Django 3.2:Позиционный аргумент
*expressionsбыл добавлен для поддержки функциональных индексов.
BTreeIndex¶
-
class
BTreeIndex(*expressions, fillfactor=None, **options)[исходный код]¶ Создает индекс B-дерева.
Введите целочисленное значение от 10 до 100 в параметр fillfactor, чтобы настроить степень заполнения страниц индекса. По умолчанию в PostgreSQL используется значение 90.
Changed in Django 3.2:Позиционный аргумент
*expressionsбыл добавлен для поддержки функциональных индексов.
GinIndex¶
-
class
GinIndex(*expressions, fastupdate=None, gin_pending_list_limit=None, **options)[исходный код]¶ Создает gin index.
Чтобы использовать этот индекс на типах данных, не входящих в built-in operator classes, необходимо активировать btree_gin extension на PostgreSQL. Вы можете установить его с помощью операции миграции
BtreeGinExtension.Установите параметр
fastupdateв значениеFalse, чтобы отключить GIN Fast Update Technique, который включен по умолчанию в PostgreSQL.Введите целое число байт в параметр gin_pending_list_limit, чтобы настроить максимальный размер списка ожидающих GIN, который используется, когда включено
fastupdate.Changed in Django 3.2:Позиционный аргумент
*expressionsбыл добавлен для поддержки функциональных индексов.
GistIndex¶
-
class
GistIndex(*expressions, buffering=None, fillfactor=None, **options)[исходный код]¶ Создает индекс GiST index. Эти индексы автоматически создаются на пространственных полях с
spatial_index=True. Они также полезны на других типах, таких какHStoreFieldили range fields.Чтобы использовать этот индекс на типах данных, не входящих во встроенный gist operator classes, необходимо активировать btree_gist extension на PostgreSQL. Вы можете установить его с помощью операции миграции
BtreeGistExtension.Установите параметр
bufferingв значениеTrueилиFalse, чтобы вручную включить или выключить buffering build индекса.Введите целочисленное значение от 10 до 100 в параметр fillfactor, чтобы настроить степень заполнения страниц индекса. По умолчанию в PostgreSQL используется значение 90.
Changed in Django 3.2:Позиционный аргумент
*expressionsбыл добавлен для поддержки функциональных индексов.
HashIndex¶
-
class
HashIndex(*expressions, fillfactor=None, **options)[исходный код]¶ Создает хэш-индекс.
Введите целочисленное значение от 10 до 100 в параметр fillfactor, чтобы настроить степень заполнения страниц индекса. По умолчанию в PostgreSQL используется значение 90.
Используйте этот индекс только в PostgreSQL 10 и более поздних версиях
Хэш-индексы доступны в PostgreSQL уже давно, но в старых версиях они страдают от ряда проблем с целостностью данных.
Changed in Django 3.2:Позиционный аргумент
*expressionsбыл добавлен для поддержки функциональных индексов.
SpGistIndex¶
-
class
SpGistIndex(*expressions, fillfactor=None, **options)[исходный код]¶ Создает SP-GiST index.
Введите целочисленное значение от 10 до 100 в параметр fillfactor, чтобы настроить степень заполнения страниц индекса. По умолчанию в PostgreSQL используется значение 90.
Changed in Django 3.2:Позиционный аргумент
*expressionsбыл добавлен для поддержки функциональных индексов.
OpClass() выражения¶
-
class
OpClass(expression, name)[исходный код]¶ Выражение
OpClass()представляетexpressionс пользовательским operator class, который может использоваться для определения функциональных индексов или уникальных ограничений. Чтобы использовать его, необходимо добавить'django.contrib.postgres'в вашINSTALLED_APPS. Установите параметрnameв имя operator class.Например:
Index( OpClass(Lower('username'), name='varchar_pattern_ops'), name='lower_username_idx', )
создает индекс на
Lower('username'), используяvarchar_pattern_ops.Другой пример:
UniqueConstraint( OpClass(Upper('description'), name='text_pattern_ops'), name='upper_description_unique', )
создает уникальное ограничение на
Upper('description'), используяtext_pattern_ops.Changed in Django 4.0:Добавлена поддержка функциональных уникальных ограничений.