プログラミング

Djangoモデルの基本操作

最終更新： 28/02/2025
1分未満

DjangoはPythonを使った強力なウェブフレームワークで、モデルを活用することでデータベースとのやり取りを効率的に行うことができます。この記事では、Djangoのモデル（Models）の使い方を深掘りし、実際にどのようにモデルを定義し、データベースに接続して操作するかを詳しく説明します。

1. モデルの基本

Djangoのモデルは、データベースのテーブルと1対1で対応します。モデルは、Pythonのクラスとして定義され、その属性がデータベースのフィールドに対応します。DjangoはORM（Object Relational Mapping）を利用して、Pythonのオブジェクトとデータベースのレコードをマッピングします。

関連記事

モデルの定義

モデルを定義するには、django.db.models.Modelを継承したクラスを作成します。このクラスの中で、データベースに保存したいフィールドを定義します。例えば、簡単な「ブログ投稿」を管理するモデルを作成する場合、以下のように定義します。

python
from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    published_date = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.title

この例では、Postというモデルを定義し、title（タイトル）、content（内容）、published_date（公開日時）の3つのフィールドを設定しています。__str__メソッドは、Django管理画面などでオブジェクトを表示するときに表示する文字列を定義しています。

2. モデルをデータベースに反映させる

モデルを定義した後、Djangoはその定義を基にデータベースにテーブルを作成するためのマイグレーションを生成します。このプロセスは、以下の手順で行います。

マイグレーションの作成

まず、以下のコマンドでマイグレーションを作成します。

bash
python manage.py makemigrations

このコマンドを実行すると、migrationsディレクトリ内にマイグレーションファイルが作成されます。次に、データベースにマイグレーションを適用します。

マイグレーションの適用

以下のコマンドで、マイグレーションをデータベースに適用します。

bash
python manage.py migrate

これにより、Postモデルに基づいてデータベースにテーブルが作成されます。

3. モデルを操作する

モデルを定義し、マイグレーションを適用した後、Djangoシェルを使って実際にデータの操作を行うことができます。Djangoシェルは、PythonのインタラクティブシェルをDjangoプロジェクトに組み込んだもので、モデルの操作を簡単に行えます。

Djangoシェルの起動

以下のコマンドでDjangoシェルを起動します。

bash
python manage.py shell

データの作成

シェル内で、モデルを使ってデータを作成するには、まずモデルをインポートし、その後インスタンスを作成します。

python
from myapp.models import Post

# 新しいPostを作成
post = Post(title="Djangoの使い方", content="Djangoのモデルを使って、データベースを簡単に操作できます。")
post.save()

save()メソッドを使うことで、新しいデータがデータベースに保存されます。

データの取得

データを取得するためには、objectsマネージャを使います。例えば、すべての投稿を取得するには以下のようにします。

python
posts = Post.objects.all()
for post in posts:
    print(post.title)

また、特定の条件でデータをフィルタリングすることもできます。

python
post = Post.objects.filter(title="Djangoの使い方").first()
print(post.content)

データの更新

既存のデータを更新するには、まずデータを取得し、その後属性を変更して保存します。

python
post = Post.objects.get(id=1)  # IDが1のPostを取得
post.title = "Djangoのモデル操作"
post.save()

データの削除

データを削除するには、delete()メソッドを使います。

python
post = Post.objects.get(id=1)
post.delete()

4. モデルのフィールドの種類

Djangoでは、さまざまな種類のフィールドが用意されており、データの型に応じて適切なフィールドを選択できます。以下は、よく使われるフィールドのいくつかです。

  • CharField: 短い文字列を格納するためのフィールド
  • TextField: 長いテキストを格納するためのフィールド
  • IntegerField: 整数を格納するためのフィールド
  • DateTimeField: 日時を格納するためのフィールド
  • BooleanField: 真偽値を格納するためのフィールド
  • ForeignKey: 他のモデルとの1対多のリレーションを定義するためのフィールド
  • ManyToManyField: 多対多のリレーションを定義するためのフィールド

例えば、投稿とカテゴリを関連付けるために、ForeignKeyを使用して以下のように定義できます。

python
class Category(models.Model):
    name = models.CharField(max_length=50)

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    category = models.ForeignKey(Category, on_delete=models.CASCADE)

これにより、各投稿が1つのカテゴリに関連付けられます。

5. モデルのメタ情報

モデルにはメタ情報を設定することができます。メタ情報は、モデルの動作をカスタマイズするために使用されます。例えば、verbose_nameやorderingを設定することができます。

python
class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()

    class Meta:
        verbose_name = "ブログ投稿"
        ordering = ['-published_date']

これにより、Djangoの管理画面での表示名を「ブログ投稿」とし、投稿の一覧は公開日で降順に並べ替えられます。

まとめ

Djangoのモデルは、データベースとのやり取りを簡単にしてくれる強力なツールです。モデルを定義し、マイグレーションを使ってテーブルを作成し、Djangoシェルを使ってデータを操作することで、効率的にデータベースを管理できます。さまざまなフィールドタイプやリレーションシップを活用することで、複雑なデータ構造にも対応可能です。

最終更新： 28/02/2025
1分未満
Back to top button