related_nameと逆引き

本から著者への ForeignKey を設定しても、逆方向にたどることができます。reverse lookupを使うと、1側から多側にアクセスできます。

Django はデフォルトで、逆方向のアクセサーにmodelname_setという名前を付けます。著者から見ると、本は book_set として現れます。

book_set は完全なmanagerなので、通常のクエリと同じように filter、order_by、count をつなげて使えます。

_set という名前は扱いにくいものです。ForeignKey にrelated_nameを設定すると、逆方向のアクセサーにわかりやすい名前を自分で付けられます。

これで逆方向のアクセスが自然になります。book_set の代わりにbooksと書くだけでよく、はるかに読みやすくなります。

related_name は、関連をまたいだfilterにも使われます。もう一方のモデルから、double underscore と選択した名前を使います。

related_name を省略すると、逆方向のクエリ名は小文字のモデル名になります。たとえば author.objects.filter(book__title=...) のように記述します。

同じモデルから同じ対象への ForeignKey が2つあると、逆方向の名前が衝突します。それぞれに異なるrelated_nameを設定すれば解決できます。

related_name に+で終わる値を設定すると、逆方向のアクセサーを完全に無効にできます。必要のない場合に使用します。

related_query_nameを使うと、名前を分けられます。関連する行を読み取る属性とは別に、filter で使う名前を設定できます。

related_name はForeignKey、ManyToManyField、OneToOneField のすべてに適用できます。そのため、どの逆方向の経路にもわかりやすい名前を付けられます。

できました！reverse lookup を使うと関連を逆方向にたどれます。また、related_nameによって、扱いにくい _set アクセサーを明確で読みやすい名前に変更できます。🔄