SQLAlchemy文档翻译第1章

第一章 概述

SQLAlchemy SQL工具包和对象关系模型，是一个调谐数据库和python工作的完整工具集合。它有几个清晰的可以单独或组合在一起使用的模块。它的主要的组件以及组件间的依赖关系分层在下面被插图说明：

尤其，放在面前的两个最有意义的部分是ORM（Object Relational Mapper，对象关系映射模型)和SQL表达式语言。SQL的表达可以独立于ORM。当用ORM的时候，部分SQL表达式语言被用关系数据结构和多种query的形式被保留成面向公众的API（Application Program Interface,应用程序接口）。

1.1 文档概述

本文档分为三个部分：SQLAlchemy ORM，SQLAlchemy核心和方言（这里是把SQLAlchemy在具体数据库上的应用比喻为方言）。
在SQLAlchemy ORM部分，对象关系映射模型进行了说明和充足的描述。新的使用者应该从对象关系指南开始。如果你想用更高级的可以自动构建的SQL工作，并且管理python项目，请进入指南。

在SQLAlchemy核心部分，SQLAlchemy的SQL和数据库的融合和服务的描述被文档宽度的描述，核心是SQL表达式语言（我感觉这部分就是讲SQLAlchemy怎么执行SQL语句）。SQL表达式语言是一个完全属于自己且独立于ORM包的工具包，它可以被用来操纵SQL的表达，包括程序性的构建，改善，执行
，返回游标的结果集。对比ORM的以域为中心的处理方法，表达式语言提供了一个以模式为中心的处理范例。新的使用者应该从SQL表达式语言指南开始。SQLAlchemy的引擎，链接和服务池也在SQLAchemy的核心部分被说明。

在方言部分，所有涉及到被给予的数据库和数据库后台的接口的文档被提供。

1.2 代码实例

几乎全部涉及到ORM的可运行的代码实例，被包含在SQLAlchemy的分布中。所有包含例子的应用的描述在ORM实例中。

更多的关于SQLAlchemy核心和ORM的例子在wiki（维基百科）中。见Theatrum Chemicum。

1.3 安装向导

1.3.1 支持的平台

SQLAlchemy已经对下面的平台进行了测试：
•cPython 版本2.6，包括2.xx
•cPython 版本3，包括3.xx
•Pypy2.1或者更时间久远的版本

在0.9版本以后，Python2.6是SQLAlchemy支持的最低python版本。

当前不能支持的平台包括Jython，IronPython。Jython在过去被支持，在将来也可能被支持，这取决于Jython环境本身。

1.3.2 支持的安装方法

SQLAlchemy 支持用python标准的“distitils”或“seruotools”方法安装。具体的安装概述如下：
•清晰的 Python Distutils - SQLAlchemy 可以用通过Python Distutils，用sety.py脚本进行一个干净的安装。C扩展和python3构建也被支持。
• Setuptools or Distribute - 用setuptools时，SQLAlchemy可以通过setup.py或者easy_install进行安装。并且C扩展被支持。
• pip - pip是一个基于setuptools 和 distribute，用来替代easy_install方法的安装方法。它因更简单的处理方法而更被人们喜欢。

1.3.3 通过pip安装

当pip可用时，distribution可以从Pypi下载，通过下面的步骤安装：

pip install SQLAlchemy

这个命令会从python奶酪商店下载SQLAlchemy的最新发布版本，并且安装它到你的系统上。
为了安装最近的早前版本，例如1.0.0b1，pip需要–pre选项：

pip install --pre SQLAlchemy

如果最近的版本是早先发布的，它将被安装而不是最新的版本。

1.3.4 用setup.py安装

另外你可以从distribution用setup.py脚本安装：

python serup.py install

1.3.5 安装C扩展

SQLAlchemy 包括提供了速度加强的处理结果集的C扩展。这些扩展支持cPython2.xx和cPython3.xx。

在0.9.0版本后，C扩展可以编写在python3和python2中。

如果合适的平台被选择，setup.py将自动地构建那些扩展。如果C扩展因为miss编译或者其他故障构建失败，这个构建过程将输出一条错误信息，并且返回没有C扩展构建的状态。

去运行build/install而不是去尝试编译C扩展，DISABLE_SQLALCHEMY_CEXT的环境压力可以被验证。下面是特殊的测试情况的用例（这里没翻译全先放这里，这里大概是说依赖不足时怎么办，有空回来补，安装遇到问题可以给我留言，还有这文档的英文大长从句真是让人难以适应，我小学没毕业，英语能力极其有限，希望多包涵。到这大家应该安装没有问题，所以直接1.3.8了，中间的等有空回来补）：

*** only in SQLAlchemy 0.9.4 / 0.8.6 or greater ***
export DISABLE_SQLALCHEMY_CEXT=1; python setup.py install

1.3.8 核对以安装的SQLAlchemy版本

如果你正在在你的系统上运行已经安装的SQLAlchemy，请从python命令行核对它的版本，像下面这样：

>>> import sqlalchemy
>>> sqlalchemy.__version__
1.0.0