Уникальные для PostgreSQL поиски
Сходство триграмм
trigram_similar
Поиск trigram_similar позволяет выполнять поиск по триграммам, измеряя количество общих триграмм (три последовательных символа) с помощью специального расширения PostgreSQL. Поиск по триграммам получает выражение и возвращает результаты, имеющие коэффициент сходства, превышающий текущий порог сходства.
Для его использования добавьте 'django.contrib.postgres' в свой INSTALLED_APPS и активируйте расширение pg_trgm в PostgreSQL. Вы можете установить расширение, используя операцию миграции TrigramExtension.
Поиск trigram_similar может использоваться для CharField и TextField:
>>> City.objects.filter(name__trigram_similar="Middlesborough") ['<City: Middlesbrough>']
trigram_word_similar
Поиск trigram_word_similar позволяет выполнять поиск по сходству триграмм слов с использованием специального расширения PostgreSQL. Его можно приблизительно понимать как измерение максимального количества общих триграмм между параметром и любым подстрокой поля. Поиск по триграммам слов получает выражение и возвращает результаты, имеющие коэффициент сходства слов, превышающий текущий порог сходства.
Для его использования добавьте 'django.contrib.postgres' в свой INSTALLED_APPS и активируйте расширение pg_trgm в PostgreSQL. Вы можете установить расширение, используя операцию миграции TrigramExtension.
Поиск trigram_word_similar может использоваться для CharField и TextField:
>>> Sentence.objects.filter(name__trigram_word_similar="Middlesborough") ['<Sentence: Gumby rides on the path of Middlesbrough>']
trigram_strict_word_similar
Аналогично trigram_word_similar, за исключением того, что он принудительно заставляет границы совпадать с границами слов.
Для его использования добавьте 'django.contrib.postgres' в свой INSTALLED_APPS и активируйте расширение pg_trgm в PostgreSQL. Вы можете установить расширение, используя операцию миграции TrigramExtension.
Поиск trigram_strict_word_similar может использоваться для CharField и TextField.
Unaccent
Поиск unaccent позволяет выполнять поиск, не учитывая знаки ударения, с помощью специального расширения PostgreSQL.
Этот поиск реализован с помощью Transform, поэтому его можно комбинировать с другими функциями поиска. Для его использования необходимо добавить 'django.contrib.postgres' в свой INSTALLED_APPS и активировать расширение unaccent в PostgreSQL. Операция миграции UnaccentExtension доступна, если вы хотите выполнить эту активацию с помощью миграций.
Поиск unaccent может использоваться для CharField и TextField:
>>> City.objects.filter(name__unaccent="México") ['<City: Mexico>'] >>> User.objects.filter(first_name__unaccent__startswith="Jerem") ['<User: Jeremy>', '<User: Jérémy>', '<User: Jérémie>', '<User: Jeremie>']
Предупреждение
Поиски, использующие этот фильтр, в большинстве случаев должны работать хорошо. Однако запросы с использованием этого фильтра, как правило, выполняют полное сканирование таблицы, что может быть медленным для больших таблиц. В таких случаях может быть целесообразно использовать специализированные инструменты полнотекстового индексирования.
© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/5.2/ref/contrib/postgres/lookups/
