文 |?太陽雪

來源：Python 技術「ID: pythonall」

數據庫的重要性不言而喻，但是數據庫操作起來卻不容易，需要用到各種管理工具，各種不同的連接方式，如果有方便的，屏蔽不同數據庫細節的工具該多好，功夫不負有心人，我還真找了這樣一個工具，不僅支持多種數據庫，更厲害的是，不用為適配寫一行代碼，來了解下吧

神器出場

今天的主角是 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 按鈕來批量刪除

控制臺方便易用，適合一些簡單的、數據量少的操作

注意：由于控制臺不能登錄即可訪問，建議將服務器創建在本地或內網環境中

API

以 RESTful 的角度來看，庫表相當于資源(resource)，一組資源相當于集合(collection)

以下測驗，均采用 curl 工具進行，具體用法可參考 阮一峰的 《curl 的用法指南》(http://www.ruanyifeng.com/blog/2019/09/curl-reference.html)

查詢

通過 Http GET 方法，以 JSON 格式將數據返回，例如返回 學生表 student 的所有記錄：

$ curl http://localhost:5000/student/{"resources":[{"age":18,"class":"1","id":1,"name":"\u5f20\u4e09","profile":"\u64c5\u957f\u5b66\u4e60"},...

注意：資源要以 / 結尾

通過參數 page 來分頁，例如返回 學生表 student 的第一頁數據

$ curl http://localhost:5000/student/?page=1 {"resources":[{"age":18,"class":"1"...

通過參數 limit 顯示返回行數

如果要獲取具體記錄，可以用主鍵值作為節段，例如獲取 id 為 3 的學生記錄

$ curl http://localhost:5000/student/3 {"age":18,"class":"2","id":3,"name":"\u738b\u4e94","profile":"\u7231\u7f16\u7a0b"}

以字段名做參數，相當于查詢條件，例如，查詢 name 為 Tom 的學生記錄：

$ curl http://localhost:5000/student/?name=Tom {"resources":[{"age":19,"class":"1","id":7,"name":"Tom","profile":"Handsome"}]}

查詢條件可以被組合，例如，查詢班級為 1 年齡為 18 的學生:

$ curl http://localhost:5000/student/?class=1&age=19 {"resources":[{"age":19,"class":"1","id":2,"name":"\u674e\u56db","profile":"\u559c\u6b22\u7bee\u7403"},{"age":19,"class":"1","id":7,"name":"Tom","profile":"Handsome"}]}

修改

POST 方法用于新增，新增內容，由請求的數據部分提供，例如增加一個學生信息：

$ curl -X POST -d '{"name": "Lily", "age": 17, "class":1, "profile":"Likely"}' -H "Content-Type: application/json" http://127.0.0.1:5000/student/ {"age":17,"class":"1","id":8,"name":"Lily","profile":"Likely"}

注意：庫表主鍵是自增長的，可以忽略主鍵字段，否則必須提供

PATCH 方法用于更新，更新內容，由請求的數據部分提供，例如將 id 為 1 的學生班級更改為 3

注意: 更新時主鍵信息通過 url 的主鍵值節段提供，而不在數據部分中

$ curl -X PATCH -d '{"class":3}' -H "Content-Type: application/json" http://127.0.0.1:5000/student/1 {"age":18,"class":"3","id":1,"name":"\u5f20\u4e09","profile":"\u64c5\u957f\u5b66\u4e60"}

DELETE 方法由于刪除，例如刪除 id 為 8 的學生記錄:

$ curl -X DELETE -H "Content-Type: application/json" http://127.0.0.1:5000/student/8

其他接口

獲取表的字段定義信息，通過 meta 節段獲取，例如獲取 學生表 student 的字段定義：

$ curl http://127.0.0.1:5000/student/meta {"age":"INTEGER(11)","class":"VARCHAR(255)","id":"INTEGER(11) (required)","name":"VARCHAR(255)","profile":"VARCHAR(500)"}

導出數據，通過查詢字段 export 獲取，數據格式為 csv，例如導出學生數據，存放到 student.csv 文件中：

$ curl -o student.csv http://127.0.0.1:5000/student/?export% Total % Received % Xferd Average Speed Time Time Time CurrentDload Upload Total Spent Left Speed 100 202 100 202 0 0 2525 0 --:--:-- --:--:-- --:--:-- 2525

還有更多的接口有待你的探索

部署服務

sandman2 的服務器是基于 Flask 的

前面的 Python 100 天文章中對 Flask 和 服務器部署有詳細的說明

具體可參考，《Web 開發 Flask 簡介》，以及《部署 Flask 應用》

在此就不贅述了

總結

sandman2 之所以簡單易用，是因組合了很多應用和技術，SQLAlchemy 做 ORM 層，Flask 做 RESTful 服務器，Bootstrap 做前臺框架等

給我們提供便利的同時，展示了技術組合的強大，使得我們對一些細小知識點的學習不會再感到枯燥無味

參考

• https://www.cnblogs.com/Liu-Hui/p/13388194.html

• https://sandman2.readthedocs.io/en/latest/

• http://www.ruanyifeng.com/blog/2019/09/curl-reference.html

由于微信平臺算法改版，公號內容將不再以時間排序展示，如果大家想第一時間看到我們的推送，強烈建議星標我們和給我們多點點【在看】。星標具體步驟為：

（1）點擊頁面最上方“小詹學Python”，進入公眾號主頁。 （2）點擊右上角的小點點，在彈出頁面點擊“設為星標”，就可以啦。 感謝支持，比心。

總結

以上是生活随笔為你收集整理的不用一行代码，用 API 操作数据库，你信吗的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。