多字段搜索时数据库索引用法及Django多对多索引优化疑问

示例模型代码 #

from django.db import models

class Card(models.Model):
    title = models.CharField(max_length=255)
    description = models.CharField(max_length=1024)

    tags = models.ManyToManyField(
        Tag,
        related_name="cards",
    )

    class Meta:
        indexes = [
            ["title", "description"],
        ]

class Tag(models.Model):
    uuid = models.UUIDField(default=uuid4, primary_key=True)
    title = models.CharField(max_length=255, unique=True)

自定义搜索逻辑 #

from django.db.models import Q

def custom_filter_queryset(queryset, text):
    return queryset.filter(
        Q(title__contains=text) | Q(description__contains=text)
    ).distinct()

custom_filter_queryset(Card.objects.all().prefetch_related("tags"), "...")

问题解答 #

1. 是否正确利用了已创建的字段索引？ #

没有，当前查询完全没用到你定义的title+description复合索引，核心原因有两点：

• 你用__contains实现全模糊匹配（对应SQL的LIKE '%xxx%'），而PostgreSQL默认的B-tree索引无法加速这类中间/后缀模糊匹配，仅支持前缀匹配（__startswith）或精确匹配场景。
• 就算是前缀匹配，你的查询用了OR逻辑关联两个字段的条件，复合索引的结构是先按title排序再按description，这种跨字段的OR查询也无法利用该复合索引——复合索引仅适用于包含前缀字段的连续查询条件。

如果要优化这个模糊查询的性能，建议改用PostgreSQL的** trigram索引**（GIN或GIST类型）：

1. 先在PostgreSQL中执行CREATE EXTENSION pg_trgm;安装扩展
2. 在Django模型中定义trigram索引：

from django.contrib.postgres.indexes import GinIndex

class Card(models.Model):
    # ... 原有字段 ...
    class Meta:
        indexes = [
            GinIndex(fields=['title'], name='card_title_trigram'),
            GinIndex(fields=['description'], name='card_desc_trigram'),
        ]

之后可以用__trigram_similar或__trigram_word_similar替代__contains，这类查询能有效利用trigram索引提升速度。

2. 能否创建索引以优化多对多关联数据的获取？ #

可以，但Django已经默认给多对多中间表创建了必要的索引，大部分场景下无需额外手动创建：

• Django自动生成的多对多中间表包含card_id和tag_id两个外键字段，且会分别为这两个字段创建单独的B-tree索引，同时还会生成(card_id, tag_id)的复合唯一索引（避免重复关联）。
• 你当前用的prefetch_related("tags")会先查询符合条件的Card，再通过WHERE tag_id IN (...)批量查询关联的Tag，这个过程会自动用到中间表的tag_id索引，效率已经有保障。

如果有特殊查询场景（比如频繁根据Tag过滤Card，同时叠加Card的其他字段条件），可以自定义中间表并添加复合索引优化：

class CardTag(models.Model):
    card = models.ForeignKey(Card, on_delete=models.CASCADE)
    tag = models.ForeignKey(Tag, on_delete=models.CASCADE)

    class Meta:
        unique_together = ('card', 'tag')
        indexes = [
            models.Index(fields=['tag', 'card']),  # 优化从Tag反向查询Card的关联场景
        ]

class Card(models.Model):
    # ... 原有字段 ...
    tags = models.ManyToManyField(Tag, through=CardTag, related_name="cards")

这种复合索引可以加速同时涉及Tag和Card字段的过滤查询。

内容的提问来源于stack exchange，提问作者marqueewinq