神器出场
今天的主角是 sandman2
可以基于已存在的数据库,自动生成一个 RESTful API 服务器,而不需要写任何代码,用作者的话说,简单地就像给食物加点盐
更厉害的是,从简单地 SQLite 数据库,到大型的商业数据 PostgreSQL, 都能完美支持,且不用写一行代码
目前支持的数据库:
- MySQL
- PostgreSQL
- Oracle
- Microsoft SQL Server
- SQLite
- Sybase
- Drizzle
- Firebird
这让我想起了曾经因为找不到合适的数据库框架手忙脚乱的日子,如果早点知道 sandman2 就好了
之所以叫 sandman2,是因为它的前辈是 sandman,sandman 已经有了很强的数据库支持能力,不过在 SQLAlchemy 0.9 版本中,增加了 automap
功能,可以进一步使 sandman 得到简化,于是重写了 sandman,就有了 sandman2,并且 sandman2 的功能远超 sandman
使用 pip 安装 pip install sandman2
安装成功后,就可以得到一个 sandman2ctl
命令行工具,用它来启动一个 RESTful API 服务器
不用写一行代码,直接启动:
sandman2ctl sqlite+pysqlite:///data.db
注意:如果用的 python 版本是 3.8 及以上,且在 Windows 上,执行时可能会遇到,
AttributeError: module 'time' has no attribute 'clock'
的错误 这是因为 3.8 以后time
模块的clock
属性换成了perf_counter()
方法,所以需要修改下lib\site-packages\sqlalchemy\util\compat.py
的 331 行,将time_func = time.clock
换成time_func = time.perf_counter()
保存即可
启动之后,默认端口是 5000,访问地址是 http://localhost:5000/admin
就能看到服务器控制台了
数据库连接
前面已经看到连接 SQLite 数据的方法
sandman2 是基于 SQLAlchemy 的,所以使用连接 Url 来连接数据库
格式为
dialect+driver://username:password@host:port/database
- dialect 为数据库类型,如 mysql、SQLite 等
- driver 为数据库驱动模块名,例如 pymysql、psycopg2、mysqldb 等,如果忽略,表示使用默认驱动
以 mysql 数据库为例:
sandman2ctl 'mysql+pymysql://bob:bobpasswd@localhost:3306/testdb'
如果环境中没有安装
pymysql
模块,必须先安装,才能正常启动
其他数据库的连接方式可参考 SQLAlchemy 的 引擎配置
章节, 在这里查看 https://docs.sqlalchemy.org/en/13/core/engines.html
控制台
需要快速预览数据,对数据进行简单调整的话,控制台很有用
左侧菜单除了 Home 外,其他的都是库表名称
点击相应库表名称,会在右侧显示表内数据,并且可以做增删改操作
库表数据
点击新增,打开新增页面:
新增页面
用过 Django 的同学会感觉很熟悉,不过字段并没有类型支持,只能以字符串输入,自行确保数据类型正确,否则保存时会收到错误信息
点击记录前面的笔状图标,会进入编辑页面
编辑页面
点击记录前的删除图标,来删除记录
另外多选数据后,可以通过 With selected
菜单下的 Delete
按钮来批量删除
控制台方便易用,适合一些简单的、数据量少的操作
注意:由于控制台不能登录即可访问,建议将服务器创建在本地或内网环境中