译者前言
SQLAlchemy是python的一个有名的数据库ORM,简单易用,功能强大,不需要什么xml,生成的SQL脚本干净简洁。
注意 0.4版本和0.5版本有部分不同,使用上需要注意版本差异问题,文档翻译内容会有些简化。
概述
SQLAlchemy SQL 工具包和和对象关系映射是一个综合的数据库工具,他有几个不通的方面,可以单独使用也可以组合使用,他的组件发布覆盖如下所画:
+--------------------------------------------------------------+
| Object Relational Mapper (ORM) |
+--------------------------------------------------------------+
+---------+ +------------------------------------+ +--------+
| | | SQL Expression Language | | |
| | +-------------------------------------+ | |
| +-----------------+ +--------------------+ |
| Dialect/Execution | | Schema Management |
+---------------------------+ +-----------------------------+
+---------------------------+ +-----------------------------+
| Connection Pooling | | Types |
+----------------------------+ +----------------------------+
上面有两个很重要的地方,一个是对象关系映射一个是SQL表达语言,这是两个独立的工具包,SQL表达语言使用独立于ORM,当使用ORM,通过对象关系配置使用SQL表达语言建立查询。
教程
- 对象关系教程 描述了SQLAlchemy对象关系映射的丰富功能,如果你想要用高级SQL实现自动化并管理Python对象,阅读这个教程
- SQL语言教程 SQLAlchemy的核心是SQL表达语言,是SQLAlchemy包含了的工具包,独立于ORM包,比ORM更轻量级,有着高扩展性,他也有对ORM的API接口,所以ORM高级用户也需要掌握这个
主要文档
- 映射配置(Mapper Configuration ) 一个ORM模式和技巧的综合演练
- 使用Session(Using the Session ) 对sqlalchemy session对象的详细描述
- 数据库引擎(Database Engines ) 描述sqlalchemy的数据库链接,包括数据库链接文档和使用数据库链接和事物
- 数据库元数据(Database Meta Data ) 规划管理元数据和表对象,读取数据库规格到应用程序中创建和删除表,约束,默认值,序列,索引。
- 连接池(Connection Pooling ) 更进一步的详解SQLAlchemy 连接词库
- 列和数据类型(Column and Data Types ) SQLAlchemy 包含了数据类型,函数,也可以创建自己定义类型
- sqlalchemy.ext 包含了SQLAlchemy的一些附加扩展
API 参考
SQLAlchemy APIs 有组织 API 参考
安装
通过setuptools安装 Sqlalchemy 是非常简单的,如果setuptools已经安装,运行下面命令
# easy_install SQLAlchemy
这个命令会下载最新的sqlalchemy安装
你也可以通过setup.py 安装
# python setup.py install
安装数据库API
Sqlalchemy 是根据 DB-API 接口设计的,支持多种数据库,支持的数据库列表 Supported Databases .
检查已安装的sqlalchemy版本
>>> import sqlalchemy
>>> sqlalchemy.__version__
0.5.0