Метод set

Метод set применяется к менеджеру связанных объектов и заменяет текущий набор связанных объектов на указанный. Он доступен для отношений ManyToManyField и ForeignKey (через обратную связь). В качестве аргумента метод принимает итерабельный объект с идентификаторами или экземплярами моделей. Для отношения многие-ко-многим метод выполняет атомарную замену всего набора, автоматически удаляя старые связи и добавляя новые.

Синтаксис

pythoninstance.related_manager.set(objs)

Где instance - экземпляр модели, имеющий связанное поле, а related_manager - менеджер связанных объектов. Параметр objs - список идентификаторов или экземпляров моделей, которые должны стать новым набором связанных объектов.

Пример . Для ManyToManyField

Пусть у нас есть модели Article и Category со связью многие-ко-многим. Заменим все категории для конкретной статьи на новые:

pythonfrom myapp.models import Article, Category

article = Article.objects.get(pk=1)
new_categories = Category.objects.filter(name__in=['python', 'django'])
article.categories.set(new_categories)

Можно также передать список идентификаторов:

pythonfrom myapp.models import Article

article = Article.objects.get(pk=1)
article.categories.set([1, 2, 3])

Пример . Для ForeignKey

Для внешнего ключа метод set доступен через обратную связь. Заменим все статьи для конкретного автора:

pythonfrom myapp.models import Author, Article

author = Author.objects.get(pk=1)
new_articles = Article.objects.filter(status='published')
author.article_set.set(new_articles)

Пример . С добавлением и удалением

Метод set полностью заменяет набор, удаляя все связи, которые не входят в новый список. Поэтому его использование эквивалентно последовательному вызову clear и add:

pythonfrom myapp.models import Article, Category

article = Article.objects.get(pk=1)
category_ids = [4, 5, 6]

# Полная замена набора
article.categories.set(category_ids)

При передаче пустого списка метод очищает все связи:

pythonfrom myapp.models import Article

article = Article.objects.get(pk=1)
article.categories.set([])

Пример . С использованием bulk

Метод set автоматически использует bulk-операции для оптимизации производительности. Это делает его эффективным при работе с большими наборами данных:

pythonfrom myapp.models import Article, Category

article = Article.objects.get(pk=1)
categories = Category.objects.filter(is_active=True)

# Оптимизированная замена набора
article.categories.set(categories)

Смотрите также