Индексы моделей, специфичные для 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:Добавлена поддержка функциональных уникальных ограничений.