[FastAPI] SQLAlchemy 요소

💡 create_engine

SQLAlchemy에서 데이터베이스와의 연결을 설정하고 엔진 생성

데이터베이스의 종류와 위치, 사용자 인증 정보 등을 포함하여 연결에 필요한 정보를 제공

 

💡 sessionmaker

세션은 데이터베이스와의 상호작용을 추적하고 제어하는 데 사용됨

sessionmaker는 세션 객체를 생성하는 팩토리를 생성하는 역할을 함

sessionmaker를 사용하여 데이터베이스 세션을 생성하면 해당 세션을 통해 데이터베이스와의 작업을 수행할 수 있음

 

* 팩토리 메서드 *

객체 생성을 캡술화하는 디자인 패턴 중 하나

SQLAlchemy에서 sessionmaker()는 세션 객체를 생성하는 펙토리 메서드 역할

 

💡 session

실제 데이터베이스와의 상호작용을 담당하는 객체

sessionmaker를 사용하여 생성된 세션 팩토리를 통해 세션을 생성하고, 

세션을 통해 데이터의 조회, 추가, 수정, 삭제 등의 작업을 수행할 수 있음

 

 

1. 팩토리 생성

from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker

# 데이터베이스 연결 정보
DATABASE_URL = "sqlite:///./test.db"

# 엔진 생성
engine = create_engine(DATABASE_URL)

# 팩토리 생성
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)

2. 세션 객체 생성 및 사용

from sqlalchemy.orm import Session
from fastapi import FastAPI, Depends

app = FastAPI()

# 팩토리 메서드(SessionLocal)를 호출하여 세션 객체 생성
def get_db():
    db = SessionLocal()
    try:
    	# 세션 객체를 리소스로서 제공
        yield db
    finally:
        db.close()

@app.post("/items/")
async def create_item(item: Item, db: Session = Depends(get_db)):
    # db 사용하여 작업 수행
    db.add(item)
    db.commit()
    db.refresh(item)
    return item

get_db()

Depends(get_db)를 사용하여 의존성을 주입하면, FastAPI가 세션을 관리하며 요청 핸들러에서 사용할 수 있도록 해줌

 

세션 객체를 리소스로서 제공한다는 것은

세션 객체를 필요로 하는 함수나 메서드에서 세션을 쉽게 사용할 수 있도록 관리하는 것을 의미

 

세션 객체는 데이터베이스와의 연결을 나타내는 중요한 자원

그렇기 때문에 세션을 생성하고 닫는 과정을 중복해서 처리하지 않고,

필요한 곳에서 쉽게 사용할 수 있도록 만드는 것이 좋음

 

리소스로서 제공된 세션 객체는 필요한 작업을 수행한 뒤에는 자동으로 정리되어 닫히게 됨

이를 통해 개발자는 세션 관리에 대한 복잡한 작업을 최소화하고,

안전하고 효율적인 데이터베이스 작업을 수행할 수 있음