模块

优质

小牛编辑

136浏览

2023-12-01

現今的網站，都不再只是僅單純展示網頁內容的靜態網頁。大多數網站，都會加上一些與使用者互動的功能，如留言版、討論區、投票等等。而這些使用者產出的資料，往往會儲存於資料庫中。

這一章，你會學到如何利用 Django Model 定義資料庫的結構（schema），並透過 Django 指令創建資料庫、資料表及欄位。

使用 Django Model 的好處

雖然資料庫的語法有其標準，但是各家資料庫還是或多或少有差異。使用 Django Model 的來操作資料庫的優點之一，就是資料庫轉換相當方便。

在大部份情況下，不再需要為不同的資料庫，使用不同語法來撰寫程式。只要修改設定，就可以輕易地從 SQLite 轉換到 MySQL、PostgreSQL、或是 Oracle 等等。

設定資料庫

為了開發方便，我們使用 Python 預設的資料庫引擎 - SQLite。打開 mysite/settings.py，看看 DATABASES 的設定。它應該長得像下面這樣：

# mysite/settings.py

...

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

在這裡我們設定了資料庫連線的預設值：

ENGINE -- 你要使用的資料庫引擎。例如：
- MySQL: django.db.backends.mysql
- SQLite 3: django.db.backends.sqlite3
- PostgreSQL: django.db.backends.postgresql_psycopg2
NAME -- 你的資料庫名稱

如果你使用 MySQL 或 PostgreSQL 等等資料庫，可能還要設定它的位置、名稱、使用者等等。不過我們這裡使用的 SQLite 3 不需要這些性質，所以可以省略。

Django Models

我們在 trips/models.py 宣告一個 Post 類別，並定義裡面的屬性，而 Django 會依據這個建立資料表，以及資料表裡的欄位設定：

# trips/models.py

from django.db import models


class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField(blank=True)
    photo = models.URLField(blank=True)
    location = models.CharField(max_length=100)
    created_at = models.DateTimeField(auto_now_add=True)

Django 預設會為每一個 Model 加上 id 欄位，並將這個欄位設成 primary key（主鍵），簡稱 pk，讓每一筆資料都會有一個獨一無二的 ID。
為 Post 定義以下屬性：

屬性	資料型態	說明	參數
title	CharField	標題	`max_length=100` -- 標題不可以超過 100 個字元
content	TextField	內文	`blank=True` -- 非必填欄位（表單驗證時使用），預設所有欄位都是 `blank=False`
photo	URLField	照片網址	同 content，非必填欄位
location	CharField	地點	同 title
created_at	DateTimeField	建立時間	`auto_now_add=True` -- 物件新增的時間。若想設成物件修改時間，則用 `auto_now=True`

Model fields 可為 Django Model 定義不同型態的屬性。

CharField -- 字串欄位，適合像 title、location 這種有長度限制的字串。
TextField -- 合放大量文字的欄位
URLField -- URL 設計的欄位
DateTimeField -- 日期與時間的欄位，使用時會轉成 Python datetime 型別。

更多 Model Field 與其參數，請參考 Django 文件

同步資料庫

首先執行 makemigrations 指令：

(djangogirls_venv) ~/djangogirls/mysite$ python manage.py makemigrations
Migrations for 'trips':
  0001_initial.py:
    - Create model Post

這個指令會根據你對 Model 的修改刪除建立一個新的 migration 檔案，讓 migrate 指令執行時，可以照著這份紀錄更新資料庫。

接著用以下的指令，讓 Django 根據上面的紀錄，把 models.py 中的欄位寫入資料庫：

(djangogirls_venv) ~/djangogirls/mysite$ python manage.py migrate

結果應該類似下面這樣：

Operations to perform:
  Synchronize unmigrated apps: staticfiles, messages
  Apply all migrations: sessions, admin, auth, contenttypes
Synchronizing apps without migrations:
  Creating tables...
    Running deferred SQL...
  Installing custom SQL...
Running migrations:
  Rendering model states... DONE
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying sessions.0001_initial... OK
  Applying trips.0001_initial... OK

migrate 指令會根據 INSTALLED_APPS 的設定，按照 app 順序建立或更新資料表，將你在 models.py 裡的更新跟資料庫同步。