Django では、すべてのモデルに主キーが存在します。デフォルトでは、この主キーは単一のフィールドで構成されます。
\nほとんどの場合、単一の主キーで十分です。しかし、データベース設計においては、複数のフィールドからなる主キーが必要になることもあります。
\n複合主キーを使用するには、モデルを定義する際に pk 属性を CompositePrimaryKey に設定します：
class Product(models.Model):\n name = models.CharField(max_length=100)\n\n\nclass Order(models.Model):\n reference = models.CharField(max_length=20, primary_key=True)\n\n\nclass OrderLineItem(models.Model):\n pk = models.CompositePrimaryKey("product_id", "order_id")\n product = models.ForeignKey(Product, on_delete=models.CASCADE)\n order = models.ForeignKey(Order, on_delete=models.CASCADE)\n quantity = models.IntegerField()\nこれにより、Django はテーブル作成時に複合主キー（ PRIMARY KEY (product_id, order_id) ）を作成するようになります。
複合主キーは tuple （タプル）で表現されます：
>>> product = Product.objects.create(name="apple")\n>>> order = Order.objects.create(reference="A755H")\n>>> item = OrderLineItem.objects.create(product=product, order=order, quantity=1)\n>>> item.pk\n(1, "A755H")\npk 属性に tuple を代入することで、対応するフィールドの値をまとめて設定できます：
>>> item = OrderLineItem(pk=(2, "B142C"))\n>>> item.pk\n(2, "B142C")\n>>> item.product_id\n2\n>>> item.order_id\n"B142C"\n複合主キーは、 tuple を使ってフィルタリングできます：
>>> OrderLineItem.objects.filter(pk=(1, "A755H")).count()\n1\nリレーションシップフィールド (GenericForeignKey を含む) や Django 管理サイトにおける複合主キーのサポートは、現在も開発中です。現時点では、複合主キーを持つモデルは Django の管理サイトに登録できません。将来のリリースで対応が追加される予定です。
Django は、テーブル作成後に複合主キーへマイグレーションしたり、それを元に戻したりする操作をサポートしていません。また、複合主キーにフィールドを追加・削除することもサポートされていません。
\n既存のテーブルを単一の主キーから複合主キーに移行したい場合は、利用中のデータベースバックエンドの手順にしたがって操作してください。
\n複合主キーを設定できたら、モデルに CompositePrimaryKey フィールドを追加してください。これにより、Django はその複合主キーを正しく認識し、適切に扱えるようになります。
主キーフィールドに対するマイグレーション操作（たとえば AddField や AlterField ）はサポートされていませんが、 makemigrations は変更を検出します。
エラーを避けるために、上記のようなマイグレーションは --fake オプションを付けて適用することを推奨します。
代わりに、 SeparateDatabaseAndState を使うことで、データベース固有のマイグレーションと Django による状態管理用マイグレーションを、1つの操作としてまとめて実行することもできます。
リレーションシップフィールド (ジェネリックリレーション を含む) は、複合主キーをサポートしていません。
\nたとえば先ほどの OrderLineItem モデルにおいて、次のような使い方はサポートされていません：
class Foo(models.Model):\n item = models.ForeignKey(OrderLineItem, on_delete=models.CASCADE)\nこれは、現在 ForeignKey が複合主キーを持つモデルを参照できないためです。
この制限を回避するには、代わりに ForeignObject が使えます：
class Foo(models.Model):\n item_order_id = models.CharField(max_length=20)\n item_product_id = models.IntegerField()\n item = models.ForeignObject(\n OrderLineItem,\n on_delete=models.CASCADE,\n from_fields=("item_order_id", "item_product_id"),\n to_fields=("order_id", "product_id"),\n )\nForeignObject は ForeignKey によく似ていますが、データベース上にカラム (例: item_id)、外部キー制約、インデックスなどを作成しない点、 on_delete 引数が無視される点が異なります。
多くのデータベース関数は、単一の式しか受け付けません。
\nMAX("order_id") -- OK\nMAX("product_id", "order_id") -- ERROR\n複合主キーは複数のカラム表現を含むため、このような関数に渡すと、 ValueError が発生します。 ただし Count だけは例外で、複合主キーでも利用できます。
Max("order_id") # OK\nMax("pk") # ValueError\nCount("pk") # OK\n複合主キーは仮想フィールドであり、単一のデータベースカラムを表さないため、ModelForm には含まれません。
\nたとえば、次のようなフォームを考えてみましょう：
\nclass OrderLineItemForm(forms.ModelForm):\n class Meta:\n model = OrderLineItem\n fields = "__all__"\nこのフォームには、複合主キーのための pk フィールドは含まれません：
>>> OrderLineItemForm()\n<OrderLineItemForm bound=False, valid=Unknown, fields=(product;order;quantity)>\n複合主キーである pk をフォームフィールドとして指定しようとすると、存在しないフィールドとして FieldError が発生します。
pk は仮想フィールドなので、 Model.clean_fields() の exclude 引数に pk を指定しても効果はありません。複合主キーの各フィールドをバリデーションから除外したい場合は、それぞれのフィールド名を個別に指定してください。一方、 Model.validate_unique() に対しては exclude={"pk"} を指定することで、一意性のチェックをスキップできます。
複合主キーが導入される前は、モデルの主キーとなる単一フィールドを見つけたいとき、各フィールドの primary_key 属性を確認するだけで済みました：
>>> pk_field = None\n>>> for field in Product._meta.get_fields():\n... if field.primary_key:\n... pk_field = field\n... break\n...\n>>> pk_field\n<django.db.models.fields.AutoField: id>\nしかし primary key 属性はひとつのモデルにつき最大ひとつのフィールドしか True を取れないという制約があるため、複合主キーのもとではすべて False になってしまい、これでは主キーを構成するフィールドを特定するためには使えません。
>>> pk_fields = []\n>>> for field in OrderLineItem._meta.get_fields():\n... if field.primary_key:\n... pk_fields.append(field)\n...\n>>> pk_fields\n[]\n複合主キーに正しく対応するコードを書くためには、代わりに _meta.pk_fields 属性を使用してください：
>>> Product._meta.pk_fields\n[<django.db.models.fields.AutoField: id>]\n>>> OrderLineItem._meta.pk_fields\n[\n <django.db.models.fields.ForeignKey: product>,\n <django.db.models.fields.ForeignKey: order>\n]\n