SQLAlchemy文档翻译第1章
2015-08-06 10:28
183 查看
第一章 概述
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
相关文章推荐
- Android之获取手机上的图片和视频缩略图thumbnails
- Python动态类型的学习---引用的理解
- Python3写爬虫(四)多线程实现数据爬取
- 垃圾邮件过滤器 python简单实现
- 下载并遍历 names.txt 文件,输出长度最长的回文人名。
- install and upgrade scrapy
- Scrapy的架构介绍
- Centos6 编译安装Python
- 使用Python生成Excel格式的图片
- 让Python文件也可以当bat文件运行
- [Python]推算数独
- Python中zip()函数用法举例
- Python中map()函数浅析
- 数据库链接字符串查询网站
- Python将excel导入到mysql中
- Python在CAM软件Genesis2000中的应用
- 使用Shiboken为C++和Qt库创建Python绑定