Python中的对象关系映射SQLALchemy使用

简介
什么是ORM？
ORM：即Object-Relational Mapping(对象关系映射),它的作用是在关系型数据库和业务实体对象之间作一个映射,这样,我们在具体的操作业务对象的时候,就不需要再去和复杂的SQL语句打交道,只需简单的操作对象的属性和方法。

SQLAlchemy： SQLAlchemy是Python编程语言下的一款开源软件。提供了SQL工具包及对象关系映射(ORM)工具,为高效和高性能的数据库访问设计,实现了完整的企业级持久模型。

SQLAIchemy与数据库关系图

基本操作

安装sqlalchemy

1. 需要一台安装有mysql数据库的机器
2. 安装模块：pip3 install sqlalchemy
3. 查看版本信息
   
   1、连接数据库
   在sqlalchemy中,session用于创建程序与数据库之间的会话。所有对象的载入和保存都需要通过session对象。

from sqlalchemy import create_engine, Column, Integer, SmallInteger, String
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import sessionmaker
# python2: MySQLdb
# python3: pymysql
# 使用create_engine建立同数据库的连接，返回的是一个Engine实例
# 指向数据库的一些核心的接口
# echo=True， 可以在控制台看到操作涉及的SQL语言
engine = create_engine("mysql+pymysql://root:westos@172.25.254.35/pymysql",
                       encoding='utf8',
                       echo=True)
# 创建缓存对象
Session = sessionmaker(bind=engine)
session = Session()
# 声明基类
Base = declarative_base()

2、创建映射（创建表）
一个映射对应着一个Python类,用来表示一个表的结构。

# 基于这个基类来创建我们的自定义类，一个类就是一个数据库表
class Person(Base):
    __tablename__ =  'persons'
    id = Column(Integer, primary_key=True, autoincrement=True)
    name = Column(String(20), nullable=False)
    email = Column(String(30), unique=True)

    def __repr__(self):
        return  self.name

if __name__ == '__main__':
    # 检查表的存在性，如果不存在的话会执行表的创建工作
    Base.metadata.create_all(engine)

3、添加单挑数据

    # 添加单条数据
    p = Person(id=1, name="小明", email='xiaoming@westos.org')
    # 先将数据写入缓存;
    session.add(p)
    # 将缓存中的数据提交到数据库并执行
    session.commit()

4、添加多条数据

    #  添加多条数据
    p1 = Person(name='A')
    p2 = Person(name='B')
    # 先将数据写入缓存;
    session.add_all((p1, p2))
    # 将缓存中的数据提交到数据库并执行
    session.commit()

5、查找数据

# 查找数据
    # select * from students where ()
    results = session.query(Person).all()  # 查找表的所有数据
    print(results)

    results = session.query(Person).first()  # 查找表的第一条数据
    print(results)

    obj = session.query(Person).filter_by(name='小明').first()
    print("邮箱地址:", obj.email)

6、删除数据

    # 删除数据，没有first/all方法， 默认返回的是要执行的sql语句;
    obj = session.query(Person).filter_by(name='B').first()
    print(obj)
    session.delete(obj)
    session.commit()

7、更新数据

    # 更新数据: 更新姓名为A的邮箱为hello@qq.com
    obj = session.query(Person).filter_by(name='A').first()
    obj.email = 'hello.qq.com'
    session.add(obj)
    session.commit()

下面通过创建一个用户信息表对SQLALchemy进行应用，将以上的操作在代码中一起实现，其中还包括排序，和快速删除的方法，代码如下：

mport sqlalchemy

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

import pymysql
from sqlalchemy.orm import sessionmaker

pymysql.install_as_MySQLdb()

# object(oop) ---> mysql(SQL)
# 1).创建数据库引擎(连接数据库的过程)
# echo = True显示翻译好的SQL语句
engine = sqlalchemy.create_engine("mysql://root:westos@localhost/Blog",
                                  encoding='utf8', echo=True)

# 2).建立缓存对象
Session = sessionmaker(bind=engine)
session = Session()

# 3).创建数据库对象需要继承的基类，包含ORM映射中相关的类和表的信息
Base = declarative_base()


# 4)基于这个基类来创建我们的自定义类，一个类就是一个数据库表
class Student(Base):
    # 数据库表的名称
    __tablename__ = 'student_info'
    # 数据库表的属性信息
    id = Column(Integer, primary_key=True, autoincrement=True)
    name = Column(String(20))
    sex = Column(String(10))


if __name__ == '__main__':
    # 检查表的存在性，如果不存在的话会执行表的创建工作
    Base.metadata.create_all(engine)

    #更新数据
    stu1 = session.query(Student).filter(Student.name == 'westos3').first()
    stu1.sex = 'female'
    session.commit()

    # *******添加数据信息(实例化对象：添加一条数据/记录)
    # stu1 = Student(id=1, name='westos1', sex='male')
    # # stu2 = Student(id=2, name='westos2', sex='female')
    # # stu3 = Student(id=3, name='westos3', sex='male')
    # # 添加Student对象，但是仍然没有提交到数据库中


    # ********添加单条数据时方法如下
    # session.add(stu1)

    # *******添加多条数据时方法如下
    # session.add_all([Student(id=2, name='westos2', sex='female'),
    #                  Student(id=3, name='westos3', sex='male')])
    # 提交数据库
    # session.commit()

    # 查询数据信息:all-所有的数据,first-第一条数据
    print(session.query(Student).first())
    print(session.query(Student).all())

    # 根据筛选条件查询信息
    print(session.query(Student).filter_by(name='westos1').first())
    print(session.query(Student).filter_by(name='westos2').all())
    print(session.query(Student).filter_by(name='westos3').one_or_none())

    #删除数据
    # stu1 = session.query(Student).filter_by(name='westos2').first()
    #
    # print("before delete:", stu1)
    # session.delete(stu1)
    # session.commit()
    # stu1 = session.query(Student).filter_by(name='westos1').first()
    # print(stu1)
    #快速删除方法
    session.query(Student).filter(Student.name=='westos2').delete()
    session.commit()

    #查询数量
    number = session.query(Student).filter().count()
    print("total student is {}".format(number))

    #分组排序
    groupBy = session.query(Student).group_by(Student.sex).all()
    print(groupBy)
    for i in groupBy:
        print(i.id,i.name,i.sex)


    #排序
    orderBy = session.query(Student).order_by(Student.id.desc()).all()
    for i in orderBy:
        print(i.id,i.name,i.sex)