{"title":"Relations plusieurs-à-un","version":"1.11","locale":"fr","docname":"topics/db/examples/many_to_one","url":"/fr/1.11/topics/db/examples/many_to_one/","canonical":"https://djangodocs.dev/fr/1.11/topics/db/examples/many_to_one/","summary":"Pour définir une relation plusieurs-à-un, utilisez ForeignKey. Dans ce qui suit, vous trouverez des exemples d’opérations pouvant être effectuées en…","html":"

Relations plusieurs-à-unLien vers cette rubrique#

\n

Pour définir une relation plusieurs-à-un, utilisez ForeignKey:

\n
Code
from django.db import models\n\nclass Reporter(models.Model):\n    first_name = models.CharField(max_length=30)\n    last_name = models.CharField(max_length=30)\n    email = models.EmailField()\n\n    def __str__(self):              # __unicode__ on Python 2\n        return "%s %s" % (self.first_name, self.last_name)\n\nclass Article(models.Model):\n    headline = models.CharField(max_length=100)\n    pub_date = models.DateField()\n    reporter = models.ForeignKey(Reporter, on_delete=models.CASCADE)\n\n    def __str__(self):              # __unicode__ on Python 2\n        return self.headline\n\n    class Meta:\n        ordering = ('headline',)\n
\n

Dans ce qui suit, vous trouverez des exemples d’opérations pouvant être effectuées en utilisant les possibilités de l’API Python.

\n

Créez quelques objets Reporter :

\n
Python console
>>> r = Reporter(first_name='John', last_name='Smith', email='john@example.com')\n>>> r.save()\n\n>>> r2 = Reporter(first_name='Paul', last_name='Jones', email='paul@example.com')\n>>> r2.save()\n
\n

Créez un objet Article :

\n
Python console
>>> from datetime import date\n>>> a = Article(id=None, headline="This is a test", pub_date=date(2005, 7, 27), reporter=r)\n>>> a.save()\n\n>>> a.reporter.id\n1\n\n>>> a.reporter\n<Reporter: John Smith>\n
\n

Notez que vous devez enregistrer un objet avant de pouvoir l’attribuer à une relation de clé étrangère. Par exemple, la création d’un Article avec une instance Reporter non enregistrée produit une erreur ValueError:

\n
Python console
>>> r3 = Reporter(first_name='John', last_name='Smith', email='john@example.com')\n>>> Article.objects.create(headline="This is a test", pub_date=date(2005, 7, 27), reporter=r3)\nTraceback (most recent call last):\n...\nValueError: save() prohibited to prevent data loss due to unsaved related object 'reporter'.\n
\n

Les objets Article ont accès à leurs objets Reporter liés :

\n
Python console
>>> r = a.reporter\n
\n

Avec Python 2, il s’agit de chaînes de type str et non pas de chaînes Unicode car c’est ce qui a été utilisé lors de la création du reporter (et nous n’avons pas actualisé les données depuis la base de données, celle-ci renvoyant toujours des chaînes Unicode) :

\n
Python console
>>> r.first_name, r.last_name\n('John', 'Smith')\n
\n

Créez un objet Article au travers de l’objet Reporter :

\n
Python console
>>> new_article = r.article_set.create(headline="John's second story", pub_date=date(2005, 7, 29))\n>>> new_article\n<Article: John's second story>\n>>> new_article.reporter\n<Reporter: John Smith>\n>>> new_article.reporter.id\n1\n
\n

Créez un nouvel article et ajoutez-le au jeu d’articles du reporter :

\n
Python console
>>> new_article2 = Article.objects.create(headline="Paul's story", pub_date=date(2006, 1, 17))\n>>> r.article_set.add(new_article2)\n>>> new_article2.reporter\n<Reporter: John Smith>\n>>> new_article2.reporter.id\n1\n>>> r.article_set.all()\n<QuerySet [<Article: John's second story>, <Article: Paul's story>, <Article: This is a test>]>\n
\n

Ajoutez le même article à un autre jeu d’articles et vérifiez qu’il a bien été déplacé :

\n
Python console
>>> r2.article_set.add(new_article2)\n>>> new_article2.reporter.id\n2\n>>> new_article2.reporter\n<Reporter: Paul Jones>\n
\n

L’ajout d’un objet du mauvais type lève une exception TypeError :

\n
Python console
>>> r.article_set.add(r2)\nTraceback (most recent call last):\n...\nTypeError: 'Article' instance expected, got <Reporter: Paul Jones>\n\n>>> r.article_set.all()\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n>>> r2.article_set.all()\n<QuerySet [<Article: Paul's story>]>\n\n>>> r.article_set.count()\n2\n\n>>> r2.article_set.count()\n1\n
\n

Notez que dans l’exemple précédent, l’article a été déplacé de John à Paul.

\n

Les gestionnaires de relations acceptent aussi les recherches par champ. L’API suit automatiquement les relations à la profondeur nécessaire. Utilisez les doubles soulignements pour séparer les relations. Cela fonctionne à autant de niveaux que nécessaire, sans limite. Par exemple :

\n
Python console
>>> r.article_set.filter(headline__startswith='This')\n<QuerySet [<Article: This is a test>]>\n\n# Find all Articles for any Reporter whose first name is "John".\n>>> Article.objects.filter(reporter__first_name='John')\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n
\n

Une correspondance exacte est sous-entendue ici :

\n
Python console
>>> Article.objects.filter(reporter__first_name='John')\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n
\n

Double requête sur le champ lié. Cela se traduit par une condition AND dans la clause WHERE :

\n
Python console
>>> Article.objects.filter(reporter__first_name='John', reporter__last_name='Smith')\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n
\n

Pour la recherche sur la liaison, il est possible d’indiquer une clé primaire ou de transmettre explicitement l’objet lié :

\n
Python console
>>> Article.objects.filter(reporter__pk=1)\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n>>> Article.objects.filter(reporter=1)\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n>>> Article.objects.filter(reporter=r)\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n\n>>> Article.objects.filter(reporter__in=[1,2]).distinct()\n<QuerySet [<Article: John's second story>, <Article: Paul's story>, <Article: This is a test>]>\n>>> Article.objects.filter(reporter__in=[r,r2]).distinct()\n<QuerySet [<Article: John's second story>, <Article: Paul's story>, <Article: This is a test>]>\n
\n

Vous pouvez aussi utiliser un résultat de requête (queryset) au lieu d’une liste explicite d’instances :

\n
Python console
>>> Article.objects.filter(reporter__in=Reporter.objects.filter(first_name='John')).distinct()\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n
\n

Requêtes dans la direction inverse :

\n
Python console
>>> Reporter.objects.filter(article__pk=1)\n<QuerySet [<Reporter: John Smith>]>\n>>> Reporter.objects.filter(article=1)\n<QuerySet [<Reporter: John Smith>]>\n>>> Reporter.objects.filter(article=a)\n<QuerySet [<Reporter: John Smith>]>\n\n>>> Reporter.objects.filter(article__headline__startswith='This')\n<QuerySet [<Reporter: John Smith>, <Reporter: John Smith>, <Reporter: John Smith>]>\n>>> Reporter.objects.filter(article__headline__startswith='This').distinct()\n<QuerySet [<Reporter: John Smith>]>\n
\n

Le comptage dans la direction inverse fonctionne en combinant avec distinct() :

\n
Python console
>>> Reporter.objects.filter(article__headline__startswith='This').count()\n3\n>>> Reporter.objects.filter(article__headline__startswith='This').distinct().count()\n1\n
\n

Les requêtes en boucle sont possibles :

\n
Python console
>>> Reporter.objects.filter(article__reporter__first_name__startswith='John')\n<QuerySet [<Reporter: John Smith>, <Reporter: John Smith>, <Reporter: John Smith>, <Reporter: John Smith>]>\n>>> Reporter.objects.filter(article__reporter__first_name__startswith='John').distinct()\n<QuerySet [<Reporter: John Smith>]>\n>>> Reporter.objects.filter(article__reporter=r).distinct()\n<QuerySet [<Reporter: John Smith>]>\n
\n

Si vous supprimez un reporter, ses articles seront supprimés (en supposant que la clé étrangère a été créée avec l’attribut django.db.models.ForeignKey.on_delete défini à CASCADE, ce qui est la valeur par défaut) :

\n
Python console
>>> Article.objects.all()\n<QuerySet [<Article: John's second story>, <Article: Paul's story>, <Article: This is a test>]>\n>>> Reporter.objects.order_by('first_name')\n<QuerySet [<Reporter: John Smith>, <Reporter: Paul Jones>]>\n>>> r2.delete()\n>>> Article.objects.all()\n<QuerySet [<Article: John's second story>, <Article: This is a test>]>\n>>> Reporter.objects.order_by('first_name')\n<QuerySet [<Reporter: John Smith>]>\n
\n

Vous pouvez effectuer une suppression en utilisant une jointure (JOIN) dans la requête :

\n
Python console
>>> Reporter.objects.filter(article__headline__startswith='This').delete()\n>>> Reporter.objects.all()\n<QuerySet []>\n>>> Article.objects.all()\n<QuerySet []>\n
","rootId":"many-to-one-relationships","toc":[],"breadcrumbs":[{"docname":"topics/index","title":"Utilisation de Django","url":"/fr/1.11/topics/"},{"docname":"topics/db/index","title":"Modèles et bases de données","url":"/fr/1.11/topics/db/"},{"docname":"topics/db/examples/index","title":"Exemples d’utilisation de l’API de relations entre modèles","url":"/fr/1.11/topics/db/examples/"}],"prev":{"docname":"topics/db/examples/many_to_many","title":"Relations plusieurs-à-plusieurs","url":"/fr/1.11/topics/db/examples/many_to_many/"},"next":{"docname":"topics/db/examples/one_to_one","title":"Relations un-à-un","url":"/fr/1.11/topics/db/examples/one_to_one/"},"formats":{"html":"/fr/1.11/topics/db/examples/many_to_one/","markdown":"/fr/1.11/topics/db/examples/many_to_one.md","json":"/fr/1.11/topics/db/examples/many_to_one.json"},"source":"https://github.com/django/django/blob/stable/1.11.x/docs/topics/db/examples/many_to_one.txt","official":"https://docs.djangoproject.com/fr/1.11/topics/db/examples/many_to_one/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","fr","ja","id","pt-br","ko","es","el","pl"]}