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

最新推荐文章于 2025-10-16 18:36:54 发布

最新推荐文章于 2025-10-16 18:36:54 发布 · 221 阅读

文章标签：

#SQL #ORM #Python #配置管理 #EXT

Python 专栏收录该内容

14 篇文章

订阅专栏

本文介绍SQLAlchemy的功能特性，包括其核心SQL表达语言和对象关系映射（ORM）。提供了ORM和SQL语言教程，以及如何安装和配置SQLAlchemy进行数据库操作。

译者前言

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