読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第1節 入力モデルと保存モデル

1.2 表のクラスと名前の対応

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データベースの列
pickupAtpickup_atpickup_at
productIdproduct_idproduct_id
unitPriceunit_priceunit_price

APIの名前との対応は、schemas.py のモデルの alias で書きます。表のクラスの項目名は、列の名前と同じにします。

解答
  1. Reservation だけです。利用者は送られた本文ではなく、サーバーが決めます。
  2. ReservationDetail だけです。保存せず、明細から計算して応答に加えます。
  3. 3つすべてです。

3 / 20