SQLAlchemy 0.5 中文文档 ---- 对象关系（1）

在这篇教程里我们将封装一个基本的SQLAlchemy对象关系映射脚本，通过数据库表现来存储和检索python对象

 

版本检查

 

检查当前安装的sqlalchemy是否为0.5版本

 

>>> import sqlalchemy
>>> sqlalchemy.__version__ 
0.5.0

 

建立链接

 

这里我们使用sqlite数据库，使用create_engine()连接

 

 

>>> from sqlalchemy import create_engine
>>> engine = create_engine('sqlite:///:memory:', echo=True)

 

echo 表示是否打开sqlalchemy的日志输出，使用的是python标准的日志组件，echo开启后，我们将会看到所有生成的sql.

 

定义和创建表

 

下一步我们把表告诉给sqlalchemy,我们先作一个users表来存储末端用户（假设是网站的用户）,我们在 MetaData范围内

定义表,使用类似SQL脚本的结构.。

 

>>> from sqlalchemy import Table, Column, Integer, String, MetaData, ForeignKey
>>> metadata = MetaData()
>>> users_table = Table('users', metadata,
...     Column('id', Integer, primary_key=True),
...     Column('name', String),
...     Column('fullname', String),
...     Column('password', String)
... )

 下一步我们可以通过调用 create_all() 来发布创建表的声明，

 

>>> metadata.create_all(engine) 
PRAGMA table_info("users")
 {} 
CREATE TABLE users (
 id INTEGER NOT NULL, 
name VARCHAR,
 fullname VARCHAR, 
password VARCHAR, 
PRIMARY KEY (id) ) 
{}
 COMMIT

 你会发现 VARCHAR 列没有指定长度,SQLite下是可以的，不过大多数其它数据库是不允许的，如果你想指定长度可以这样

 

Column('name', String(50))

 

这个也适合用在其它可变长度的字段类型。

 

用python对象定义表映射

 

我们来定义一个基本的用户类

>>> class User(object):
...     def __init__(self, name, fullname, password):
...         self.name = name
...         self.fullname = fullname
...         self.password = password
...
...     def __repr__(self):
...        return "<User('%s','%s', '%s')>" % (self.name, self.fullname, self.password)

 

设置映射

 

我们把users_table 和 User 绑定结合,使用sqlalchemy的 mapper创建映射

 

>>> from sqlalchemy.orm import mapper
>>> mapper(User, users_table) 
<Mapper at 0x...; User>

 

mapper()函数创建了新的对象和和存储之间的映射， 现在我们创建和检查用户对象

>>> ed_user = User('ed', 'Ed Jones', 'edspassword')
>>> ed_user.name
'ed'
>>> ed_user.password
'edspassword'
>>> str(ed_user.id)
'None'

 

 

 

 

id属性没有定义在 __init__() 中,他存在于 users_table

 

一次性创建表，对象和映射  

 

>>> from sqlalchemy.ext.declarative import declarative_base

>>> Base = declarative_base()
>>> class User(Base):
...     __tablename__ = 'users'
...
...     id = Column(Integer, primary_key=True)
...     name = Column(String)
...     fullname = Column(String)
...     password = Column(String)
...
...     def __init__(self, name, fullname, password):
...         self.name = name
...         self.fullname = fullname
...         self.password = password
...
...     def __repr__(self):
...        return "<User('%s','%s', '%s')>" % (self.name, self.fullname, self.password)

  

 上面 declarative_base() 功能实现了一个新的类Base，User 继承 Base

 

创建Session

 

orm操作数据库用的是session

 

 

 

>>> from sqlalchemy.orm import sessionmaker
>>> Session = sessionmaker(bind=engine)

 如果没有engine 可以如下定义

 

 

>>> Session = sessionmaker()

 实例化session

>>> session = Session()