SQLAlchemy ORM - 建立关系


本课程描述了另一个表的创建,该表与我们数据库中已有的表相关。客户表包含客户的主数据。我们现在需要创建发票表,其中可能包含属于客户的任意数量的发票。这是一对多关系的情况。

使用声明式,我们定义该表及其映射类 Invoices,如下所示 -

from sqlalchemy import create_engine, ForeignKey, Column, Integer, String
engine = create_engine('sqlite:///sales.db', echo = True)
from sqlalchemy.ext.declarative import declarative_base
Base = declarative_base()
from sqlalchemy.orm import relationship

class Customer(Base):
   __tablename__ = 'customers'

   id = Column(Integer, primary_key = True)
   name = Column(String)
   address = Column(String)
   email = Column(String)

class Invoice(Base):
   __tablename__ = 'invoices'
   
   id = Column(Integer, primary_key = True)
   custid = Column(Integer, ForeignKey('customers.id'))
   invno = Column(Integer)
   amount = Column(Integer)
   customer = relationship("Customer", back_populates = "invoices")

Customer.invoices = relationship("Invoice", order_by = Invoice.id, back_populates = "customer")
Base.metadata.create_all(engine)

这将向 SQLite 引擎发送 CREATE TABLE 查询,如下所示 -

CREATE TABLE invoices (
   id INTEGER NOT NULL,
   custid INTEGER,
   invno INTEGER,
   amount INTEGER,
   PRIMARY KEY (id),
   FOREIGN KEY(custid) REFERENCES customers (id)
)

我们可以借助 SQLiteStudio 工具检查 sales.db 中是否创建了新表。

Sales.db 新表

Invoices 类在 custid 属性上应用foreignkey构造。该指令指示该列中的值应限制为客户表中 id 列中存在的值。这是关系数据库的核心特性,是将不相连的表集合转变为具有丰富重叠关系的“粘合剂”。

第二个指令称为“relationship()”,它告诉 ORM 应使用 Invoice.customer 属性将 Invoice 类链接到 Customer 类。关联()使用两个表之间的外键关系来确定此链接的性质,确定它是多对一的。

附加的relationship()指令被放置在Customer映射类的Customer.invoices属性下。参数relationship.back_populates被分配来引用互补的属性名称,以便每个relationship()可以对反向表达的相同关系做出智能决策。一方面,Invoices.customer 引用 Invoices 实例,另一方面,Customer.invoices 引用 Customers 实例的列表。

关系函数是 SQLAlchemy ORM 包的关系 API 的一部分。它提供了两个映射类之间的关系。这对应于父子关系或关联表关系。

以下是发现的基本关系模式 -

一对多

一对多关系是指父表借助子表上的外键。然后在父级上指定关系(),作为引用由子级表示的项目集合。role.back_populates 参数用于建立一对多的双向关系,其中“反向”侧是多对一。

多对一

另一方面,多对一关系在父表中放置一个外键来引用子表。关系()在父级上声明,其中将创建一个新的标量持有属性。这里,relationship.back_populates 参数再次用于双向Behave。

一对一

一对一关系本质上是一种双向关系。uselist 标志指示在关系的“多”端放置标量属性而不是集合。要将一对多转换为一对一类型的关系,请将 uselist 参数设置为 false。

多对多

多对多关系是通过使用外键定义属性来添加与两个类相关的关联表来建立的。它由关系()的第二个参数指示。通常,表使用与声明性基类关联的 MetaData 对象,以便foreignkey指令可以找到要链接的远程表。每个relationship() 的relationship.back_populates 参数建立双向关系。关系的双方都包含一个集合。