<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>数据库 &#8211; greydreaming</title>
	<atom:link href="https://greyli.com/tag/%e6%95%b0%e6%8d%ae%e5%ba%93/feed/" rel="self" type="application/rss+xml" />
	<link>https://greyli.com</link>
	<description>做了一个灰色的梦</description>
	<lastBuildDate>Mon, 09 Nov 2026 15:05:39 +0000</lastBuildDate>
	<language>zh-CN</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>https://wordpress.org/?v=4.9.26</generator>

<image>
	<url>https://greyli.com/wp-content/uploads/2025/03/avatar-500-compressed-144x144.jpg</url>
	<title>数据库 &#8211; greydreaming</title>
	<link>https://greyli.com</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>《Flask 入门教程》第 5 章：数据库</title>
		<link>https://greyli.com/flask-tutorial-chapter-5-database/</link>
		<comments>https://greyli.com/flask-tutorial-chapter-5-database/#comments</comments>
		<pubDate>Mon, 24 Dec 2018 03:10:03 +0000</pubDate>
		<dc:creator><![CDATA[李辉]]></dc:creator>
				<category><![CDATA[Tech Notes]]></category>
		<category><![CDATA[Flask]]></category>
		<category><![CDATA[Flask 入门教程]]></category>
		<category><![CDATA[Flask-SQLAlchemy]]></category>
		<category><![CDATA[SQLAlchemy]]></category>
		<category><![CDATA[数据库]]></category>

		<guid isPermaLink="false">http://greyli.com/?p=2073</guid>
		<description><![CDATA[大部分程序都需要保存数据，所以不可避免要使用数据库。用来操作数据库的数据库管理系统（DBMS）有很多选择，对于 [&#8230;]]]></description>
				<content:encoded><![CDATA[<p>大部分程序都需要保存数据，所以不可避免要使用数据库。用来操作数据库的数据库管理系统（DBMS）有很多选择，对于不同类型的程序，不同的使用场景，都会有不同的选择。在这个教程中，我们选择了属于关系型数据库管理系统（RDBMS）的 <a href="https://www.sqlite.org/" rel="nofollow">SQLite</a>，它基于文件，不需要单独启动数据库服务器，适合在开发时使用，或是在数据库操作简单、访问量低的程序中使用。</p>
<h2>使用 SQLAlchemy 操作数据库</h2>
<p>为了简化数据库操作，我们将使用 <a href="https://www.sqlalchemy.org/" rel="nofollow">SQLAlchemy</a>——一个 Python 数据库工具（ORM，即对象关系映射）。借助 SQLAlchemy，你可以通过定义 Python 类来表示数据库里的一张表（类属性表示表中的字段 / 列），通过对这个类进行各种操作来代替写 SQL 语句。这个类我们称之为<strong>模型类</strong>，类中的属性我们将称之为<strong>字段</strong>。</p>
<p>Flask 有大量的第三方扩展，这些扩展可以简化和第三方库的集成工作。我们下面将使用一个叫做 <a href="http://flask-sqlalchemy.pocoo.org/2.3/" rel="nofollow">Flask-SQLAlchemy</a> 的官方扩展来集成 SQLAlchemy。</p>
<p>首先使用 Pipenv 安装它：</p>
<pre>$ pipenv install flask-sqlalchemy</pre>
<p>大部分扩展都需要执行一个“初始化”操作。你需要导入扩展类，实例化并传入 Flask 程序实例：</p>
<pre>from flask_sqlalchemy import SQLAlchemy  # 导入扩展类

app = Flask(__name__)

db = SQLAlchemy(app)  # 初始化扩展，传入程序实例 app</pre>
<h2>设置数据库 URI</h2>
<p>为了设置 Flask、扩展或是我们程序本身的一些行为，我们需要设置和定义一些配置变量。Flask 提供了一个统一的接口来写入和获取这些配置变量：<code>Flask.config</code> 字典。配置变量的名称必须使用大写，写入配置的语句一般会放到扩展类实例化语句之前。</p>
<p>下面写入了一个 <code>SQLALCHEMY_DATABASE_URI</code> 变量来告诉 SQLAlchemy 数据库连接地址：</p>
<pre data-eusoft-scrollable-element="1">import os

# ...

app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////' + os.path.join(app.root_path, 'data.db')</pre>
<p><strong>注意</strong> 这个配置变量的最后一个单词是 URI，而不是 URL。</p>
<p>对于这个变量值，不同的 DBMS 有不同的格式，对于 SQLite 来说，这个值的格式如下：</p>
<pre>sqlite:////数据库文件的绝对地址</pre>
<p>数据库文件一般放到项目根目录即可，<code>app.root_path</code> 返回程序实例所在模块的路径（目前来说，即项目根目录），我们使用它来构建文件路径。数据库文件的名称和后缀你可以自由定义，一般会使用 .db、.sqlite 和 .sqlite3 作为后缀。</p>
<p>另外，如果你使用 Windows 系统，上面的 URI 前缀部分需要写入三个斜线（即 <code>sqlite:///</code>）。在本书的示例程序代码里，做了一些兼容性处理，另外还新设置了一个配置变量，实际的代码如下：</p>
<pre>import os
import sys

from flask import Flask

WIN = sys.platform.startswith('win')
if WIN:  # 如果是 Windows 系统，使用三个斜线
    prefix = 'sqlite:///'
else:  # 否则使用四个斜线
    prefix = 'sqlite:////'

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = prefix + os.path.join(app.root_path, 'data.db')
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False  # 关闭对模型修改的监控</pre>
<p>如果你固定在某一个操作系统上进行开发，部署时也使用相同的操作系统，那么可以不用这么做，直接根据你的需要写出前缀即可。</p>
<p><strong>提示</strong> 你可以访问 <a href="http://flask.pocoo.org/docs/1.0/config/" rel="nofollow">Flask 文档的配置页面</a>查看 Flask 内置的配置变量；同样的，在 <a href="http://flask-sqlalchemy.pocoo.org/2.1/config/" rel="nofollow">Flask-SQLAlchemy 文档的配置页面</a>可以看到 Flask-SQLAlchemy 提供的配置变量。</p>
<h2>创建数据库模型</h2>
<p>在 Watchlist 程序里，目前我们有两类数据要保存：用户信息和电影条目信息。下面分别创建了两个模型类来表示这两张表：</p>
<p><em>app.py：创建数据库模型</em></p>
<pre>class User(db.Model):  # 表名将会是 user（自动生成，小写处理）
    id = db.Column(db.Integer, primary_key=True)  # 主键
    name = db.Column(db.String(20))  # 名字


class Movie(db.Model):  # 表名将会是 movie
    id = db.Column(db.Integer, primary_key=True)  # 主键
    title = db.Column(db.String(60))  # 电影标题
    year = db.Column(db.String(4))  # 电影年份</pre>
<p>模型类的编写有一些限制：</p>
<ul>
<li>模型类要声明继承 <code>db.Model</code>。</li>
<li>每一个类属性（字段）要实例化 <code>db.Column</code>，传入的参数为字段的类型，下面的表格列出了常用的字段类。</li>
<li>在 <code>db.Column()</code> 中添加额外的选项（参数）可以对字段进行设置。比如，<code>primary_key</code> 设置当前字段是否为主键。除此之外，常用的选项还有 <code>nullable</code>（布尔值，是否允许为空值）、<code>index</code>（布尔值，是否设置索引）、<code>unique</code>（布尔值，是否允许重复值）、<code>default</code>（设置默认值）等。</li>
</ul>
<p>常用的字段类型如下表所示：</p>
<table>
<thead>
<tr>
<th>字段类</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>db.Integer</td>
<td>整型</td>
</tr>
<tr>
<td>db.String (size)</td>
<td>字符串，size 为最大长度，比如 <code>db.String(20)</code></td>
</tr>
<tr>
<td>db.Text</td>
<td>长文本</td>
</tr>
<tr>
<td>db.DateTime</td>
<td>时间日期，Python <code>datetime</code> 对象</td>
</tr>
<tr>
<td>db.Float</td>
<td>浮点数</td>
</tr>
<tr>
<td>db.Boolean</td>
<td>布尔值</td>
</tr>
</tbody>
</table>
<h2>创建数据库表</h2>
<p>模型类创建后，还不能对数据库进行操作，因为我们还没有创建表和数据库文件。下面在 Python Shell 中创建了它们：</p>
<pre>$ flask shell
&gt;&gt;&gt; from app import db
&gt;&gt;&gt; db.create_all()</pre>
<p>打开文件管理器，你会发现项目根目录下出现了新创建的数据库文件 data.db。这个文件不需要提交到 Git 仓库，我们在 .gitignore 文件最后添加一行新规则：</p>
<pre><code>*.db
</code></pre>
<p>如果你改动了模型类，想重新生成表模式，那么需要先使用 <code>db.drop_all()</code> 删除表，然后重新创建：</p>
<pre>&gt;&gt;&gt; db.drop_all()
&gt;&gt;&gt; db.create_all()</pre>
<p>注意这会一并删除所有数据，如果你想在不破坏数据库内的数据的前提下变更表的结构，需要使用数据库迁移工具，比如集成了 <a href="https://alembic.sqlalchemy.org/en/latest/" rel="nofollow">Alembic</a> 的 <a href="https://github.com/miguelgrinberg/Flask-Migrate">Flask-Migrate</a> 扩展。</p>
<p><strong>提示</strong> 上面打开 Python Shell 使用的是 <code>flask shell</code>命令，而不是 <code>python</code>。使用这个命令启动的 Python Shell 激活了“程序上下文”，它包含一些特殊变量，这对于某些操作是必须的（比如上面的 <code>db.create_all()</code>调用）。请记住，后续的 Python Shell 都会使用这个命令打开。</p>
<p>和 <code>flask shell</code>类似，我们可以编写一个自定义命令来自动执行创建数据库表操作：</p>
<pre>import click

@app.cli.command()  # 注册为命令
@click.option('--drop', is_flag=True, help='Create after drop.')  # 设置选项
def initdb(drop):
    """Initialize the database."""
    if drop:  # 判断是否输入了选项
        db.drop_all()
    db.create_all()
    click.echo('Initialized database.')  # 输出提示信息</pre>
<p>默认情况下，函数名称就是命令的名字，现在执行 <code>flask initdb</code> 命令就可以创建数据库表：</p>
<pre>$ flask initdb</pre>
<p>使用 <code>--drop</code> 选项可以删除表后重新创建：</p>
<pre>$ flask initdb --drop</pre>
<h2>创建、读取、更新、删除</h2>
<p>在前面打开的 Python Shell 里，我们来测试一下常见的数据库操作。你可以跟着示例代码来操作，也可以自由练习。</p>
<h3>创建</h3>
<p>下面的操作演示了如何向数据库中添加记录：</p>
<pre>&gt;&gt;&gt; from app import User, Movie  # 导入模型类
&gt;&gt;&gt; user = User(name='Grey Li')  # 创建一个 User 记录
&gt;&gt;&gt; m1 = Movie(title='Leon', year='1994')  # 创建一个 Movie 记录
&gt;&gt;&gt; m2 = Movie(title='Mahjong', year='1996')  # 再创建一个 Movie 记录
&gt;&gt;&gt; db.session.add(user)  # 把新创建的记录添加到数据库会话
&gt;&gt;&gt; db.session.add(m1)
&gt;&gt;&gt; db.session.add(m2)
&gt;&gt;&gt; db.session.commit()  # 提交数据库会话，只需要在最后调用一次即可</pre>
<p><strong>提示</strong> 在实例化模型类的时候，我们并没有传入 <code>id</code> 字段（主键），因为 SQLAlchemy 会自动处理这个字段。</p>
<p>最后一行 <code>db.session.commit()</code> 很重要，只有调用了这一行才会真正把记录提交进数据库，前面的 <code>db.session.add()</code> 调用是将改动添加进数据库会话（一个临时区域）中。</p>
<h3>读取</h3>
<p>通过对模型类的 <code>query</code> 属性调用可选的过滤方法和查询方法，我们就可以获取到对应的单个或多个记录（记录以模型类实例的形式表示）。查询语句的格式如下：</p>
<pre>&lt;模型类&gt;.query.&lt;过滤方法（可选）&gt;.&lt;查询方法&gt;</pre>
<p>下面是一些常用的过滤方法：</p>
<table>
<thead>
<tr>
<th>过滤方法</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>filter()</td>
<td>使用指定的规则过滤记录，返回新产生的查询对象</td>
</tr>
<tr>
<td>filter_by()</td>
<td>使用指定规则过滤记录（以关键字表达式的形式），返回新产生的查询对象</td>
</tr>
<tr>
<td>order_by()</td>
<td>根据指定条件对记录进行排序，返回新产生的查询对象</td>
</tr>
<tr>
<td>group_by()</td>
<td>根据指定条件对记录进行分组，返回新产生的查询对象</td>
</tr>
</tbody>
</table>
<p>下面是一些常用的查询方法：</p>
<table>
<thead>
<tr>
<th>查询方法</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>all()</td>
<td>返回包含所有查询记录的列表</td>
</tr>
<tr>
<td>first()</td>
<td>返回查询的第一条记录，如果未找到，则返回None</td>
</tr>
<tr>
<td>get(id)</td>
<td>传入主键值作为参数，返回指定主键值的记录，如果未找到，则返回None</td>
</tr>
<tr>
<td>count()</td>
<td>返回查询结果的数量</td>
</tr>
<tr>
<td>first_or_404()</td>
<td>返回查询的第一条记录，如果未找到，则返回404错误响应</td>
</tr>
<tr>
<td>get_or_404(id)</td>
<td>传入主键值作为参数，返回指定主键值的记录，如果未找到，则返回404错误响应</td>
</tr>
<tr>
<td>paginate()</td>
<td>返回一个Pagination对象，可以对记录进行分页处理</td>
</tr>
</tbody>
</table>
<p>下面的操作演示了如何从数据库中读取记录，并进行简单的查询：</p>
<pre data-eusoft-scrollable-element="1">&gt;&gt;&gt; from app import Movie  # 导入模型类
&gt;&gt;&gt; movie = Movie.query.first()  # 获取 Movie 模型的第一个记录（返回模型类实例）
&gt;&gt;&gt; movie.title  # 对返回的模型类实例调用属性即可获取记录的各字段数据
'Leon'
&gt;&gt;&gt; movie.year
'1994'
&gt;&gt;&gt; Movie.query.all()  # 获取 Movie 模型的所有记录，返回包含多个模型类实例的列表
[, ]
&gt;&gt;&gt; Movie.query.count()  # 获取 Movie 模型所有记录的数量
2
&gt;&gt;&gt; Movie.query.get(1)  # 获取主键值为 1 的记录
&lt;Movie 1&gt;
&gt;&gt;&gt; Movie.query.filter_by(title='Mahjong').first()  # 获取 title 字段值为 Mahjong 的记录
&lt;Movie 2&gt;
&gt;&gt;&gt; Movie.query.filter(Movie.title=='Mahjong').first()  # 等同于上面的查询，但使用不同的过滤方法
&lt;Movie 2&gt;</pre>
<p><strong>提示</strong> 我们在说 Movie 模型的时候，实际指的是数据库中的 movie 表。表的实际名称是模型类的小写形式（自动生成），如果你想自己指定表名，可以定义 <code>__tablename__</code> 属性。</p>
<p>对于最基础的 <code>filter()</code> 过滤方法，SQLAlchemy 支持丰富的查询操作符，具体可以访问<a href="http://docs.sqlalchemy.org/en/latest/core/sqlelement.html#sqlalchemy.sql.operators.ColumnOperators" rel="nofollow">文档相关页面</a>查看。除此之外，还有更多的查询方法、过滤方法和数据库函数可以使用，具体可以访问文档的 <a href="https://docs.sqlalchemy.org/en/latest/orm/query.html" rel="nofollow">Query API</a> 部分查看。</p>
<h3>更新</h3>
<p>下面的操作更新了 <code>Movie</code> 模型中主键为 <code>2</code> 的记录：</p>
<pre>&gt;&gt;&gt; movie = Movie.query.get(2)
&gt;&gt;&gt; movie.title = 'WALL-E'  # 直接对实例属性赋予新的值即可
&gt;&gt;&gt; movie.year = '2008'
&gt;&gt;&gt; db.session.commit()  # 注意仍然需要调用这一行来提交改动</pre>
<h3>删除</h3>
<p>下面的操作删除了 <code>Movie</code> 模型中主键为 <code>1</code> 的记录：</p>
<pre>&gt;&gt;&gt; movie = Movie.query.get(1)
&gt;&gt;&gt; db.session.delete(movie)  # 使用 db.session.delete() 方法删除记录，传入模型实例
&gt;&gt;&gt; db.session.commit()  # 提交改动</pre>
<h2>在程序里操作数据库</h2>
<p>经过上面的一番练习，我们可以在 Watchlist 里进行实际的数据库操作了。</p>
<h3>在主页视图读取数据库记录</h3>
<p>因为设置了数据库，负责显示主页的 <code>index</code> 可以从数据库里读取真实的数据：</p>
<pre>@app.route('/')
def index():
    user = User.query.first()  # 读取用户记录
    movies = Movie.query.all()  # 读取所有电影记录
    return render_template('index.html', user=user, movies=movies)</pre>
<p>在 <code>index</code> 视图中，原来传入模板的 <code>name</code> 变量被 <code>user</code> 实例取代，模板 index.html 中的两处 <code>name</code> 变量也要相应的更新为 <code>user.name</code> 属性：</p>
<pre>{{ user.name }}'s Watchlist</pre>
<h3>生成虚拟数据</h3>
<p>因为有了数据库，我们可以编写一个命令函数把虚拟数据添加到数据库里。下面是用来生成虚拟数据的命令函数：</p>
<pre>import click

@app.cli.command()
def forge():
    """Generate fake data."""
    db.create_all()
    
    # 全局的两个变量移动到这个函数内
    name = 'Grey Li'
    movies = [
        {'title': 'My Neighbor Totoro', 'year': '1988'},
        {'title': 'Dead Poets Society', 'year': '1989'},
        {'title': 'A Perfect World', 'year': '1993'},
        {'title': 'Leon', 'year': '1994'},
        {'title': 'Mahjong', 'year': '1996'},
        {'title': 'Swallowtail Butterfly', 'year': '1996'},
        {'title': 'King of Comedy', 'year': '1999'},
        {'title': 'Devils on the Doorstep', 'year': '1999'},
        {'title': 'WALL-E', 'year': '2008'},
        {'title': 'The Pork of Music', 'year': '2012'},
    ]
    
    user = User(name=name)
    db.session.add(user)
    for m in movies:
        movie = Movie(title=m['title'], year=m['year'])
        db.session.add(movie)
    
    db.session.commit()
    click.echo('Done.')</pre>
<p>现在执行 <code>flask forge</code> 命令就会把所有虚拟数据添加到数据库里：</p>
<pre>$ flask forge</pre>
<h2>本章小结</h2>
<p>本章我们学习了使用 SQLAlchemy 操作数据库，后面你会慢慢熟悉相关的操作。结束前，让我们提交代码：</p>
<pre>$ git add .
$ git commit -m "Add database support with Flask-SQLAlchemy"
$ git push</pre>
<p><strong>提示</strong> 你可以在 GitHub 上查看本书示例程序的对应 commit：<a spellcheck="false" href="https://github.com/greyli/watchlist/commit/4d2442a41e55fb454e092864206af08e4e3eeddf">4d2442a</a>。</p>
<h2>进阶提示</h2>
<ul>
<li>在生产环境，你可以更换更合适的 DBMS，因为 SQLAlchemy 支持多种 SQL 数据库引擎，通常只需要改动非常少的代码。</li>
<li>我们的程序只有一个用户，所以没有将 User 表和 Movie 表建立关联。访问 Flask-SQLAlchemy 文档的”<a href="http://flask-sqlalchemy.pocoo.org/2.3/models/#one-to-many-relationships" rel="nofollow">声明模型</a>“章节可以看到相关内容</li>
<li><a href="http://helloflask.com/book/" rel="nofollow">《Flask Web 开发实战》</a>第 5 章详细介绍了 SQLAlchemy 和 Flask-Migrate 的使用，第 8 章和第 9 章引入了更复杂的模型关系和查询方法。</li>
<li>阅读 <a href="https://docs.sqlalchemy.org/en/latest/" rel="nofollow">SQLAlchemy 官方文档和教程</a>详细了解它的用法。注意我们在这里使用 Flask-SQLAlchemy 来集成它，所以用法和单独使用 SQLAlchemy 有一些不同。作为参考，你可以同时阅读 <a href="http://flask-sqlalchemy.pocoo.org/2.3/" rel="nofollow">Flask-SQLAlchemy 官方文档</a> 。</li>
<li>本书主页 &amp; 相关资源索引：<a href="http://helloflask.com/tutorial" target="_blank" rel="noopener" data-editable="true" data-offset-key="eh3t9-1-0">http://helloflask.com/tutorial</a>。</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>https://greyli.com/flask-tutorial-chapter-5-database/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
	</channel>
</rss>
