SQLAlchemy 是 Python 中一款非常流行的數據庫工具包,它對底層的數據庫操作提供了高層次的抽象。在本篇文章中,我們將介紹 SQLAlchemy 的兩個主要組成部分:SQL 工具包 (SQL Toolkit) 和對象關係映射器 (Object-Relational Mapper, ORM) 的基本使用。
一、SQLAlchemy 的安裝和設置
安裝 SQLAlchemy 很簡單,可以通過 pip 工具進行安裝:
pip install sqlalchemy
接下來,我們需要設置一個 SQLAlchemy Engine。Engine 是 SQLAlchemy 中的一個核心接口,它為 SQL 數據庫提供了一種統一的方式來與 Python 程序進行交互。以下是一個 SQLite 數據庫的 Engine 設置示例:
from sqlalchemy import create_engine
# 創建一個內存中的 SQLite 數據庫
engine = create_engine('sqlite:///:memory:', echo=True)
二、SQLAlchemy SQL 工具包的使用
SQLAlchemy 的 SQL 工具包提供了一種 Pythonic 的方式來生成和執行 SQL 語句。例如,我們可以使用以下代碼來創建一個新的數據庫表:
from sqlalchemy import Table, Column, Integer, String, MetaData
metadata = MetaData()
users = Table(
'users', metadata,
Column('id', Integer, primary_key=True),
Column('name', String),
Column('email', String),
)
metadata.create_all(engine)
三、SQLAlchemy ORM 的使用
SQLAlchemy 的 ORM 允許我們將 Python 類映射到數據庫表,使我們可以使用面向對象的方式來處理數據庫。以下是一個簡單的 ORM 示例:
from sqlalchemy import Column, Integer, String
from sqlalchemy.ext.declarative import declarative_base
Base = declarative_base()
class User(Base):
__tablename__ = 'users'
id = Column(Integer, primary_key=True)
name = Column(String)
email = Column(String)
Base.metadata.create_all(engine)
在上面的代碼中,我們定義了一個 User 類,並將其映射到 users 表。然後,我們可以使用類和對象的方式來操作數據庫:
from sqlalchemy.orm import Session
# 創建一個新的 Session
session = Session(engine)
# 創建一個新的 User 對象
new_user = User(name='John', email='john@example.com')
# 添加到 session
session.add(new_user)
# 提交(保存)更改
session.commit()
四、總結
在本篇文章中,我們介紹了 SQLAlchemy 的基礎知識,包括如何安裝和設置 SQLAlchemy,如何使用 SQLAlchemy 的 SQL 工具包和 ORM。SQLAlchemy 是一個強大的工具,它使處理數據庫變得更簡單、更 Pythonic。在接下來的學習中,你可以深入探索 SQLAlchemy 的高級特性,如事務管理、表關聯等。