Django
モデルフィールドリファレンス

パラメーター

備考

番号フィールド

数値フィールドの例を以下に示します。

自動フィールド

主に主キーに使用される自動インクリメント整数。

from django.db import models

class MyModel(models.Model):
    pk = models.AutoField()

各モデルは、デフォルトでプライマリキーフィールド（ idと呼ばれます）を取得します。したがって、プライマリキーの目的でモデル内にidフィールドを複製する必要はありません。

BigIntegerField

整数フィッティング番号-9223372036854775808に9223372036854775807 （ 8 Bytes ）。

from django.db import models

class MyModel(models.Model):
    number_of_seconds = models.BigIntegerField()

IntegerField

IntegerFieldは、-2147483648から2147483647（ 4 Bytes ）までの整数値を格納するために使用されます。

from django.db import models

class Food(models.Model):
    name = models.CharField(max_length=255)
    calorie = models.IntegerField(default=0)

defaultパラメータは必須ではありません。しかし、デフォルト値を設定すると便利です。

PositiveIntegerField

IntegerFieldと似ていますが、正またはゼロ（0）である必要があります。 PositiveIntegerFieldは、0〜2147483647（ 4 Bytes ）の整数値を格納するために使用されます。これは、意味的に陽性でなければならない分野で有用となり得る。例えば、カロリーで食べ物を記録している場合、それは否定的であってはなりません。このフィールドは、検証によって負の値を防止します。

from django.db import models

class Food(models.Model):
    name = models.CharField(max_length=255)
    calorie = models.PositiveIntegerField(default=0)

defaultパラメータは必須ではありません。しかし、デフォルト値を設定すると便利です。

SmallIntegerField

SmallIntegerFieldは、-32768〜32767（ 2 Bytes ）の整数値を格納するために使用されます。このフィールドは、極端ではない値に役立ちます。

from django.db import models

class Place(models.Model):
    name = models.CharField(max_length=255)
    temperature = models.SmallIntegerField(null=True)

PositiveSmallIntegerField

SmallIntegerFieldは、0〜32767（ 2 Bytes ）の整数値を格納するために使用されます。 SmallIntegerFieldと同じように、このフィールドは値が高くなく、意味的に正の値にするのに便利です。例えば、それは否定できない年齢を格納することができます。

from django.db import models

class Staff(models.Model):
    first_name = models.CharField(max_length=255)
    last_name = models.CharField(max_length=255)
    age = models.PositiveSmallIntegerField(null=True)

PositiveSmallIntegerFieldは選択肢として便利ですが、これはEnumを実装するジャンゴ型の方法です。

from django.db import models
from django.utils.translation import gettext as _

APPLICATION_NEW = 1
APPLICATION_RECEIVED = 2
APPLICATION_APPROVED = 3
APPLICATION_REJECTED = 4

APLICATION_CHOICES = (
    (APPLICATION_NEW, _('New')),
    (APPLICATION_RECEIVED, _('Received')),
    (APPLICATION_APPROVED, _('Approved')),
    (APPLICATION_REJECTED, _('Rejected')),
)

class JobApplication(models.Model):
    first_name = models.CharField(max_length=255)
    last_name = models.CharField(max_length=255)
    status = models.PositiveSmallIntegerField(
        choices=APLICATION_CHOICES, 
        default=APPLICATION_NEW
    )
    ...

状況に応じてクラス変数またはモジュール変数として選択肢を定義することは、それらを使用する良い方法です。選択肢がフレンドリーな名前なしでフィールドに渡されると、混乱が生まれます。

DecimalField

固定精度の10進数。PythonでDecimalインスタンスで表されます。 IntegerFieldとその派生物とは異なり、このフィールドには2つの必須引数があります。

1. DecimalField.max_digits ：数値に許される最大桁数。この数値はdecimal_places以上でなければならないことに注意してください。
2. DecimalField.decimal_places ：数値を格納する小数点以下の桁数です。

小数点以下3桁まで99を格納する場合は、 max_digits=5とdecimal_places=3使用する必要があります。

class Place(models.Model):
    name = models.CharField(max_length=255)
    atmospheric_pressure = models.DecimalField(max_digits=5, decimal_places=3)

BinaryField

これはバイナリデータの格納に使用される特殊なフィールドです。 バイトのみを受け付けます 。データは格納時にbase64シリアル化されます。

バイナリデータを格納するので、このフィールドはフィルタで使用できません。

from django.db import models

class MyModel(models.Model):
    my_binary_data = models.BinaryField()

CharField

CharFieldは、定義された長さのテキストを格納するために使用されます。以下の例では、最大128文字のテキストをフィールドに格納することができます。これよりも長い文字列を入力すると、検証エラーが発生します。

from django.db import models

class MyModel(models.Model):
    name = models.CharField(max_length=128, blank=True)

DateTimeField

DateTimeFieldは、日付の時刻値を格納するために使用されます。

class MyModel(models.Model):
    start_time = models.DateFimeField(null=True, blank=True)
    created_on = models.DateTimeField(auto_now_add=True)
    updated_on = models.DateTimeField(auto_now=True)

DateTimeFieldは、2つのオプションのパラメータがあります。

• auto_now_addは、オブジェクトの作成時にフィールドの値を現在のdatetimeに設定します。

• auto_nowは、フィールドが保存されるたびにフィールドの値を現在のdatetimeに設定します。

これらのオプションとdefaultパラメータは相互に排他的です。

外部キー

ForeignKeyフィールドは、モデル間のmany-to-one関係を作成するために使用されます。ほとんどの他のフィールドと同じように、位置的な引数が必要です。次の例は、carとownerの関係を示しています。

from django.db import models

class Person(models.Model):
    GENDER_FEMALE = 'F'
    GENDER_MALE = 'M'

    GENDER_CHOICES = (
        (GENDER_FEMALE, 'Female'),
        (GENDER_MALE, 'Male'),
    )

    first_name = models.CharField(max_length=100)
    last_name = models.CharField(max_length=100)
    gender = models.CharField(max_length=1, choices=GENDER_CHOICES)
    age = models.SmallIntegerField()


class Car(model.Model)
    owner = models.ForeignKey('Person')
    plate = models.CharField(max_length=15)
    brand = models.CharField(max_length=50)
    model = models.CharField(max_length=50)
    color = models.CharField(max_length=50)

フィールドの最初の引数は、モデルが関連するクラスです。 2番目の位置引数はon_delete引数です。現在のバージョンでは、この引数は必須ではありませんが、Django 2.0では必須です。引数のデフォルト機能は、次のように表示されます。

class Car(model.Model)
    owner = models.ForeignKey('Person', on_delete=models.CASCADE)
    ...

これにより、オーナーがPersonモデルから削除されたときに、モデルからCarオブジェクトが削除されます。これがデフォルトの機能です。

class Car(model.Model)
    owner = models.ForeignKey('Person', on_delete=models.PROTECT)
    ...

これにより、少なくとも1つのCarオブジェクトに関連しているPersonオブジェクトが削除されなくなります。 Personオブジェクトを参照するCarオブジェクトはすべて最初に削除する必要があります。そして、Personオブジェクトを削除することができます。