Flask-SQLAlchemy-猿码集

1. 介绍 Flask-SQLAlchemy

Flask-SQLAlchemy是一个在Flask框架上集成的SQLAlchemy库的扩展，它提供了一个易于使用的方式来在Flask应用程序中进行数据库操作。SQLAlchemy是一个Python的SQL工具包和对象关系映射(ORM)框架，它允许开发者使用Python代码来操作数据库，而无需编写复杂的SQL语句。

2. 安装 Flask-SQLAlchemy

Flask-SQLAlchemy可以通过pip命令进行安装。在命令行窗口中输入以下命令来安装Flask-SQLAlchemy：

pip install flask-sqlalchemy

3. 配置 Flask-SQLAlchemy

在Flask应用程序中使用Flask-SQLAlchemy之前，我们需要对其进行配置。在Flask应用程序的配置文件中，添加以下配置项：


from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///database.db'
db = SQLAlchemy(app)

在上面的代码中，我们首先导入了Flask-SQLAlchemy扩展，然后创建了Flask应用程序并将数据库的URI路径配置给了`SQLALCHEMY_DATABASE_URI`配置项。这里我们使用了SQLite数据库，数据库文件命名为`database.db`，你可以根据实际需求进行修改。

3.1 数据库URI的配置

Flask-SQLAlchemy支持多种类型的数据库，比如SQLite、MySQL、PostgreSQL等。你可以根据实际需求来选择合适的数据库。配置值的格式及含义如下：

- SQLite: `sqlite:///database.db`

- MySQL: `mysql://username:password@hostname/database`

- PostgreSQL: `postgresql://username:password@hostname/database`

4. 创建数据模型

Flask-SQLAlchemy是基于SQLAlchemy的，所以我们需要定义模型类来表示数据库中的表，并且每个模型类都是SQLAlchemy的`Model`类的子类。下面是一个示例：


from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy()
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}', '{self.email}')"

在上述代码中，我们首先导入了Flask-SQLAlchemy扩展，并且创建了一个`db`对象。然后我们定义了一个`User`模型类，它有三个属性`id`、`username`和`email`，分别对应数据库表中的字段。我们还定义了一个`__repr__`方法来方便打印输出用户对象的信息。

4.1 模型的字段类型

Flask-SQLAlchemy支持多种类型的字段，包括整型、字符串、日期时间等。下面是一些常用的字段类型及其使用示例：

- `db.Integer`: 整型字段，可以用来存储整数值。

- `db.String`: 字符串字段，可以用来存储字符串值，需要指定最大长度。

- `db.Boolean`: 布尔字段，可以用来存储真/假值。

- `db.DateTime`: 日期时间字段，可以用来存储日期时间值。

- `db.ForeignKey`: 外键字段，用于建立不同表之间的关联关系。

5. 数据库操作

在Flask-SQLAlchemy中，我们可以通过模型类来进行数据库的增删改查操作。下面是一些常用的数据库操作示例：

5.1 创建数据库表

在应用程序中执行以下命令来创建数据库表：


with app.app_context():
    db.create_all()

这会根据模型类的定义在数据库中创建相应的表。

5.2 添加数据

我们可以通过实例化模型类来创建一个数据库对象，然后调用`add()`方法将该对象添加到数据库中：


user = User(username='admin', email='admin@example.com')
db.session.add(user)
db.session.commit()

上述代码中，我们首先实例化了一个`User`对象，然后将其添加到数据库会话中。最后调用`commit()`方法来提交事务，将数据保存到数据库中。

5.3 查询数据

我们可以使用`query`属性来进行查询操作。以下是一些常用的查询方法示例：

- 查询所有数据：


users = User.query.all()

- 根据条件查询数据：


user = User.query.filter_by(username='admin').first()

- 使用`LIKE`关键字进行模糊查询：


users = User.query.filter(User.username.like("%admin%")).all()

5.4 更新数据

我们可以通过修改模型对象的属性值来更新数据库中的数据，然后调用`commit()`方法来提交事务。


user = User.query.filter_by(username='admin').first()
user.email = 'new_email@example.com'
db.session.commit()

5.5 删除数据

我们可以使用`delete()`方法来删除数据库中的数据。


user = User.query.filter_by(username='admin').first()
db.session.delete(user)
db.session.commit()

6. 总结

Flask-SQLAlchemy是一个非常强大和灵活的工具，它简化了在Flask应用程序中进行数据库操作的过程。本文介绍了Flask-SQLAlchemy的安装、配置和使用方法，并给出了一些常用的操作示例。通过使用Flask-SQLAlchemy，开发者可以更加便捷地使用Python来操作数据库，提高开发效率。

Flask-SQLAlchemy