Prefetch_related for reverse relations in Django

Introduction

Prefetch_related helps you get related data from the database in one go. For reverse relations, it fetches all related objects efficiently, so your app runs faster and uses fewer database queries.

You want to show a list of authors with all their books without extra database hits.

You need to display categories with all products in each category on a page.

You want to load all comments for a blog post efficiently.

You are building an admin panel showing users and their orders together.

Syntax

Django

Model.objects.prefetch_related('reverse_relation_name')

Use the name of the reverse relation as defined by related_name or the default modelname_set.

Prefetch_related works well for many-to-many and one-to-many reverse relations.

Examples

Fetch all authors and their books using the default reverse relation name book_set.

Django

authors = Author.objects.prefetch_related('book_set')

Fetch categories and all related products using a custom related_name='products'.

Django

categories = Category.objects.prefetch_related('products')

Load posts with all their comments efficiently.

Django

posts = Post.objects.prefetch_related('comments')

Sample Program

This example defines two models: Author and Book. Each Book links to an Author. We use prefetch_related('book_set') to get all books for each author in one database query. Then we print each author and their books.

Django

from django.db import models

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(Author, on_delete=models.CASCADE)

# Usage in a view or script
authors = Author.objects.prefetch_related('book_set')
for author in authors:
    print(f"Author: {author.name}")
    for book in author.book_set.all():
        print(f" - Book: {book.title}")

Important Notes

Always use prefetch_related for reverse relations to avoid many database queries inside loops.

If you set related_name on the ForeignKey, use that name instead of the default modelname_set.

Prefetch_related returns a queryset that you can iterate over just like normal querysets.

Summary

Prefetch_related fetches reverse related objects efficiently.

Use the reverse relation name to prefetch related data in one query.

This improves performance by reducing database hits in loops.

Practice

1. What is the main purpose of using prefetch_related with reverse relations in Django?

easy

A. To update related objects in bulk

B. To fetch related objects in a single query and reduce database hits

C. To delete related objects automatically

D. To create new related objects during query

Solution

1. Step 1: Understand what prefetch_related does

   prefetch_related fetches related objects in a separate query but combines results in Python to reduce database hits.

2. Step 2: Apply this to reverse relations

   Using prefetch_related on reverse relations loads all related objects efficiently, avoiding queries inside loops.

3. Final Answer:

   To fetch related objects in a single query and reduce database hits -> Option B

4. Quick Check:

   prefetch_related reduces queries [OK]

Hint: Remember: prefetch_related loads reverse relations in one go [OK]

Common Mistakes:

• Thinking prefetch_related deletes or updates data
• Confusing prefetch_related with select_related
• Assuming it creates new objects automatically

2. Which of the following is the correct syntax to prefetch a reverse relation named comments on a Post model?

easy

A. Post.objects.prefetch_related(comments)

B. Post.objects.select_related('comments')

C. Post.objects.prefetch('comments')

D. Post.objects.prefetch_related('comments')

Solution

1. Step 1: Recall the correct method name

   The correct method to prefetch related objects is prefetch_related, not prefetch or select_related for reverse relations.

2. Step 2: Check the argument format

   The related name must be a string inside quotes, so 'comments' is correct, not a variable without quotes.

3. Final Answer:

   Post.objects.prefetch_related('comments') -> Option D

4. Quick Check:

   Correct method and string argument [OK]

Hint: Use prefetch_related('relation_name') with quotes [OK]

Common Mistakes:

• Using select_related for reverse relations
• Omitting quotes around relation name
• Using a non-existent method like prefetch()

3. Given these models:

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    author = models.ForeignKey(Author, related_name='books', on_delete=models.CASCADE)
    title = models.CharField(max_length=100)

What will this code print?

authors = Author.objects.prefetch_related('books')
for author in authors:
    print(author.name, [book.title for book in author.books.all()])

medium

A. Prints author names but book lists are empty

B. Raises an error because 'books' is not a valid relation

C. Prints each author name with a list of their book titles without extra queries

D. Prints author names but causes a query for each author inside the loop

Solution

1. Step 1: Understand the model relation

   Each Author has many Book objects accessible via the reverse relation books.

2. Step 2: Analyze the prefetch_related effect

   Using prefetch_related('books') loads all books for all authors in one extra query, so no queries happen inside the loop.

3. Final Answer:

   Prints each author name with a list of their book titles without extra queries -> Option C

4. Quick Check:

   prefetch_related loads reverse relations efficiently [OK]

Hint: prefetch_related loads reverse sets before looping [OK]

Common Mistakes:

• Thinking prefetch_related causes errors if relation exists
• Assuming empty lists because of missing select_related
• Believing queries run inside the loop despite prefetch

4. What is wrong with this code snippet?

posts = Post.objects.prefetch_related('comment_set')
for post in posts:
    print(post.title, [c.text for c in post.comment_set.all()])

Assuming Comment model has a ForeignKey to Post without a related_name set.

medium

A. Using 'comment_set' is correct; no error here

B. Should use 'comments' instead of 'comment_set' in prefetch_related

C. Must use select_related instead of prefetch_related for reverse relations

D. The code will raise an AttributeError because 'comment_set' is invalid

Solution

1. Step 1: Understand default reverse relation naming

   If no related_name is set on a ForeignKey, Django uses modelname_set as the reverse relation name, here comment_set.

2. Step 2: Check usage in prefetch_related and loop

   Using prefetch_related('comment_set') and accessing post.comment_set.all() is correct and will work without error.

3. Final Answer:

   Using 'comment_set' is correct; no error here -> Option A

4. Quick Check:

   Default reverse name = modelname_set [OK]

Hint: Default reverse name is modelname_set if no related_name [OK]

Common Mistakes:

• Assuming related_name is always 'comments'
• Using select_related for reverse relations
• Expecting an error when using default reverse name

5. You want to efficiently load all Author objects with their Book objects, but only books published after 2020. How do you use prefetch_related for this filtered reverse relation?

authors = Author.objects.prefetch_related( ... )

hard

A. Use Prefetch with a filtered queryset: Prefetch('books', queryset=Book.objects.filter(pub_year__gt=2020))

B. Use prefetch_related('books').filter(pub_year__gt=2020)

C. Use select_related('books').filter(pub_year__gt=2020)

D. Use prefetch_related('books__filter(pub_year__gt=2020)')

Solution

1. Step 1: Understand filtering reverse relations with prefetch_related

   To filter related objects in prefetch_related, use the Prefetch object with a filtered queryset.

2. Step 2: Apply Prefetch with filtered queryset

   Use Prefetch('books', queryset=Book.objects.filter(pub_year__gt=2020)) inside prefetch_related() to load only books after 2020.

3. Final Answer:

   Use Prefetch with a filtered queryset: Prefetch('books', queryset=Book.objects.filter(pub_year__gt=2020)) -> Option A

4. Quick Check:

   Filtered prefetch needs Prefetch object [OK]

Hint: Use Prefetch with filtered queryset inside prefetch_related [OK]

Common Mistakes:

• Trying to filter directly inside prefetch_related string
• Using select_related for many-to-one reverse relations
• Filtering the main queryset instead of related queryset