読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
models.py に、予約と明細の表に対応するクラスを加えます。
class Reservation(Base):
__tablename__ = "reservations"
id: Mapped[str] = mapped_column(primary_key=True)
user_id: Mapped[int] = mapped_column(ForeignKey("users.id"))
name: Mapped[str]
pickup_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
status: Mapped[str]
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
picked_up_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))
cancelled_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))
items: Mapped[list["ReservationItem"]] = relationship(back_populates="reservation")
class ReservationItem(Base):
__tablename__ = "reservation_items"
reservation_id: Mapped[str] = mapped_column(ForeignKey("reservations.id"), primary_key=True)
product_id: Mapped[str] = mapped_column(ForeignKey("products.id"), primary_key=True)
quantity: Mapped[int]
unit_price: Mapped[int]
reservation: Mapped[Reservation] = relationship(back_populates="items")
| 書き方 | 意味 |
|---|---|
ForeignKey("users.id") | 外部キー。users の表の id を指す |
DateTime(timezone=True) | 時差付きの日時の列 |
Mapped[datetime | None] | NULL を許す列 |
relationship(...) | 関係のある表の行を、オブジェクトの項目としてたどる |
relationship を書くと、reservation.items で、その予約の明細のオブジェクトのリストを取り出せます。逆に、item.reservation で、明細が属する予約を取り出せます。利用者の表に対応する User のクラスも、同じように models.py に書きます。
APIとデータベースでは、項目名の書き方が違います。
| API(JSON) | Python | データベースの列 |
|---|---|---|
pickupAt | pickup_at | pickup_at |
productId | product_id | product_id |
unitPrice | unit_price | unit_price |
APIの名前との対応は、schemas.py のモデルの alias で書きます。表のクラスの項目名は、列の名前と同じにします。
Reservation だけです。利用者は送られた本文ではなく、サーバーが決めます。ReservationDetail だけです。保存せず、明細から計算して応答に加えます。3 / 20