SQLAlchemy 0.5 中文文档 ---- 概述

译者前言

 

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