Что такое поле related_name в Django ORM?

Поле related_name в Django ORM используется для определения имени обратной связи от связанной модели к родительской. Это позволяет получить доступ к связанным объектам из родительской модели по явно заданному имени, вместо автоматически генерируемого _set.

Почему это важно?

related_name повышает читаемость кода и предотвращает конфликты имен, особенно когда одна модель имеет несколько внешних ключей к другой модели. Без него Django автоматически создает _set имя, которое может быть неоднозначным или неудобным.

Пример:

from django.db import models

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

    def __str__(self):
        return self.name

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(
        Author,
        on_delete=models.CASCADE,
        related_name='books' # Здесь задается related_name
    )

    def __str__(self):
        return self.title

В этом примере, вместо author.book_set.all(), вы можете получить все книги автора через author.books.all().

Ключевые особенности:

• Уникальность: related_name должен быть уникальным в пределах модели, к которой он относится.
• Отключение обратной связи: Использование related_name='+' полностью отключает создание обратной связи. Это полезно, когда обратный доступ не требуется, что может немного оптимизировать память или избежать ненужных связей.
• Множественные связи: Незаменимо при наличии нескольких ForeignKey или ManyToManyField полей, указывающих на одну и ту же модель, чтобы избежать конфликтов имен обратных связей.