# 數(shù)據(jù)庫表是一個二維表, 包含多行多列. 把一個表的內(nèi)容用pyton的數(shù)據(jù)接口表示的話, 可以用list表示多行
# list的每一個元素是tuple, 表示一個記錄.比如id 和name的user表
# [
#     ('1', 'Michael'),
#     ('2', 'Bob'),
#     ('3', 'Adam')
# ]

# Python的DB-API返回的數(shù)據(jù)接口就是像上面這樣.
# 但是用tuple表示一行很難看出表的結(jié)構(gòu).如果把一個tuple用class實例表示, 就可以更容易看出表的結(jié)構(gòu)

# class User(object):
#     def __init__(self, id, name):
#         self.id = id
#         self.name = name

# 這就是傳說中的ORM技術(shù): Object-Relational Mapping, 把關(guān)系數(shù)據(jù)庫的表結(jié)構(gòu)映射到對象上.
# 但是由誰來做這個轉(zhuǎn)換呢, 所以O(shè)RM框架應(yīng)運而生.
# 在Python中, 最有名的ORM框架是SQLAlchemy. 我們來看看SQLAlchemy的用法.

from sqlalchemy import Column, String, create_engine
from sqlalchemy.orm import sessionmaker
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class User(Base):
    # 表的名字
    __tablename__ = 'user'

    # 表的結(jié)構(gòu)
    id = Column(String(20), primary_key=True)
    name = Column(String(20))

# 初始化數(shù)據(jù)庫連接
engine = create_engine('mysql+mysqlconnector://root:111111@localhost:3306/test')
# 創(chuàng)建DBSession類型
DBSession = sessionmaker(bind=engine)
# create_engine用來初始化數(shù)據(jù)庫連接.
# SQLAlchemy用一個字符串表示連接信息'數(shù)據(jù)庫類型+數(shù)據(jù)庫驅(qū)動名稱://用戶名:口令@機(jī)器地址:端口號/數(shù)據(jù)庫名'

# # 創(chuàng)建session對象:
# session = DBSession()
# # 創(chuàng)建新User對象
# new_user = User(id='5', name='Bob')
# # 添加到session
# session.add(new_user)
# # 提交保存到數(shù)據(jù)庫
# session.commit()
# # 關(guān)閉session
# session.close()

# 可見將關(guān)鍵是獲取session, 然后把對象添加到session, 最后提交并關(guān)閉.(DBSession對象, 可以看做是當(dāng)前數(shù)據(jù)庫的連接)

# 查詢
session = DBSession()
# 創(chuàng)建Query查詢, filter是where條件, 最后調(diào)用one()返回唯一行, 如果調(diào)用all()則返回所有行.
user = session.query(User).filter(User.id=='5').one()
print('type:', type(user))
print('name:', user.name)
session.close()

# ORM就是把數(shù)據(jù)庫表的行與相應(yīng)的對象簡歷關(guān)聯(lián), 互相轉(zhuǎn)換.
# 由于關(guān)系數(shù)據(jù)庫的多個表還可以用外鍵實現(xiàn)一對多, 多對多的關(guān)聯(lián), 相應(yīng)地, ORM框架也可以提供兩個對象之間的一對多, 多對多功能.
# 例如, 如果一個User擁有多個Book, 就可以定義一對多關(guān)系如下
# 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)
#     nam = Column(String(20))
#     user_id = Column(String(20), ForeignKey('user.id'))