SQLAlchemy学习-1.环境准备与基础使用
前言
SQLAlchemy采用简单的Python语言,提供高效和高性能的数据库访问,实现了完整的企业级持久模型。
它提供了SQL工具包和ORM(对象关系映射)工具,类似于Django 自带的 ORM 框架操作数据库。
官方文档地址https://docs.sqlalchemy.org/en/14/orm/quickstart.html
环境准备
基于python3.8环境,安装 sqlalchemy 和 pymysql
pip3 install sqlalchemy==1.4.39
pip3 install pymysql==1.0.2
配置连接
连接数据库,需要使用到一些配置信息,组合成满足以下条件的字符串:
dialect+driver://username:password@host:port/database
相关配置参数说明
配置参数 | 说明 |
---|---|
dialect | 数据库,如:sqlite、mysql、oracle等 |
driver | 数据库驱动,如前面安装的:pymysql |
username | 登录数据库用户名 |
password | 登录数据库密码 |
host | 数据库部署 IP 地址 |
port | 端口 |
database | 数据库库名 |
拼接地址示例
# 拼接配置dialect + driver://username:passwor@host:port/database
DB_URI = 'mysql+pymysql://root:123456@localhost:3306/web'
连接数据库示例
查询 SQL 示例
select * from yoyo_projectinfo WHERE project_name = 'yoyo';
执行结果
先测试下配置的参数是否能连上数据库,写个简单的sql查询
from sqlalchemy import create_engine, text
# 拼接配置dialect + driver://username:passwor@host:port/database
DB_URI = 'mysql+pymysql://root:123456@localhost:3306/web'
engine = create_engine(DB_URI) # 创建引擎
conn = engine.connect() # 创建连接
result = conn.execute(text('select * from yoyo_projectinfo WHERE project_name = "yoyo";')) # 执行SQL
print(result.fetchone())
conn.close() # 关闭连接
能看到执行结果,说明数据库连接成功。这是执行的硬核SQL语句,接下来就是讲通过ORM 操作数据库。
创建 ORM 模型
SQLAlchemy 是 Python 著名的 ORM 工具包。通过 ORM,开发者可以用面向对象的方式来操作数据库,不再需要编写 SQL 语句。
在python代码中创建一个类,每个类对应了一个数据库中的一张表,类的数据属性对应了表中的字段名,这个类称为映射类。
创建模型示例
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import create_engine, Column, Integer, String
# 拼接配置dialect + driver://username:passwor@host:port/database
DB_URI = 'mysql+pymysql://root:123456@localhost:3306/web'
Base = declarative_base()
class Students(Base):
__tablename__ = 'students' # 数据库表名
id = Column(Integer, primary_key=True)
name = Column(String(20))
fullname = Column(String(30))
nickname = Column(String(30))
def __repr__(self):
return "<Students(name='%s', fullname='%s', nickname='%s')>" % (
self.name, self.fullname, self.nickname)
相关参数说明:
__tablename__
:数据库表名
Column: 数据表中的一列,内部定义了数据类型
primary_key:主键
String:定义字段是字符串类型,字符串类型需定义字符长度
执行下面这2句,将模型映射到数据库中
if __name__ == '__main__':
engine = create_engine(DB_URI)
Base.metadata.create_all(engine) # 将模型映射到数据库中
执行完成后,在数据库中就可以看到students 表了
新增数据
模型创建完成后,接下来需要往数据库表里面添加数据,需要使用一个引擎的实例来创建一个 Session类的实例。
from sqlalchemy.orm import sessionmaker
from sqlalchemy import create_engine
from xx.xx import Students
engine = create_engine('mysql+pymysql://root:123456@localhost:3306/web')
# 把当前的引擎绑定给这个会话
Session = sessionmaker(bind=engine)
# 实例化
session = Session()
# 创建一个student对象
student_obj = Students(name='yoyo', fullname='yoyoketang', nickname='yy')
session.add(student_obj) # 添加到session
session.commit() # 提交到数据库
执行完成后,会看到数据库里面有新增的数据了
批量创建数据使用add_all
session.add_all([
Students(name='yoyo1', fullname='yoyoketang1', nickname='yy1'),
Students(name='yoyo2', fullname='yoyoketang2', nickname='yy2')
])
session.commit()