SQLAlchemy是著名的ORM(Object Relational Mapping-对象关系映射)框架。其主要作用是在编程中,把面向对象的概念跟数据库中表的概念对应起来。对许多语言(例如JAVA/PYTHON)来说就是定义一个对象,并且这个对象对应着一张数据库的表。而这个对象的实例,就对应着表中的一条记录。
其整体思路如下图所示:
其中类、对象与属性与数据库相关内容的对应关系如下图所示:
ORM的优点:
数据模型与代码统一定义,更新与维护简单,代码高度重用一致。
ORM有现成的工具,很多功能都可以自动完成,比如表格增删、预处理、事务等。
基于ORM的业务代码比较简单,代码量少,语义性好,容易理解。
你不必编写性能不佳的SQL。
ORM的缺点:
ORM库多层封装,实现巧妙,需要花很多精力学习和设置。
对于复杂的查询,ORM要么是无法表达,要么是性能不如原生的SQL。
ORM抽象掉了数据库层,开发者无法了解底层的数据库操作,也无法定制一些特殊的SQL。
从整体上看,ORM节省了开发时间,减少了代码错误的可能性,同时能够方便地在多个数据库间灵活迁移,还是非常值得使用。而在python语言中,SQLAlchemy是著名的ORM框架之一,它的整体架构如下图所示:
从图中可以看出,SQLAIchemy是分层架构,由Core以及ORM两部分组成。其中,Core完成了与数据库操作的各类封闭,是相对低层的。而ORM层则利用Core层的能力进行更宏观的操作。因此,在一段python代码中,使用Core与ORM层同时来操作数据库也是可行的,并不矛盾与冲突。
下面先从最基本的表格创建做起。非ORM编程中,表格的创建无非两个途径:
●基于DBMS本身提供的CLI/GUI界面,发出DDL语句进行数据库/表格本身的增删改查。
●使用语言连接数据库后,发出命令来对数据库/表格进行增删改查。
而由于每种数据库都有自己的方言,所以命令语句各有差异,需要不断地调整。而使用SQLAlchemy则实现了代码统一。例如以下代码在mssql以及mysql上创建表格,并且可以查询表格的元数据,以及插入数据后的查询。
from sqlalchemy import (Column, Integer, MetaData, String, Table, create_engine, text, Float, DateTime, ForeignKey)from sqlalchemy_utils.functions import create_database, database_existsconfigure_pg = {"user": "postgres", 'password': '88488848', 'dns': 'dbserver.home', "port": 5432, 'prefix': 'postgresql+psycopg2', 'postfix': '' }configure_mssql = {"user": "sa", 'password': '88488848', 'dns': 'dbserver.home', "port": 1433, 'prefix': 'mssql+pymssql', 'postfix': '?charset=utf8' }configure_mysql = {"user": "root", 'password': '88488848', 'dns': 'dbserver.home', "port": 3306, 'prefix': 'mysql+mysqlconnector', 'postfix': '' }config = {'mssql': configure_mssql, 'mysql': configure_mysql, 'postgresql': configure_pg}database_name = 'testdb'table_sensor_location = "sensor_location"table_sensor_data = "sensor_data"def linkdb(targetstr): """ 连接不同的数据库 Args: targetstr (string): 数据库名称 Returns: engine: 用于后续的数据库连接 """ if targetstr in config.keys(): item = config[targetstr] connectstring = f"{item['prefix']}://{item['user']}:{item['password']}@{item['dns']}:{item['port']}/{database_name}{item['postfix']}" engine = create_engine(connectstring, echo=True, future=True) # 如果数据库不存在,则创建之 if not database_exists(engine.url): create_database(engine.url) # 做一个测试,不针对任何表 with engine.connect() as conn: result = conn.execute(text("select 'hello world'")) print(result.all()) return enginedef createtbs(connector): """" 创建数据库中的2张表。用于保存传感器数据与传感器本身的信息 """ metadata_obj = MetaData() # 描述传感器的表 sensor_location_tb = Table( table_sensor_location, metadata_obj, Column('id', Integer, primary_key=True, autoincrement=False), Column('location', String(30), nullable=False) ) # 保存传感器数据的表 sensor_data_tb = Table( table_sensor_data, metadata_obj, Column('id', Integer, primary_key=True, autoincrement=False), Column('sensor_id', ForeignKey( f'{table_sensor_location}.id'), nullable=False), Column('area', String(30)), Column('pm25', Float), Column('timestamp', DateTime) ) print(sensor_data_tb.compile()) # 创建并返回表 metadata_obj.create_all(connector) return sensor_data_tb, sensor_location_tbdef tableinfo(connector, tablename): """ 获得指定表名的相关元数据信息 Args: connector (engine): 数据库连接器 tablename (string): 要查询的表名 """ metadata_obj = MetaData() some_table = Table(tablename, metadata_obj, autoload_with=connector) print([c.name for c in some_table.columns])def gensonsorinfo(connector): with connector.connect() as conn: conn.execute(text(f"INSERT INTO {table_sensor_location} (id, location) VALUES (:x, :y)"), [{"x": 1, "y": '1号楼'}, {"x": 2, "y": '2号楼'}]) conn.commit() result = conn.execute( text(f"SELECT id, location FROM {table_sensor_location}")) for x, y in result: print(f"id: {x} location: {y}")# 依次连接多个数据库。从而验证代码的一致性for dbname in config.keys(): con = linkdb(dbname) createtbs(con) tableinfo(con, table_sensor_data) tableinfo(con, table_sensor_location) gensonsorinfo(con)
从代码可以看出,可以用统一的访问方式来操作mssql/mysql/postgresql三种数据库。而且,以上方式与前文中的基于游标的写法类似。