SQLAlchemy(1) -- Python的SQLAlchemy和ORM

Python的SQLAlchemy和ORM(object-relational mapping:对象关系映射）

web编程中有一项常规任务就是创建一个有效的后台数据库。以前，程序员是通过写sql语句，发送到数据库引擎，解析并返回一个记录的数组。现在，程序员可以写ORM程序来取代之前那种不灵活、难以维护的冗长、易出错的sql语句。

ORM是面向对象编程语言中用来在不兼容的类型系统(incompatible type systems)之间转换数据的一种编程技术。通常在OO语言中的类型系统，比如python包含的类型是非标量的，也就是说这些类型不能使用原始的类型比如(integer、string)来表达。比如，一个person对象可能含有一个address对象的列表，和一个phonenumber对象的列表。同理，一个address对象可能包含一个postcode对象，一个streetname对象和一个streetnumber对象。尽管简单对象比如postcode、streetname可以用字符串来表示，但是更复杂的对象比如address、person就不能仅仅用字符串、整形数字来表示了。此外，这些复杂的对象还会具有实例或类方法，这些就更不能简单用字符串或整形数字来表示了。

为了处理这些复杂的对象管理问题，人们设计了ORM。上面我们的示例可以用一个ORM系统表示出来：设计一个person类、address类、phonenumber类，每个类映射到数据库中的一张表。这样就不再需要编写各种冗长的数据接口程序，而可以更加专注于系统的逻辑设计。

python中写数据库的代码(旧的方式)

使用pymysql创建两张表：

编写python脚本pymysql_ex.py并执行：

$ python pymysql_ex.py

#!/usr/bin/env python
# _*_ coding:utf-8 _*_

import pymysql

#创建链接
conn = pymysql.connect(host='127.0.0.1', port=3306, user='abce', passwd='abce', db='abce', charset='utf8')

#创建游标
c = conn.cursor()

#执行sql建表,插入内容
c.execute('''
          create table person
          (id integer primary key, name varchar(250) not null)
          ''')
c.execute('''
          create table address
          (id integer primary key, street_name varchar(250), street_number varchar(250),
           post_code varchar(250) not null, person_id integer not null,
           foreign key(person_id) references person(id))
          ''')

c.execute('''
          insert into person values(1, 'pythoncentral')
          ''')
c.execute('''
          insert into address values(1, 'python road', '1', '00000', 1)
          ''')

#提交
conn.commit()

#关闭游标
c.close()

#关闭连接
conn.close()

编写脚本pymysql_q.py查看数据库表的内容：

#!/usr/bin/env python
# _*_ coding:utf-8 _*_

import pymysql

#创建连接
conn = pymysql.connect(host='127.0.0.1', port=3306, user='abce', passwd='abce', db='abce', charset='utf8')

#创建游标
c = conn.cursor()

#执行sql查看表内容
c.execute('select * from person')
print(c.fetchall())
c.execute('select * from address')
print(c.fetchall())

#关闭游标
c.close()

#关闭连接
conn.close()

$ python pymysql_q.py
((1, u'pythoncentral'),)
((1, u'python road', u'1', u'00000', 1),)

例子中我们使pymysql连接提交对数据库的修改，并使用pymysql的游标来执行各种sql语句。尽管这些sql语句完成了相关的工作，但是维护sql语句的本身也不是件容易的事。下面，我们来看看sqlalchemy在Python得类和表之间是如何映射的。

　　

Python's SQLAlchemy and Declarative

写SQLAlchemy代码有三个重要组件：
--数据库中的表
--mapper：将python的类映射到数据库中的表
--类对象，定义如何将数据库的记录映射到一个python对象

不需要在不同的地方写表、mapper、class的代码，SQLAlchemy的declarative支持将表、mapper和类对象定义到一个类中。

下面创建一个declarative (sqlalchemy_declarative.py)

#!/usr/bin/env python
# _*_ coding:utf-8 _*_
import pymysql
import os
import sys
from sqlalchemy import Column, ForeignKey, Integer, String
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import relationship
from sqlalchemy import create_engine

Base = declarative_base()

class Person(Base):
    __tablename__ = 'person'
    # Here we define columns for the table person
    # Notice that each column is also a normal Python instance attribute.
    id = Column(Integer, primary_key=True)
    name = Column(String(250), nullable=False)

class Address(Base):
    __tablename__ = 'address'
    # Here we define columns for the table address.
    # Notice that each column is also a normal Python instance attribute.
    id = Column(Integer, primary_key=True)
    street_name = Column(String(250))
    street_number = Column(String(250))
    post_code = Column(String(250), nullable=False)
    person_id = Column(Integer, ForeignKey('person.id'))
    person = relationship(Person)

# 连接数据库采用pymysq模块做映射，后面参数是最大连接数5
engine = create_engine('mysql+pymysql://abce:abce@127.0.0.1:3306/abce?charset=utf8', max_overflow=5)

# Create all tables in the engine. This is equivalent to "Create Table"
# statements in raw SQL.
Base.metadata.create_all(engine)

执行脚本，就会创建了相应的数据库表

$ python sqlalchemy_declarative.py

　　

接下来，我们插入一些数据(sqlalchemy_insert.py)

#!/usr/bin/env python
# _*_ coding:utf-8 _*_
import pymysql
from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker

from sqlalchemy_declarative import Address, Base, Person

engine = create_engine('mysql+pymysql://abce:abce@127.0.0.1:3306/abce?charset=utf8')
# Bind the engine to the metadata of the Base class so that the
# declaratives can be accessed through a DBSession instance
Base.metadata.bind = engine

DBSession = sessionmaker(bind=engine)
# A DBSession() instance establishes all conversations with the database
# and represents a "staging zone" for all the objects loaded into the
# database session object. Any change made against the objects in the
# session won't be persisted into the database until you call
# session.commit(). If you're not happy about the changes, you can
# revert all of them back to the last commit by calling
# session.rollback()
session = DBSession()

# Insert a Person in the person table
new_person = Person(name='new person')
session.add(new_person)
session.commit()

# Insert an Address in the address table
new_address = Address(post_code='00000', person=new_person)
session.add(new_address)
session.commit()

从数据库后台可以直接看到数据：

mysql> select * from person;
+----+------------+
| id | name       |
+----+------------+
|  1 | new person |
+----+------------+
1 row in set (0.00 sec)

mysql> select * from address;
+----+-------------+---------------+-----------+-----------+
| id | street_name | street_number | post_code | person_id |
+----+-------------+---------------+-----------+-----------+
|  1 | NULL        | NULL          | 00000     |         1 |
+----+-------------+---------------+-----------+-----------+
1 row in set (0.00 sec)

mysql>

　　

当然我们得重点是从python中查看插入的数据：

>>> from sqlalchemy_declarative import Person, Base, Address
>>> from sqlalchemy import create_engine
>>> engine = create_engine('mysql+pymysql://abce:abce@172.0.0.1:3306/abce?charset=utf8')
>>> Base.metadata.bind = engine
>>> from sqlalchemy.orm import sessionmaker
>>> DBSession = sessionmaker()
>>> DBSession.bind = engine
>>> session = DBSession()
>>> # Make a query to find all Persons in the database
>>> session.query(Person).all()
[<sqlalchemy_declarative.Person object at 0x21c7390>]
>>>
>>> # Return the first Person from all Persons in the database
>>> person = session.query(Person).first()
>>> person.name
u'new person'
>>>
>>> # Find all Address whose person field is pointing to the person object
>>> session.query(Address).filter(Address.person == person).all()
[<sqlalchemy_declarative.Address object at 0x22b08d0>]
>>>
>>> # Retrieve one Address whose person field is point to the person object
>>> session.query(Address).filter(Address.person == person).one()
<sqlalchemy_declarative.Address object at 0x22b08d0>
>>> address = session.query(Address).filter(Address.person == person).one()
>>> address.post_code
u'00000'

　　

总结
以上就是如何使用sqlalchemy的declaratives来编写数据库代码。和传统的sql语句相比，显得更面向对象、更易于理解和维护。

参考原文地址：http://pythoncentral.io/introductory-tutorial-python-sqlalchemy/