sqlalchemy持久化存储

### 使用SQLAlchemy进行持久化存储

对于Python应用程序而言，SQLAlchemy是一个功能强大且灵活的对象关系映射器(ORM)，它允许开发者通过面向对象的方式操作数据库[^1]。

#### 安装SQLAlchemy库
为了能够使用SQLAlchemy，在项目环境中安装此库是必要的。可以通过pip工具轻松完成这一过程：

pip install sqlalchemy

#### 创建引擎并连接到数据库
创建一个用于与特定类型的数据库交互的引擎实例非常重要。这里展示了一个简单的例子，其中包含了SQLite数据库的设置方法：

from sqlalchemy import create_engine

engine = create_engine('sqlite:///example.db', echo=True)

`echo=True`参数会启用日志记录，显示执行的所有SQL语句；这对于调试非常有用。

#### 建立模型类定义表结构
接下来要做的就是基于所选的数据模式构建相应的Python类。这些类继承自`Base`基类，并利用声明性语法描述表格字段和其他属性。

from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import Column, Integer, String

Base = declarative_base()

class User(Base):
    __tablename__ = 'users'
    
    id = Column(Integer, primary_key=True)
    name = Column(String)
    fullname = Column(String)
    nickname = Column(String)

    def __repr__(self):
        return f"<User(name='{self.name}', fullname='{self.fullname}', nickname='{self.nickname}')>"

上述代码片段展示了如何定义名为`users`的新表以及其列名和类型。

#### 初始化元数据并将更改应用至数据库
一旦完成了所有模型的设计工作之后，则可以调用`create_all()`函数来初始化所有的表结构信息。

Base.metadata.create_all(engine)

这一步骤将会把之前定义好的表结构同步给实际使用的数据库系统。

#### 执行CRUD操作
最后也是最重要的部分——对已存在的实体实施增删改查(CRUD)动作。下面是一些基本的例子说明怎样去做这件事:

##### 插入新纪录
向数据库中添加新的用户条目很简单直观：

from sqlalchemy.orm import sessionmaker

Session = sessionmaker(bind=engine)
session = Session()

new_user = User(name='ed', fullname='Ed Jones', nickname='edsnickname')
session.add(new_user)
session.commit()

##### 查询现有记录
检索符合条件的结果集同样容易理解：

for instance in session.query(User).filter_by(name='ed'):
    print(instance)

##### 更新已有记录
更新某个具体用户的资料只需要找到对应的对象再修改相应属性即可：

user_to_update = session.query(User).get(1)
if user_to_update is not None:
    user_to_update.nickname = "updated_nickname"
    session.commit()

##### 删除指定记录
移除不再需要的数据项也十分简单明了：

user_to_delete = session.query(User).get(1)
if user_to_delete is not None:
    session.delete(user_to_delete)
    session.commit()

以上便是关于如何运用SQLAlchemy来进行持久化的全面介绍[^3]。