sqlor/docs/dbop.md
2025-11-07 17:33:43 +08:00

2.6 KiB
Raw Blame History

python使用sqlor数据操作规范

安装依赖包

pip install apppublic
pip install sqlor

使用规范

包含所需的包

from sqlor.dbpools import DBPools

数据库操作

获得数据库连接

db = DBPools() 获得数据库连接
···

### 使用数据库操作上下文
使用数据库操作上下文的好处:
* 自动事务开始和结束,整体提交或整体失败
* 资源自动回收

async with db.sqlorContext(dbname) as sor: ....

### 执行数据库操作
sqlor所有的数据库操作都必须在sqlorContext函数生成的上下文中执行以提供事务一致性并自动回收资源提供两种模式的数据库操作sqlExe函数可以执行dml ddl支持多表数据操作而CRUD只针对单表提供增产改查
#### runSQL
写符合SQL标准的SQL语句数据变量用“${varname}$"作为占位符并在参数ns中给定参数

以下是一个查询用户数据的语句机构id作为参数传入

sql = "select * from users where where orgid = {myorgid} and delflg='0'" await sor.sqlExe(sql, {'myorgid' : '12122'})

返回一个数据,数组中的每一个元素为一个用户数据

以下例子返回分页数据按照给定的page不同返回不同页的数据pagerows定义每页数据量```
sql1 = "select * from stock"
dic = await sor.sqlPaging(sql, {'pagerows':50, 'page':1, 'sort':'stock_id'})

dic是个DictObject从dict继承有两个属性total查询结果总记录数 rowspage指定页的数据

CRUD

CRUD针对单表操作提供对数据表的增删改查CDU三个函数在ns参数中必须提供主键数据。

  • C 向表中添加数据
await sor.C('stock', {
			'stock_id': '111111',
			...
		})
  • R 从表中读取数据,支持分页字典数据返回和不分页数组数据返回 分页例子
ns = {'pagerows': 50, 'page':1, 'sort':stock_id'}
dic = await sor.R('stock', ns)

dic是个DictObject从dict继承有两个属性total查询结果总记录数 rowspage指定页的数据

不分页例子

ns = {'id':'666667'} # filters dictionary, find all records which id = '666667'
recs = await sor.R('stock', ns)
  • U 修改数据表数据以主键必须在ns中出现作为修改数据条件修改ns中其他字段的值ns中不出现的字段不会被修改
await sor.U('stock', {'stock_id':'111111', 'name':'new_name'})
  • D 删除表中数据以主键必须在ns中出现作为删除数据条件从数据库中删除主键值与参数ns中主键值相同的记录
await sor.D('stock', {'stock_id':'111111'})