【Django】データベース操作：データを新規で追加する方法（create()とsave()の違い）

save()

生成したモデルオブジェクトに対してsave()を使用することで、データベースに追加することができます。

単にデータベース登録するだけの場合は、save()メソッドの引数には何も指定しません。またsave()メソッドで返される値はありません。

すでに同じ値のプライマリーキーがあった場合は更新処理が行われます。

save()メソッドを使用する際に重要なのが、モデルクラスに引数（各フィールドに値）を渡してインスタンス化することです。

以下にsave()を利用したデータベースへのデータ追加のサンプルコードを記します。ここではSampleオブジェクトに対してtitle、authorフィールドに値を指定してデータ追加を行います。

from .models import Sample
def save_obj(request):
    obj = Sample(title="Django", author="Office54")
    obj.save()

Django公式サイトでは以下のようにsave()メソッドの使用法が記述されています。

>>> from blog.models import Blog
>>> b = Blog(name='Beatles Blog', tagline='All the latest Beatles news.')
>>> b.save()

>>> blog = Blog(name='トーク', tagline='チーズ')
>>> blog.id    # Noneが返されます。なぜならblogオブジェクトはidを持っていないため
>>> blog.save()
>>> blog.id     # 追加されたオブジェクトのIDが返されます

上記コードのようにモデルクラスに各フィールドに値を指定してオブジェクトを生成します。そして生成したオブジェクトに対してsave()メソッドを使用することでデータベースに追加されます。

上記コードで出てくるidとは、そのデータを識別するフィールドです。
各モデルには特別設定していない限り、デフォルトでidという名前のプライマリーキーであるAutoFieldを持ちます。

Djangoのモデルという仕組みについて詳しく学びたい方は、以下記事をご参照ください。

【Django】Model（モデル）とは：models.pyの書き方とデータベース連携（テーブル作成）

create()

データベースのデータ追加はQuerySetメソッドのcreate()メソッドを利用して実現することもできます。

save()メソッドとの違いとして、save()はモデルクラスから生成したオブジェクトに対して実行したのに対して、create()は以下のようにワンステップでオブジェクトの生成と追加を行います。

p = Person.objects.create(first_name="Bruce", last_name="Springsteen")

上記コードで利用しているobjectsとは、マネージャーと呼ばれるデータベースへのクエリ操作を提供するインターフェースです。

create()に似たメソッドにget_or_create()やupdate_or_create()などもあります。これらはすでにデータが存在した場合に取得または更新するメソッドです。