前回

参考文献

はじめての Django アプリ作成、その2 | Django ドキュメント | Django

DataBaseの設定

mysite/setting.py

jangoの設定をいろいろ書いてあるPythonモジュール
データベースのサポートなどもデフォルトで入っている

INSTALLED_APPS

アプリケーションの重要部分の設定。詳細は以下
- django.contrib.admin - 管理（admin）サイト
- django.contrib.auth - 認証システム
- django.contrib.contenttypes - コンテンツタイプフレームワーク
- django.contrib.sessions - セッションフレームワーク
- django.contrib.messages - メッセージフレームワーク
- django.contrib.staticfiles - 静的ファイルの管理フレームワーク

テーブルの作成

データベースのテーブル作成は以下のコマンドで行う。

python manage.py migrate

-migrateコマンドは上記のINSTALLED_APPSの設定を参照し`mysite/setting.py'ファイルのデータベース設定に従って必要なすべてのデータベースを作成する。
- コマンドラインクライアントでテーブルの中身を表示することが可能
- \dt (PostgreSQL
- SHOW TABLES; (MySQL)
- .schema (SQLite)
- SELECT TABLE_NAME FROM USER_TABLES; (Oracle)

データベースモデルを生成

from django.db import models


class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')


class Choice(models.Model):
    question = models.ForeignKey(Question, on_delete=models.CASCADE)
    choice_text = models.CharField(max_length=200)
    votes = models.IntegerField(default=0)

QuestionとChoiceのモデル二つを生成している
どちらもmodelsクラスのサブクラス
個々のクラスはモデルのデータベースフィールを表現している
CharFiledやIntegerFieldなどでどのようなデータ型を記憶させるかを指定している
models.CharField(max_length=200)やmodels.IntegerField(default=0)のように条件や初期値も指定可能
ForeignKey(外部キー)でQuestionとリレーションシップを定義している。

アプリケーションをプロジェクトに反映

アプリケーションをプロジェクトに含めるにはsetting.py'のINSTALLED_APPS`に設定を追加する
アプリケーション(今回はPolls)内のapps.py内に記載されているクラスをINSTALLED_APPSに設定する

INSTALLED_APPS = [
    'polls.apps.PollsConfig',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

モデルの変更を反映させる

下記コードを実行するとDjangoに変更があったことをマイグレーションの形で保存する

python manage.py makemigrations polls

マイグレーション:Djangoがモデル(データベーススキーマ)の変更を保存する方法。

 python manage.py check

プロジェクトに問題がないかを確認するコマンド

モデルのテーブルを作成したら、migrateを再度実行しモデルのテーブルをデータベースに作成する

モデルの変更を実施する3ステップ

モデルを変更する
マイグレーション作成のためにpython manage.py makemigrationsを実行
データベースにこれらの変更を適用するためpython manage.py migrateを実行

マイグレーションの作成と適用のコマンドが分かれているのはなぜ？

マイグレーションをバリデーション管理システムにコミットしアプリとともに配布するため
開発の容易化
ほかの開発者や本番環境にとって使いやすいものになるため

データベースAPIの利便性の向上

シェル内で>>> Question.objects.all()とすると
以下のように出力される。
<QuerySet [<Question: Question object (1)>]>
これだとデータベースのテーブルがどうなっているかわからない

そのため`str'メソッドをQuestionとChoiceの両方に追加する

from django.db import models

class Question(models.Model):
    # ...
    def __str__(self):
        return self.question_text

class Choice(models.Model):
    # ...
    def __str__(self):
        return self.choice_text

シェルでの表示の利便性以外にもdjangoの自動生成adminのオブジェクトの表現として使用される
そのためstr()メソッドをモデルに追加することは重要

polls/models.py


from django.db import models
from django.utils import timezone


class Question(models.Model):
    # ...
    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)

管理ユーザを作成する

python manage.py createsuperuser

admin上で編集可能にする

from django.contrib import admin

from .models import Question

admin.site.register(Question)

ゼロから始めるDjango(part:2)

前回