[程序]sqlalchemy文档资料翻译(一)
- 概述
SQLAlchemy是一套用于python访问数据库的较为成熟的解决方案,其包含的功能可单独使用,也可组合使用。其中最主要的组件描述如下(箭头代表组件之间的基本依赖关系):
SQLAlchemy中最重要的两个部分当属Object Relational Mapper(ORM) 和SQL Expression Language。SQL Expressions可独立于ORM使用,当然在使用ORM的时候, SQL Expression language仍然保留部分用于面向对象配置和查询的公共接口函数。
-
教程
Object Relational Tutorial - 本教程主要描述SQLAlchemy的最主要特性ORM,如果你仅仅是想了解一些高层的SQL功能以及python对象的管理,那么推荐此教程。
SQL Expression Language Tutorial - 本教程是SQLAlchemy的核心。SQL Expression Language是独立于ORM包的一套自成体系的工具集,它可以用来创建易于使用的SQL表达式,该SQL表达式在程序上易于创建、修改和执行,返回游标类型的结果集。SQL Expression Language相较于ORM更加轻量级并且更适合于灵活的SQL操作,同时它也经常出现在ORM的公共接口中,因此对于ORM的高级用户来说也需要掌握此语言。
-
主要文档
Mapper Configuration - ORM模式和技术简介。
Using the Session - SQLAlchemy中Session对象的详细介绍文档。
Database Engines - 介绍SQLAlchemy中的数据库连接工具。
Database Meta Data - 关于使用MetaData和Table对象对schema进行管理的一切,如在应用程序中访问数据库中的schemas,创建和删除tables, constraints, defaults, sequences, indexes。
Connection Pooling - SQLAlchemy连接池相关的更多细节。
Column and Data Types - SQLAlchemy中的数据类型及相关方法,以及如何创建自己的数据类型。
sqlalchemy.ext - SQLAlchemy插件相关
- 代码示例
一些代码示例,参考Examples。
-
API参考
所有SQLAlchemy API参考API Reference。
- 安装SQLAlchemy
建议先安装setuptools,安装完成后在命令行输入如下命令:
# easy_install SQLAlchemy第二种安装方式,则需要首先下载SQLAlchemy发布版本,将其解压后在命令行输入:
# python setup.py install
- 安装Database API
SQLAlchemy设计用于和DB-API协作处理数据库,目前支持的数据库包括Supported Databases。
- 检查已安装的SQLAlchemy版本
>>> import sqlalchemy >>> sqlalchemy.__version__ 0.6.0