Индексы моделей, специфичные для 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() выражения

New in Django 3.2.
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:

Добавлена поддержка функциональных уникальных ограничений.

Вернуться на верх