【Flask】Flask-SQLAlchemy安装及基本设置

妖狐艹你老母 2022-04-05 15:10 221阅读 0赞

ORM（Object-Relation Mapping）：对象-关系映射。  
在Flask中，若要很好的使用ORM， SQLAlchemy是一个必由的选择。

*  SQLALchemy 实际上是对数据库的抽象，让开发者不用直接和 SQL 语句打交道，而是通过 Python 对象来操作数据库，在舍弃一些性能开销的同时，换来的是开发效率的较大提升
 *  SQLAlchemy是一个关系型数据库框架，它提供了高层的 ORM 和底层的原生数据库的操作。flask-sqlalchemy 是一个简化了 SQLAlchemy 操作的flask扩展。
 *  文档地址：[http://docs.jinkan.org/docs/flask-sqlalchemy][http_docs.jinkan.org_docs_flask-sqlalchemy]

### 安装 ###

*  安装 flask-sqlalchemy

pip install flask-sqlalchemy

*  windows中必须安装mysqlclient, 而且版本必须是1.3.12, 否则mysqldb可能安装不成功

pip install mysqlclient==1.3.12

*  如果连接的是 mysql 数据库，需要安装 mysqldb

pip install flask-mysqldb

【注意】 windows系统下可能报1366异常, 解决方案如下

> 安装`pip install mysql-connector`
> 
> 连接路径改成: `"mysql+mysqlconnector://root:mysql@127.0.0.1:3306/test_27"`

### 数据库连接设置 ###

*  在 Flask-SQLAlchemy 中，数据库使用URL指定，而且程序使用的数据库必须保存到Flask配置对象的 **SQLALCHEMY\_DATABASE\_URI** 键中

app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:mysql@127.0.0.1:3306/test'

*  其他设置：

# 动态追踪修改设置，如未设置只会提示警告
    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = True
    #查询时会显示原始SQL语句
    app.config['SQLALCHEMY_ECHO'] = True

*  配置完成需要去 MySQL 中创建项目所使用的数据库

mysql -uroot -pmysql
    create database test charset=utf8;

*  其他配置

<table> 
 <thead> 
  <tr> 
   <th>名字</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>SQLALCHEMY_DATABASE_URI</td> 
   <td>用于连接的数据库 URI 。例如:sqlite:tmp/test.dbmysql://username:password@server/db</td> 
  </tr> 
  <tr> 
   <td>SQLALCHEMY_BINDS</td> 
   <td>一个映射 binds 到连接 URI 的字典。更多 binds 的信息见<a href="http://docs.jinkan.org/docs/flask-sqlalchemy/binds.html#binds" rel="nofollow"><em>用 Binds 操作多个数据库</em></a>。</td> 
  </tr> 
  <tr> 
   <td>SQLALCHEMY_ECHO</td> 
   <td>如果设置为Ture， SQLAlchemy 会记录所有 发给 stderr 的语句，这对调试有用。(打印sql语句)</td> 
  </tr> 
  <tr> 
   <td>SQLALCHEMY_RECORD_QUERIES</td> 
   <td>可以用于显式地禁用或启用查询记录。查询记录 在调试或测试模式自动启用。更多信息见get_debug_queries()。</td> 
  </tr> 
  <tr> 
   <td>SQLALCHEMY_NATIVE_UNICODE</td> 
   <td>可以用于显式禁用原生 unicode 支持。当使用 不合适的指定无编码的数据库默认值时，这对于 一些数据库适配器是必须的（比如 Ubuntu 上 某些版本的 PostgreSQL ）。</td> 
  </tr> 
  <tr> 
   <td>SQLALCHEMY_POOL_SIZE</td> 
   <td>数据库连接池的大小。默认是引擎默认值（通常 是 5 ）</td> 
  </tr> 
  <tr> 
   <td>SQLALCHEMY_POOL_TIMEOUT</td> 
   <td>设定连接池的连接超时时间。默认是 10 。</td> 
  </tr> 
  <tr> 
   <td>SQLALCHEMY_POOL_RECYCLE</td> 
   <td>多少秒后自动回收连接。这对 MySQL 是必要的， 它默认移除闲置多于 8 小时的连接。注意如果 使用了 MySQL ， Flask-SQLALchemy 自动设定 这个值为 2 小时。</td> 
  </tr> 
 </tbody> 
</table>

### 连接其他数据库 ###

完整连接 URI 列表请跳转到 SQLAlchemy 下面的文档 ([Supported Databases][]) 。这里给出一些 常见的连接字符串。

*  Postgres:

postgresql://scott:tiger@localhost/mydatabase

*  MySQL:

mysql://scott:tiger@localhost/mydatabase

*  Oracle:

- oracle://scott:tiger@127.0.0.1:1521/sidname

*  SQLite （注意开头的四个斜线）:

sqlite:absolute/path/to/foo.db

[http_docs.jinkan.org_docs_flask-sqlalchemy]: http://docs.jinkan.org/docs/flask-sqlalchemy
[Supported Databases]: http://www.sqlalchemy.org/docs/core/engines.html