Flask-SQLAlchemy
- SQLALchemy 實際上是對數據庫的抽象，讓開發者不用直接和 SQL 語句打交道，而是通過 Python 對象來操作數據庫，在捨棄一些性能開銷的同時，換來的是開發效率的較大提升
- SQLAlchemy是一個關係型數據庫框架，它提供了高層的 ORM 和底層的原生數據庫的操作。flask-sqlalchemy 是一個簡化了 SQLAlchemy 操作的flask擴展。
- 文檔地址：http://docs.jinkan.org/docs/flask-sqlalchemy
數據庫連接設置
- 在 Flask-SQLAlchemy 中，數據庫使用URL指定，而且程序使用的數據庫必須保存到Flask配置對象的 SQLALCHEMY_DATABASE_URI 鍵中
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:[email protected]:3306/test'
# 數據庫類型://用戶名:密碼@IP地址:端口號/庫名
- 其他設置：
# 動態追蹤修改設置，如未設置只會提示警告
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = True
#查詢時會顯示原始SQL語句
app.config['SQLALCHEMY_ECHO'] = True
- 配置完成需要去 MySQL 中創建項目所使用的數據庫
$ mysql -uroot -pmysql
$ create database test charset utf8;
- 其他配置
| 名字 | 備註 |
|---|---|
| SQLALCHEMY_DATABASE_URI | 用於連接的數據庫 URI 。例如:sqlite:////tmp/test.dbmysql://username:password@server/db |
| SQLALCHEMY_BINDS | 一個映射 binds 到連接 URI 的字典。更多 binds 的信息見用 Binds 操作多個數據庫。 |
| SQLALCHEMY_ECHO | 如果設置爲Ture， SQLAlchemy 會記錄所有 發給 stderr 的語句，這對調試有用。(打印sql語句) |
| SQLALCHEMY_RECORD_QUERIES | 可以用於顯式地禁用或啓用查詢記錄。查詢記錄 在調試或測試模式自動啓用。更多信息見get_debug_queries()。 |
| SQLALCHEMY_NATIVE_UNICODE | 可以用於顯式禁用原生 unicode 支持。當使用 不合適的指定無編碼的數據庫默認值時，這對於 一些數據庫適配器是必須的（比如 Ubuntu 上 某些版本的 PostgreSQL ）。 |
| SQLALCHEMY_POOL_SIZE | 數據庫連接池的大小。默認是引擎默認值（通常 是 5 ） |
| SQLALCHEMY_POOL_TIMEOUT | 設定連接池的連接超時時間。默認是 10 。 |
| SQLALCHEMY_POOL_RECYCLE | 多少秒後自動回收連接。這對 MySQL 是必要的， 它默認移除閒置多於 8 小時的連接。注意如果 使用了 MySQL ， Flask-SQLALchemy 自動設定 這個值爲 2 小時。 |
連接其他數據庫
完整連接 URI 列表請跳轉到 SQLAlchemy 下面的文檔 (Supported Databases) 。這裏給出一些 常見的連接字符串。
- Postgres:
postgresql://scott:tiger@localhost/mydatabase
- MySQL:
mysql://scott:tiger@localhost/mydatabase
- Oracle:
- oracle://scott:[email protected]:1521/sidname
- SQLite （注意開頭的四個斜線）:
sqlite:////absolute/path/to/foo.db
通用部分
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
#設置連接數據庫的URL
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:[email protected]:3306/test'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = True
#查詢時會顯示原始SQL語句
app.config['SQLALCHEMY_ECHO'] = True
db = SQLAlchemy(app)
接下來就可以根據自己的需求定義模型類的