Django筆記二之連線資料庫、執行migrate資料結構更改操作

本篇筆記目錄索引如下：

Django 連線mysql，執行資料庫表結構遷移步驟介紹
運算元據庫，對資料進行簡單操作

接下來幾篇筆記都會介紹和資料庫相關，包括資料庫的連線、操作（包括增刪改查）、對應的欄位型別、model 裡Meta 相關引數和 QueryAPI 的詳解等。

這一篇先介紹資料庫的連線和簡單的增刪改查操作。

首先介紹一些 Django 的操作表的邏輯，Django 提供了一套非常方便的 orm 方法，可用於Django 能直接對錶和資料進行增刪改查，對應的資料庫裡每一張表都有一個對應的 model 的class，class 下每一個欄位都對應 mysql 中表的欄位，我們在 Django 中定義好這些內容，然後通過命令遷移到資料庫中來完成修改。

1、Django 連線mysql

前一篇筆記我們建立了一個名為 polls 的application，接下來我們要在 polls 下面建立和資料庫的連線。

連線上 mysql 分為以下幾步：

安裝依賴
建立資料庫
修改settings.py 填寫資料庫資訊
遷移預設表
定義 model 資訊
生成 migrations 檔案
執行表的遷移

安裝依賴

Django 和 mysql 連線需要安裝一個 driver，我們這裡選擇 mysqlclient，以下是安裝命令：

pip3 install mysqlclient -i https://mirrors.aliyun.com/pypi/simple/

還是通過 -i 指定源，加速安裝。

建立資料庫

可以自己在伺服器或者本地安裝一個可以執行的 mysql，我這裡安裝的是 mysql 5.7 版本。

建立資料庫的時候記得指定編碼為 utf-8：

create database func_test default character set='utf8'

在這裡，資料庫名稱為 func_test，庫編碼為 utf-8。

修改settings.py 填寫資料庫資訊

在 hunter/settings.py 檔案下，有一個 DATABASES 的變數，將其修改為以下內容：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'func_test',
        "USER": "user",
        "PASSWORD": "password",
        "HOST": "xx.xx.xx.xx",
        "PORT": 3306,
    }
}

其中，default 表示系統預設連線的資料庫，一個 Django 系統可以連線多個資料庫，可以通過這個地方定義變數名稱來指定。
如果需要連線多個資料庫，後續的操作可以再介紹。在使用的時候通過 using() 來區分
ENGINE：在這裡值為 django.db.backends.mysql ，表示連線的資料庫型別是 mysql
NAME：表示連線的資料庫名稱，在這裡我們指定的是 func_test
USER：連線資料庫使用的使用者名稱
PASSWORD：連線資料庫使用者名稱對應的密碼
HOST：你的資料庫的地址，原生的話是 localhost 或者 127.0.0.1，伺服器上填寫相應的 ip 即可
PORT：埠，mysql 預設是 3306

以上的那些變數，記得更換成原生的變數。

好了，關於資料庫的基本連線設定就都設定完成了。

遷移預設表

Django 系統裡是有一些預設的設定表的，
比如使用者表，如果使用Django的預設使用者系統的話可以用上
django_session表，用於記錄使用者的登入的 session相關記錄
django_migrations表，記錄每一次表及欄位的建立和修改操作等等

這些表，在我們執行以下操作命令的時候，會自動寫入資料庫：

python3 manage.py migrate

定義 model 資訊

在上一篇筆記裡我們建立了一個名為 polls 的 application，裡面有一個 models.py 的檔案，然後我們編輯該檔案，內容如下：

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)

在上述檔案裡，每一個class 代表著一張表，每一行都代表著表裡的一個欄位，欄位的型別在上述的檔案裡對應資料庫的型別為：
CharField：varchar
DateTimeField：datetime
IntegerField：int
ForeignKey：外來鍵
這個型別我們後續會再介紹，這裡只做一個簡單的介紹。

然後我們還需要將我們這個 model 註冊到我們的 settings.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',
]

生成 migrations 檔案

我們定義好 model 檔案之後，在生成表結構之前，我們還需要生成一個記錄表結構變化的檔案，也就是我們的migrations 檔案，每一次修改都可以生成一個新的 migration 檔案，然後寫入資料庫，該檔案存放在每一個 application 的 migrations 資料夾下面。
生成 migrations 檔案命令：

python3 manage.py makemigrations polls

然後我們可以看到在 polls/migrations/ 資料夾下多了一個 0001_initial.py

執行表的遷移

然後執行下面的命令，Django會根據系統裡上一次在 django_migrations 表裡記錄的上一次執行的地方，檢測我們系統裡新增的 migrations 檔案，自動將資料結構的更改適配到資料庫裡：

python3 manage.py migrate polls

如果對 model.py 再進行一次更改，然後執行 makemigrations 命令，migrations 資料夾下會自動新增新的遷移命令。
每一個新增的前面都會有序號標識，比如我們最開始的是 0001，之後每一次都會按照序號往後新增。
有興趣的可以看看 migrations 裡的檔案內容，那是 python 語言裡對應 SQL 的更改內容，這裡不做展開，有興趣的可以看看。

如果我們想在每一次執行 migrate 前，檢視會對資料庫進行怎麼樣的更改，可以根據我們上面說的序號，來指定 migration 檔案檢視：

python3 manage.py sqlmigrate polls 0001

python3 manage.py sqlmigrate 是固定語法，
polls 是對應的 application 的名稱，
0001 是每一次migration的前面的序號，這樣就可以指定到 application 下的每一次更改。

比如上面那條命令，輸出的結果如下：

會將跳脫執行到資料庫的語句列印出來。

2、運算元據庫，對資料進行簡單操作

現在我們根據上述的操作，建立了兩張表和對應的 model，接下來介紹怎麼對資料進行操作：

比如我們要建立一個 Question 資料，使用Django的語法來建立，可以通過以下命令進入 Django 的互動介面：

python3 manage.py shell

然後挨個輸入：

from polls.models import Question
q = Question(question_text="quesiton_text_1", pub_date="2022-01-01 00:00:00")
q.save()

然後檢視資料庫，可以看到我們通過 save() 操作已經建立了一條資料了。

獲取單個資料呢：

q = Question.objects.get(id=1)
print(q.question_text)

以上就是我們這一篇筆記的全部內容，下一篇筆記將詳細介紹如果通過 Django 的 model 對資料進行增刪改查的操作。

本文首發於本人微信公眾號：Django筆記。

原文連結：Django筆記二之連線資料庫、執行migrate資料結構更改操作

如果想獲取更多相關文章，可掃碼關注閱讀：