在这篇教程里我们将封装一个基本的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()