Flask-SQLAlchemy を使用して Python の Flask フレームワークでデータベースを管理するためのチュートリアル

class Role(db.Model): 
  # ...
  users = db.relationship('User', backref='role')

class User(db.Model): 
  # ...
  role_id = db.Column(db.Integer, db.ForeignKey('roles.id'))

リレーションシップは、外部キーを使用して 2 つの行を接続します。 Userモデルに追加したrole_id列を外部キーとして定義し、リレーションシップを確立します。 db.ForeignKey() のパラメータroles.idで指定された列は、rolesテーブルの行のid値を保持する列として理解されたい。
ロール モデルに追加された users 属性は、関係のオブジェクト指向のビューを表します。 Role クラスのインスタンスを指定すると、users プロパティはそのロールに接続されているユーザーのセットを返します。 db.relationship() に指定された最初のパラメーターは、モデル内の関係の反対側を示します。クラスが定義されていない場合、このモデルは文字列として提供できます。
注: 以前、segmentdefault で問題が発生したため、SQLAlchemy のソース コードをざっと読みました。 ForeignKey クラスのカラムは 3 種類のパラメータを受け取ります。1 つは「モデル名.属性名」、もう 1 つは「テーブル名.カラム名」です。次はそれを使用してみます。時間。
db.relationship() の backref パラメーターは、User モデルに role 属性を追加することで逆の関係を定義します。この属性を使用すると、外部キーではなくオブジェクトとして、role_id の代わりにロール モデルにアクセスできます。
ほとんどの場合、 db.relationship() は独自の外部キー関係を見つけることができますが、どの列が外部キーとして使用されているかを判断できない場合があります。たとえば、User モデルに、Role への外部キーとして定義された列が 2 つ以上ある場合、SQLAlchemy は 2 つの列のうちどれを使用すればよいのかわかりません。外部キーの設定があいまいな場合は、追加パラメータ db.relationship() を使用する必要があります。添え字には、関係を定義するために使用されるいくつかの一般的な構成オプションがリストされています:

常用SQLAlchemy关系选项

建议：如果你有克隆在GitHub上的应用程序，你现在可以运行git checkout 5a来切换到这个版本的应用程序。
除了一对多关系还有其他种类关系。一对一关系可以表述为前面描述的一对多关系，只要将db.relationship()中的uselist选项设置为False，“多”就变为“一”了。多对一关系也可表示为将表反转后的一对多关系，或表示为外键和db.relationship()定义在“多”那边。最复杂的关系类型，多对多，需要一个被称作关联表的额外表。你将在第十二章学习多对多关系。

数据库操作
学习怎样使用模型的最好方式就是使用Python shell。以下部分将介绍最常见的数据库操作。

创建表

首先要做的第一件事情就是指示Flask-SQLAlchemy基于模型类创建数据库。db.create_all()函数会完成这些：

(venv) $ python hello.py shell 
>>> from hello import db
>>> db.create_all()

>>> db.drop_all()
>>> db.create_all()

>>> from hello import Role, User
>>> admin_role = Role(name='Admin')
>>> mod_role = Role(name='Moderator')
>>> user_role = Role(name='User')
>>> user_john = User(username='john', role=admin_role) 
>>> user_susan = User(username='susan', role=user_role) 
>>> user_david = User(username='david', role=user_role)

>>> print(admin_role.id) None
>>> print(mod_role.id) None
>>> print(user_role.id) None

>>> db.session.add(admin_role)
>>> db.session.add(mod_role)
>>> db.session.add(user_role)
>>> db.session.add(user_john)
>>> db.session.add(user_susan)
>>> db.session.add(user_david)

>>> db.session.add_all([admin_role, mod_role, user_role,
...   user_john, user_susan, user_david])

>>> db.session.commit()

>>> print(admin_role.id) 
1
>>> print(mod_role.id)
2
>>> print(user_role.id) 
3

>>> admin_role.name = 'Administrator'
>>> db.session.add(admin_role)
>>> db.session.commit()

>>> db.session.delete(mod_role)
>>> db.session.commit()

>>> Role.query.all()
[<Role u'Administrator'>, <Role u'User'>]
>>> User.query.all()
[<User u'john'>, <User u'susan'>, <User u'david'>]

>>> User.query.filter_by(role=user_role).all()
[<User u'susan'>, <User u'david'>]

>>> str(User.query.filter_by(role=user_role))
'SELECT users.id AS users_id, users.username AS users_username,
users.role_id AS users_role_id FROM users WHERE :param_1 = users.role_id'

>>> user_role = Role.query.filter_by(name='User').first()

>>> users = user_role.users
>>> users
[<User u'susan'>, <User u'david'>]
>>> users[0].role
<Role u'User'>

class Role(db.Model): 
  # ...
  users = db.relationship('User', backref='role', lazy='dynamic') 
  # ...

>>> user_role.users.order_by(User.username).all()
[<User u'david'>, <User u'susan'>]
>>> user_role.users.count()
2