這篇文章主要介紹了Python的SQLAlchemy架構使用入門,SQLAlchemy架構是Python中用來操作資料庫的ORM架構之一,需要的朋友可以參考下
資料庫表是一個二維表,包含多行多列。把一個表的內容用Python的資料結構表示出來的話,可以用一個list表示多行,list的每一個元素是tuple,表示一行記錄,比如,包含id和name的user表:
?
1 2 3 4 5 |
[ ('1', 'Michael'), ('2', 'Bob'), ('3', 'Adam') ] |
Python的DB-API返回的資料結構就是像上面這樣表示的。
但是用tuple表示一行很難看出表的結構。如果把一個tuple用class執行個體來表示,就可以更容易地看出表的結構來:
?
1 2 3 4 5 6 7 8 9 10 |
class User(object): def __init__(self, id, name): self.id = id self.name = name [ User('1', 'Michael'), User('2', 'Bob'), User('3', 'Adam') ] |
這就是傳說中的ORM技術:Object-Relational Mapping,把關聯式資料庫的表結構映射到對象上。是不是很簡單?
但是由誰來做這個轉換呢?所以ORM架構應運而生。
在Python中,最有名的ORM架構是SQLAlchemy。我們來看看SQLAlchemy的用法。
首先通過easy_install或者pip安裝SQLAlchemy:
?
1 |
$ easy_install sqlalchemy |
然後,利用上次我們在MySQL的test資料庫中建立的user表,用SQLAlchemy來試試:
第一步,匯入SQLAlchemy,並初始化DBSession:
?
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
# 匯入: from sqlalchemy import Column, String, create_engine from sqlalchemy.orm import sessionmaker from sqlalchemy.ext.declarative import declarative_base # 建立對象的基類: Base = declarative_base() # 定義User對象: class User(Base): # 表的名字: __tablename__ = 'user' # 表的結構: id = Column(String(20), primary_key=True) name = Column(String(20)) # 初始化資料庫連接: engine = create_engine('mysql+mysqlconnector://root:password@localhost:3306/test') # 建立DBSession類型: DBSession = sessionmaker(bind=engine) |
以上程式碼完成SQLAlchemy的初始化和具體每個表的class定義。如果有多個表,就繼續定義其他class,例如School:
?
1 2 3 4 |
class School(Base): __tablename__ = 'school' id = ... name = ... |
create_engine()用來初始化資料庫連接。SQLAlchemy用一個字串表示串連資訊:
'資料庫類型+資料庫驅動名稱://使用者名稱:口令@機器地址:連接埠號碼/資料庫名'
你只需要根據需要替換掉使用者名稱、口令等資訊即可。
下面,我們看看如何向資料庫表中添加一行記錄。
由於有了ORM,我們向資料庫表中添加一行記錄,可以視為添加一個User對象:
?
1 2 3 4 5 6 7 8 9 10 |
# 建立session對象: session = DBSession() # 建立新User對象: new_user = User(id='5', name='Bob') # 添加到session: session.add(new_user) # 提交即儲存到資料庫: session.commit() # 關閉session: session.close() |
可見,關鍵是擷取session,然後把對象添加到session,最後提交並關閉。Session對象可視為當前資料庫連接。
如何從資料庫表中查詢資料呢?有了ORM,查詢出來的可以不再是tuple,而是User對象。SQLAlchemy提供的查詢介面如下:
?
1 2 3 4 5 6 7 8 9 |
# 建立Session: session = DBSession() # 建立Query查詢,filter是where條件,最後調用one()返回唯一行,如果調用all()則返回所有行: user = session.query(User).filter(User.id=='5').one() # 列印類型和對象的name屬性: print 'type:', type(user) print 'name:', user.name # 關閉Session: session.close() |
運行結果如下:
?
1 2 |
type: <class '__main__.User'> name: Bob |
可見,ORM就是把資料庫表的行與相應的對象建立關聯,互相轉換。
由於關聯式資料庫的多個表還可以用外鍵實現一對多、多對多等關聯,相應地,ORM架構也可以提供兩個對象之間的一對多、多對多等功能。
例如,如果一個User擁有多個Book,就可以定義一對多關聯性如下:
?
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
class User(Base): __tablename__ = 'user' id = Column(String(20), primary_key=True) name = Column(String(20)) # 一對多: books = relationship('Book') class Book(Base): __tablename__ = 'book' id = Column(String(20), primary_key=True) name = Column(String(20)) # “多”的一方的book表是通過外部索引鍵關聯到user表的: user_id = Column(String(20), ForeignKey('user.id')) |
當我們查詢一個User對象時,該對象的books屬性將返回一個包含若干個Book對象的list。
小結
ORM架構的作用就是把資料庫表的一行記錄與一個對象互相做自動轉換。
正確使用ORM的前提是瞭解關聯式資料庫的原理。
注<>:更多精彩教程請關注三聯編程