支持的平台¶

SQLAlchemy已经针对以下平台进行了测试：

• cPython自2.6版开始，通过2.xx系列
• cPython版本3，贯穿所有3.xx系列
• Pypy 2.1 or greater

目前不支持的平台包括Jython，IronPython。曾经已经支持 Jython，并且可能会在将来的版本中支持，这取决于Jython本身的状态。

支持的安装方法¶

SQLAlchemy安装是通过基于setuptools的标准Python方法，通过直接引用setup.py或通过使用pip或其他setuptools，兼容的方法。

通过pip安装¶

当pip可用时，可以从Pypi下载并在一个步骤中安装该分发：

pip install SQLAlchemy

该命令将从Python Cheese Shop下载最新的发布的版SQLAlchemy并将其安装到您的系统中。

为了安装最新的prerelease版本，比如1.1.0b1，pip要求使用--pre标志：

pip install --pre SQLAlchemy

如上所述，如果最新版本是预发行版本，则将安装它而不是最新发布的版本。

使用setup.py ¶进行安装

否则，您可以使用setup.py脚本从分发安装：

python setup.py install

安装C扩展¶

SQLAlchemy包含C扩展，它提供了额外的速度提升来处理结果集。这些扩展在cPython的2.xx和3.xx系列上均受支持。

setup.py will automatically build the extensions if an appropriate platform is detected. 如果C扩展的构建失败，由于缺少编译器或其他问题，安装过程将输出警告消息，并在完成报告最终状态时重新运行没有C扩展的构建。

要运行构建/安装而不尝试编译C扩展，可以指定DISABLE_SQLALCHEMY_CEXT环境变量。对于这种情况的用例要么是针对特殊的测试环境，要么是通常的“重建”机制无法解决的罕见情况下的兼容性/构建问题：

export DISABLE_SQLALCHEMY_CEXT=1; python setup.py install

在Python 3上安装¶

SQLAlchemy直接在Python 2或Python 3上运行，并且可以在任何环境中安装，无需任何调整或代码转换。

安装数据库API ¶

SQLAlchemy旨在与针对特定数据库构建的DBAPI实现一起运行，并包含对最流行数据库的支持。The individual database sections in Dialects enumerate the available DBAPIs for each database, including external links.

检查安装的SQLAlchemy版本¶

本文档涵盖了SQLAlchemy版本1.1。如果您正在使用已安装SQLAlchemy的系统，请从您的Python提示符中检查版本，如下所示：

>>> import sqlalchemy
>>> sqlalchemy.__version__ # doctest: +SKIP
1.1.0