Python学习笔记__18.3章 使用SQLAlchemy

# 这是学习廖雪峰老师python教程的学习笔记

1、概览

数据库表是一个二维表，包含多行多列。把一个表的内容用Python的数据结构表示出来的话，可以用一个list表示多行，list的每一个元素是tuple，表示一行记录，比如，包含id和name的user表：

[

    ('1', 'Michael'),

    ('2', 'Bob'),

    ('3', 'Adam')

]

Python的DB-API返回的数据结构就是像上面这样表示的。

但是用tuple表示一行很难看出表的结构。如果把一个tuple用class实例来表示，就可以更容易地看出表的结构来：

class User(object):

    def __init__(self, id, name):

        self.id = id

        self.name = name

 

[

    User('1', 'Michael'),

    User('2', 'Bob'),

    User('3', 'Adam')

]

把关系数据库的表结构映射到对象上，这就是ORM技术：Object-Relational Mapping。

为了实现表结构到对象的转换，ORM框架应运而生，在Python中，最有名的ORM框架是SQLAlchemy

2、使用SQLAlchemy

用上一节在MySQL的test数据库中创建的user表进行测试

    1）通过pip安装SQLAlchemy

pip install sqlalchemy

    2）导入SQLAlchemy，并初始化DBSession

# 导入:

from sqlalchemy import Column, String, create_engine

from sqlalchemy.orm import sessionmaker

from sqlalchemy.ext.declarative import declarative_base

 

# 创建对象的基类:

Base = declarative_base()

 

# 定义User对象:

class User(Base):

    # 表的名字:

    __tablename__ = 'user'

 

    # 表的结构:

    id = Column(String(20), primary_key=True)

    name = Column(String(20))

 

# 初始化数据库连接，SQLAlchemy用一个字符串表示连接信息

# '数据库类型+数据库驱动名称://用户名:口令@机器地址:端口号/数据库名'

engine = create_engine('mysql+mysqlconnector://root:password@localhost:3306/test')

# 创建DBSession类:

DBSession = sessionmaker(bind=engine)

以上代码完成SQLAlchemy的初始化和具体每个表的class定义。如果有多个表，就继续定义其他class，例如

class School(Base):

    __tablename__ = 'school'

    id = ...

    name = ...

    3）向数据库表中添加一行记录

由于有了ORM，我们向数据库表中添加一行记录，可以视为添加一个User对象

# 创建session对象:

session = DBSession()

# 创建新User对象:

new_user = User(id='5', name='Bob')

# 添加到session:

session.add(new_user)

# 提交即保存到数据库:

session.commit()

# 关闭session:

session.close()

可见，关键是获取session，然后把对象添加到session，最后提交并关闭。DBSession对象可视为当前数据库连接

    4）从数据库表中查询数据

有了ORM，查询出来的可以不再是tuple，而是User对象

# 创建Session:

session = DBSession()

# 创建Query查询，filter是where条件，最后调用one()返回唯一行，如果调用all()则返回所有行:

user = session.query(User).filter(User.id=='5').one()

# 打印类型和对象的name属性:

print('type:', type(user))

print('name:', user.name)

# 关闭Session:

session.close()

 

# 结果

type: <class '__main__.User'>

name: Bob

可见，ORM就是把数据库表的行与相应的对象建立关联，互相转换。

 

由于关系数据库的多个表还可以用外键实现一对多、多对多等关联，相应地，ORM框架也可以提供两个对象之间的一对多、多对多等功能。

    5）如果一个User拥有多个Book，定义一对多关系

class User(Base):

    __tablename__ = 'user'

 

    id = Column(String(20), primary_key=True)

    name = Column(String(20))

    # 一对多:

     # 自定义名=relationship("外键有联系的类名",backref="任意命名")

     #当我们查询一个User对象时，该对象的books属性将返回一个包含若干个Book对象的list。

    books = relationship('Book')

 

class Book(Base):

    __tablename__ = 'book'

 

    id = Column(String(20), primary_key=True)

    name = Column(String(20))

    # “多”的一方的book表是通过外键关联到user表的:

    user_id = Column(String(20), ForeignKey('user.id'))

3、扩展文档

数据库学习笔记 (三) python操作数据库 (https://www.cnblogs.com/zh605929205/p/7001994.html)