配置

下面是 Flask-SQLAlchemy 中存在的配置值。 Flask-SQLAlchemy 从你的 Flask 主配置(可以以多种方式填充)中加载这些值。注意其中的一些在引擎创建后不 能修改,所以确保尽早配置且不在运行时修改它们。

配置键

一个该扩展当前理解的配制键清单:

SQLALCHEMY_DATABASE_URI

用于连接的数据库 URI 。例如:

  • sqlite:////tmp/test.db
  • mysql://username:password@server/db
SQLALCHEMY_BINDS 一个映射 binds 到连接 URI 的字典。更多 binds 的信息见 用 Binds 操作多个数据库
SQLALCHEMY_ECHO 如果设置为 Ture , SQLAlchemy 会记录所有 发给 stderr 的语句,这对调试有用。
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 小时。

New in version 0.8: 添加了 SQLALCHEMY_NATIVE_UNICODE`, SQLALCHEMY_POOL_SIZE, SQLALCHEMY_POOL_TIMEOUTSQLALCHEMY_POOL_RECYCLE 配置键。

New in version 0.12: 添加了 SQLALCHEMY_BINDS 配置键。

连接 URI 格式

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

SQLAlchemy 把一个引擎的源表示为一个连同设定引擎选项的可选字符串参数的 URI 。 URI 的形式是:

dialect+driver://username:[email protected]:port/database

该字符串中的许多部分是可选的。如果没有指定驱动器,会选择默认的 (确保不 在这种情况下包含 + )。

Postgres:

postgresql://scott:[email protected]/mydatabase

MySQL:

mysql://scott:[email protected]/mydatabase

Oracle:

oracle://scott:[email protected]:1521/sidname

SQLite (注意开头的四个斜线):

sqlite:////absolute/path/to/foo.db

Table Of Contents

Related Topics

This Page