依照慣例，本文開頭先提供Flask-SQLAlchemy的官方文檔地址

Flask框架之所以強大有一個重要因素是良好的生態系統支持用戶對原框架進行擴展，Flask-SQLAlchemy就是一個擴展插件，其作用是幫助用戶操作數據庫（增、刪、改、查、創表、提交事務等等），或者說這是一個ORM插件（O-Object、R-Relational、M-Mapping，簡言之就是用對象去表達數據結構的插件）。顯然，使用Flask-SQLAlchemy最大的好處就是操作不同的數據庫時不必關注數據庫特異性，一套代碼重復利用。

使用Flask-SQLAlchemy

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
db = SQLAlchemy(app)

引入flask_sqlalchemy插件，調用SQLAlchemy和flask app綁定

調用SQLAlchemy是因為這是flask_sqlalchemy提供的一個__init__函數，源碼：

#: Default query class used by :attr:`Model.query` and other queries.
   #: Customize this by passing ``query_class`` to :func:`SQLAlchemy`.
   #: Defaults to :class:`BaseQuery`.
   Query = None

  def __init__(self, app=None, use_native_unicode=True, session_options=None,
                metadata=None, query_class=BaseQuery, model_class=Model):

       self.use_native_unicode = use_native_unicode
       self.Query = query_class
       self.session = self.create_scoped_session(session_options)
       self.Model = self.make_declarative_base(model_class, metadata)
       self._engine_lock = Lock()
       self.app = app
       _include_sqlalchemy(self, query_class)

       if app is not None:
           self.init_app(app)

PS：通過看源碼應該能發現調用SQLAlchemy時app是可以不用傳入的，可以初始化時再調用init_app傳入app，這特別適用于工廠函數創建app的情況

使用Flask-SQLAlchemy創建表

class User(db.Model):
    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)
    email = db.Column(db.String(120), unique=True, nullable=False)

    def __repr__(self):
        return '<User %r>' % self.username

核心是創建一個類繼承Model屬性（Model屬性是啥，可以按照上面的源碼去查看）
這里講一下代碼含義：

• __tablename__ = 'users'是給表命名（這句也可以省略，但是一般表名還是推薦自己取）

•   id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)
    email = db.Column(db.String(120), unique=True, nullable=False)
  

  這部分是添加表的字段，以及相應字段的屬性

•   def __repr__(self):
        return '<User %r>' % self.username
  

  這兩行是python對象的__repr__方法，重寫是為了方便程序員查看對象，不屬于flask-sqlalchemy提供的特殊內容

當然，這是最簡單的數據表，實際操作中肯定會涉及到數據表的互相關聯。這一部分實際是數據庫的基礎知識而不是Flask-SQLAlchemy的獨特內容。簡單提一下Flask-SQLAlchemy是有APIForeignKey、relationship幫助我們創表時關聯數據表的。具體內容可以查看上面的官方文檔。

使用Flask-SQLAlchemy進行增、刪、改、查

做數據庫基本操作必然涉及到數據庫事務，這里先說如何使用SQLAlchemy提交事務

db.session.add(xxx)
db.session.delete(xxx)
db.session.commit()

session API中帶有add、delete等方法，直接調用即可，最后再commit。當然，如同寫SQL語句一樣，針對不同的操作還有更多API，例如session.add_all()、session.rollback()等等，這里不詳述了。

前面說了相關的API，現在總結一下增、刪、改、查具體操作。

from yourapp import User
me = User('admin', 'admin@example.com')
db.session.add(me)
db.session.commit()

以添加一條記錄為例，所有的執行都是遵循三個步驟

• 創建一個python對象（這個對象是相應數據表類的一個實例，也就是相應數據表的一條記錄）
• 調用session中的API
• 提交事務

db.session.delete(me)
db.session.commit()

刪除一條記錄也是類似的

admin = Role.query.filter_by(name='Admin').first()

查詢表中某條記錄可以直接調用對象的query方法，相當于SELECT語句

admin = Role.query.filter_by(name='Admin').first()
if admin is not None:
    admin.name = 'admin'
    db.session.add(admin)
    db.session.commit()

修改記錄可以綜合查找和添加兩步：

• 查出記錄
• 修改
• 提交

至此，使用Flask-SQLALchemy進行數據庫基本操作已經都介紹完了，復雜的用法請查看開頭的官方文檔。