Python中的ORM框架Tortoise ORM實戰

Tortoise ORM是一個基於Python語言開發的非同步ORM框架，可用於Python非同步應用程式中管理關聯式資料庫。

本文將介紹如何使用Tortoise ORM框架來建立、讀取、更新和刪除數據，同時也將學習如何從關聯式資料庫執行簡單和複雜的查詢。

準備工作

在開始本教學之前，你需要安裝Python(建議使用Python3.6 )，同時安裝Tortoise ORM框架。

你可以透過pip使用以下指令來安裝Tortoise ORM框架：

pip install tortoise-orm

接下來，我們將設定資料庫和模型結構。

建立資料庫連線

使用Tortoise ORM進行資料庫操作需要先連接資料庫。在本教程中，我們將使用SQLite資料庫。

Tortoise ORM使用環境變數或.config檔來管理資料庫連線資訊。建立一個名為.env的檔案和以下配置，可以實現資料庫連線。

DATABASE_URL=sqlite://db.sqlite3

其中db.sqlite3是你要建立的新資料庫的檔名。

同時，我們還需要在程式碼中使用函數來初始化Tortoise ORM：

import os
from dotenv import load_dotenv
from tortoise import Tortoise

# 加载环境变量
load_dotenv()

async def init_db():
    await Tortoise.init(config={
        'connections': {
            'default': os.getenv('DATABASE_URL')
        },
        'apps': {
            'models': {
                'models': ['app.models',],
                'default_connection': 'default'
            }
        }
    })
    await Tortoise.generate_schemas()

在上面的程式碼中我們使用環境變數來取得資料庫連接訊息，並傳遞給Tortoise ORM進行初始化。接著呼叫Tortoise.generate_schemas()方法來為所定義的模型產生對應的資料表。

在完成上述操作後，我們就可以開始建立模型。

建立模型

在本教學中，我們將建立一個簡單的部落格模型，包含標題、內容、建立時間、更新時間和作者。

from tortoise import fields
from tortoise.models import Model

class Blog(Model):
    id = fields.IntField(pk=True)
    title = fields.CharField(max_length=100)
    content = fields.TextField()
    created_at = fields.DatetimeField(auto_now_add=True)
    updated_at = fields.DatetimeField(auto_now=True)
    author = fields.CharField(max_length=100)

在上面的程式碼的Blog模型中，我們使用Model基底類別並創建了一些欄位id、title、content、created_at、updated_at和author。 pk=True指明了id欄位是主鍵。 auto_now_add=True和auto_now=True分別指明了created_at和updated_at欄位應該在建立和更新時自動更新。

現在，我們已經成功定義了一個模型，接下來學習如何使用Tortoise ORM進行CRUD操作。

讀取和建立資料

使用Tortoise ORM讀取和建立資料非常簡單，以下是一些範例程式碼：

from app.models import Blog

# 创建一个新博客
blog = await Blog.create(title='Tortoise ORM', content='使用Tortoise ORM操作数据库非常方便', author='Alice')

# 读取所有博客
blogs = await Blog.all()
for blog in blogs:
    print(blog.title)

# 根据标题读取指定博客
blog = await Blog.get(title='Tortoise ORM')
print(blog.content)

在上面的程式碼中，我們使用了Blog.create()方法建立了一個新博客，使用Blog.all()方法讀取了所有博客，並使用Blog.get()方法根據標題讀取了指定的部落格。

更新和刪除資料

Tortoise ORM也提供了更新和刪除資料的方法。以下是一些範例程式碼：

# 更新博客的内容
blog.content = 'Tortoise ORM提供了丰富的API来管理数据库'
await blog.save()

# 删除指定的博客
await Blog.filter(title='Tortoise ORM').delete()

在上面的程式碼中，我們使用save()方法更新了部落格的內容，並使用filter()和delete()方法根據標題刪除了指定的部落格。

執行複雜查詢

除了基本的CRUD操作，Tortoise ORM還允許執行複雜的查詢。以下是一些範例：

# 使用where子句查询特定日期创建的博客
blogs = await Blog.filter(created_at__date='2021-07-12').all()

# 使用order_by子句将博客按更新日期升序排列
blogs = await Blog.all().order_by('updated_at')

# 连接多个过滤器查询具有特定条件的博客
blogs = await Blog.all().filter(title__contains='ORM', author__icontains='Alice')

在上面的程式碼中，我們使用了filter()、all()和order_by()方法結合一些查詢參數，例如。 created_at__date、title__contains和author__icontains等，來執行複雜查詢。

結論

在本教學中，我們學習如何使用Tortoise ORM框架實作CRUD操作、初始化資料庫和建立模型，以及執行複雜的資料庫查詢。正如我們所看到的，Tortoise ORM使得在Python非同步應用程式中管理資料庫變得非常簡單且直觀。

以上是Python中的ORM框架Tortoise ORM實戰的詳細內容。更多資訊請關注PHP中文網其他相關文章！