python flask sqlalchemy教学
时间: 2025-05-01 07:37:13 浏览: 34
### Python Flask SQLAlchemy 使用教程
#### 1. 安装依赖
要使用 `Flask-SQLAlchemy`,首先需要通过 `pip` 工具安装该扩展包。运行以下命令完成安装:
```bash
pip install Flask-SQLAlchemy
```
此操作会下载并安装必要的库文件以便后续配置和使用[^1]。
---
#### 2. 配置数据库连接
在项目初始化阶段,需创建一个 Flask 应用实例并将 SQLAlchemy 实例绑定到应用上。以下是典型的实现方式:
```python
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
# 设置数据库 URI 和其他选项
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///example.db' # SQLite 示例
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False # 关闭修改跟踪功能以优化性能
db = SQLAlchemy(app) # 初始化 SQLAlchemy 对象并与 Flask 应用关联
```
上述代码片段展示了如何设置数据库 URI 并禁用了不必要的追踪机制来提升效率[^2]。
---
#### 3. 创建模型表结构
定义数据模型时继承自 `db.Model` 类,并指定字段及其属性。下面是一个简单的用户表例子:
```python
class User(db.Model):
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(80), unique=True, nullable=False)
email = db.Column(db.String(120), unique=True, nullable=False)
def __repr__(self):
return f'<User {self.username}>'
```
在此部分中,我们定义了一个名为 `User` 的模型类,其中包含了三个列:`id`, `username`, 和 `email`[^3]。
---
#### 4. 数据库迁移与更新
为了同步模型更改至实际数据库,可以借助工具如 `flask-migrate` 或手动执行 SQL 命令。如果采用前者,则先安装它:
```bash
pip install Flask-Migrate
```
接着,在应用程序入口处引入相关组件并注册 CLI 命令支持:
```python
from flask_migrate import Migrate
migrate = Migrate(app, db)
```
之后可通过终端发起迁移流程:
```bash
flask db init # 只需首次调用一次
flask db migrate # 自动检测变更生成脚本
flask db upgrade # 将新版本应用于目标 DB
```
这些步骤有助于保持本地模式设计始终匹配物理存储布局。
---
#### 5. CRUD 操作示例
利用 ORM 提供的功能可轻松实施增删改查逻辑。例如新增记录如下所示:
```python
new_user = User(username='john_doe', email='[email protected]')
db.session.add(new_user)
db.session.commit()
```
查询特定条件下的所有条目则可用过滤器方法达成目的:
```python
users_with_john = User.query.filter_by(username='john').all()
print(users_with_john)
```
以上两段分别演示了插入一条新的用户信息以及检索用户名为 “john” 的全部结果集的过程。
---
阅读全文
相关推荐
















