Python tortoise-orm 模块：从入门到精通

Travis Tang

2024-07-25

Python tortoise-orm 模块

tortoise-orm 是一个功能强大的异步 Python ORM（对象关系映射）库，适用于 Python 3.6 及以上版本。它允许开发者使用简单而优雅的方式与数据库交互，隐藏了大量的 SQL 细节，让开发者能够集中精力于业务逻辑的编写，而不是数据库的细节。

模块的设计理念是便捷高效，它支持多种数据库，如 SQLite、MySQL、PostgreSQL 等。此外，它在异步编程的背景下运行，通过与 asyncio 的集成，tortoise-orm 提供了强大的并发能力，使得应用在处理大量请求时表现更加出色。

应用场景

tortoise-orm 广泛应用于各种需要与数据库交互的 Python 项目，特别适合以下场景：

Web 开发：可以与 FastAPI 与 Tornado 等异步 Web 框架配合使用，实现高性能的 Web 应用。
数据分析：通过 ORM 将数据持久化到数据库，让数据分析过程更加高效。
微服务：在微服务架构中，tortoise-orm 能快速处理多用户请求，并通过异步编程提升响应速度。

安装说明

tortoise-orm 并不是 Python 的内置模块，需要手动安装。可以使用 pip 进行安装，命令如下：

1	pip install tortoise-orm

用法举例

1. 创建和连接数据库

from tortoise import Tortoise, fields
from tortoise.models import Model

# 定义一个用户模型，包含名字和邮箱
class User(Model):
    id = fields.IntField(pk=True)  # 主键自动递增
    name = fields.CharField(max_length=50)  # 用户名
    email = fields.CharField(max_length=100)  # 用户邮箱

async def init():
    await Tortoise.init(
        db_url='sqlite://db.sqlite3',  # 使用SQLite数据库
        modules={'models': ['__main__']}  # 当前模块作为模型来源
    )
    await Tortoise.generate_schemas()  # 生成数据库表

该代码展示了如何定义一个用户模型并初始化数据库。

2. 插入数据

1
2
3

async def create_user():
    user = await User.create(name='Alice', email='alice@example.com')  # 插入一条新用户记录
    print(f'用户创建成功，ID为: {user.id}')  # 输出用户ID

这个例子展示了如何创建一条用户记录并打印其 ID。

3. 查询和更新数据

async def update_user(user_id):
    user = await User.get(id=user_id)  # 根据ID查询用户
    user.email = 'alice_new@example.com'  # 更新用户的邮箱
    await user.save()  # 保存到数据库
    print('用户邮箱更新成功')  # 输出成功信息

该示例展示了如何查询特定用户并更新其信息。

4. 查询所有用户

async def fetch_all_users():
    users = await User.all()  # 查询所有用户
    for user in users:
        print(f'用户ID: {user.id}, 名字: {user.name}, 邮箱: {user.email}')  # 输出所有用户信息

此例展示了如何获取并打印所有用户信息。

通过以上示例，我们可以看到如何使用 tortoise-orm 进行基本的数据库操作。这些简单的操作让你轻松地掌握了 tortoise-orm 的核心用法，无论是数据的创建、更新还是查询。

在这里，我强烈建议大家关注我的博客全糖冲击博客，文章内容涵盖 Python 标准库的使用教程，非常便于大家查询和学习。作为博主，我会不断更新优质内容，让你随时获得最新的技术信息和实用技巧。关注我的博客，助力你在 Python 学习之路上事半功倍，共同进步！

软件和库版本不断更新

由于软件和库版本不断更新，如果本文档不再适用或有误，请留言或联系我进行更新。让我们一起营造良好的学习氛围。感谢您的支持！ - Travis Tang