使用 Django ORM 操作資料庫

在前一章，我們利用 Django Admin 新增、修改及刪除 Post 。而實際在寫程式時，我們會使用 Django 提供的 QuerySet API，來達成類似的資料庫操作。

本章你會學到：如何使用 Django QuerySet API 與資料庫互動 (CRUD)。

CRUD 指的是，Create (新增)、Read (讀取)、Update (修改)、Delete (刪除) 等常見的資料庫操作。

使用 Django Shell

與先前不同的是，在這裡我們不使用 Python Shell，而是 Django Shell。

在練習之前，我們先來安裝一個「加強版」的 Python shell：IPython。

IPython 是強化版的 Python 互動式命令列介面，它比預設的命令列介面多了許多進階功能，例如：

按 tab 鍵可以補齊未輸入完的指令、檔案及資料夾名稱。
按 ↑ 鍵和 ↓ 鍵可以瀏覽輸入過的程式碼，便於微調先前的程式碼（修改參數等等）。
在套件、模組或函數名稱後加上 ? 可查看與之相關的資訊。
history 指令可查看所有輸入過的指令。
可以使用 shell 指令，如：ls、cd。

我們一樣可以用 pip 來安裝這個強大的套件：

(djangogirls_venv) ~/djangogirls/mysite$ pip install ipython[terminal]

安裝完畢後，就可以使用 shell 指令，進入 Django Shell：

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

這個 shell 和我們之前輸入 python 執行的 shell 類似，只是它會預先為我們設定 Django 需要的環境，方便我們執行 Django 相關的程式。

QuerySet API

Create

首先，讓我們來試著新增幾筆資料：

>>> from trips.models import Post

>>> Post.objects.create(title='My First Trip', content='肚子好餓，吃什麼好呢?',  location='台北火車站')
<Post: My First Trip>

>>> Post.objects.create(title='My Second Trip', content='去散散步吧',  location='大安森林公園')
<Post: My Second Trip>

>>> Post.objects.create(title='Django 大冒險', content='從靜態到動態',  location='台北市大安區復興南路一段293號')
<Post: Django 大冒險>

Read

若想顯示所有的 Post ，可以使用 all()：

>>> from trips.models import Post
>>> Post.objects.all()
[<Post: My First Trip>, <Post: My Second Trip>, <Post: Django 大冒險>]

只想顯示部分資料時，則可以使用 get 或 filter：

>>> Post.objects.get(pk=1)
<Post: My First Trip>

>>> Post.objects.filter(location__contains='台北')
[<Post: My First Trip>, <Post: Django 大冒險>]

get：返回符合條件的唯一一筆資料。（注意：如果找不到符合條件的資料、或是有多筆資料符合條件，都會產生 exception）
filter：返回符合條件的陣列。如果找不到任何資料則會返回空陣列。

Update

當想修改資料時，可以使用 update 更新一筆或多筆資料：

首先，這裡使用 contains 針對title欄位，篩選出所有標題中包含 Trip 字眼的 Post

>>> posts = Post.objects.filter(title__contains='Trip')

注意：Django ORM 會使用雙底線__，來區隔欄位title和篩選方法contains，如果只用一個底線，Django 會因為找不到欄位title_contains而出錯。

共有 2 個 Post 符合上面的條件

>>> posts
[<Post: My First Trip>, <Post: My Second Trip>]

我們將 location 的值印出

>>> posts[0].location
'台北火車站'

>>> posts[1].location
'大安森林公園'
>>>

印出後發現，Post 的 location 分別為'台北火車站'和'大安森林公園'。現在我們試試用 update 指令，把它們改成 '象山親山步道'

>>> posts.update(location='象山親山步道')
2

回傳的數字 2 指的是已被更新的資料筆數。我們可以驗證一下 location 是否皆已被正確更新

>>> posts[0].location
'象山親山步道'

>>> posts[1].location
'象山親山步道'

Delete

我們也可以使用 delete 刪除資料：

我們試著使用 delete，將剛剛的那兩筆 Post 刪除。

>>> posts.delete()

最後確認一下，資料是否刪除

>>> Post.objects.all()
[<Post: Django 大冒險>]

Django ORM