Django ORM - 单表实例

封面图 • 2025-10-20 • Django教程

在 Django ORM 中，**单表实例**（Single Table Instance）通常指的是对某个模型（Model）的一个具体实例进行操作。Django 的 ORM 是基于数据库的模型来操作数据的，每个模型类对应数据库中的一张表，而一个模型实例则代表该表中的一条记录。

---

## 🧾 一、定义一个模型（Model）

首先，你需要在 `models.py` 中定义一个模型：

```python
from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.CharField(max_length=100)
    published_date = models.DateField()

def __str__(self):
        return self.title
```

这个 `Book` 模型对应数据库中的一张表 `book`，每一条记录就是一个 `Book` 实例。

---

## 📦 二、创建单个实例（实例化对象）

你可以通过以下方式创建一个 `Book` 实例：

```python
book = Book(title="Django for Beginners", author="John Doe", published_date="2023-04-01")
```

> 注意：此时还没有保存到数据库中。

---

## ✅ 三、保存实例到数据库

使用 `.save()` 方法将实例保存到数据库：

```python
book.save()
```

---

## 📋 四、查询单个实例

你可以使用 `get()` 或 `filter().first()` 来获取单个实例。

### 使用 `get()`：

```python
try:
    book = Book.objects.get(id=1)
except Book.DoesNotExist:
    print("Book does not exist.")
```

### 使用 `filter().first()`：

```python
book = Book.objects.filter(id=1).first()
if book:
    print(book.title)
else:
    print("Book not found.")
```

---

## 🔁 五、更新实例

修改实例属性后，再次调用 `.save()` 即可更新数据库中的记录：

```python
book.title = "Django for Professionals"
book.save()
```

---

## 🗑️ 六、删除实例

使用 `.delete()` 方法删除实例：

```python
book.delete()
```

---

## 🧠 小结：什么是“单表实例”？

| 术语 | 含义 |
|------|------|
| **模型（Model）** | 定义数据库表结构的 Python 类（如 `Book`） |
| **实例（Instance）** | 模型的一个具体对象（如 `Book(title="...", ...)`） |
| **单表实例** | 对某个模型（表）的一个具体记录（行）的操作 |

---

## 📚 示例代码汇总

```python
# 创建实例
book = Book(title="Django for Beginners", author="John Doe", published_date="2023-04-01")
book.save()

# 查询实例
book = Book.objects.get(id=1)

# 更新实例
book.title = "Django for Professionals"
book.save()

# 删除实例
book.delete()
```

---

如果你有更具体的场景（比如如何处理关联模型、查询优化等），欢迎继续提问！