SQLAlchemy

서론FastAPI와 SQLAlchemy를 사용한 백엔드 개발을 하다 보면, 가장 기본적인 데이터 저장 흐름으로 db.add() → db.commit()을 익히게 됩니다. 하지만 어느 순간, db.flush()라는 생소한 메서드를 만나게 되는 경우가 있죠.이 함수는 왜 필요한 걸까요? 그냥 commit()만 하면 되는 거 아닌가요?이번 포스팅에서는 flush()와 commit()의 차이, flush()가 어떤 상황에서 필요한지, 그리고 실제 예제 코드에서는 어떻게 사용하는지를 초보자도 이해할 수 있게 정리해보겠습니다.본론flush()란 무엇인가요?db.flush()이 코드는 SQLAlchemy에서 세션에 등록된 작업들을 실제 DB에 반영하지만, 트랜잭션은 종료하지 않고 그대로 유지하는 역할을 합니다.좀 더..

서론FastAPI와 SQLAlchemy를 함께 사용할 때, 코드를 다음처럼 계층 분리하는 경우가 많습니다.router: 요청/응답 처리service: 비즈니스 로직 처리crud: DB 직접 접근이 구조는 유지보수성과 테스트 편의성을 높여주지만, 실제 DB와의 상호작용이 나뉘어 있기 때문에 데이터 저장 흐름을 정확히 이해하는 것이 중요합니다.그 중 하나가 바로 db.flush()입니다.db.flush()는 데이터를 실제 DB에 저장하되 트랜잭션은 유지하는 명령어입니다.db.commit()과는 달리, 다른 연산(예: insert → select)을 하기 위한 "중간 저장" 용도로 사용됩니다.본론상황예를 들어 브랜드를 생성하고, 생성된 브랜드의 ID로 브랜드-카테고리 연관 데이터를 추가하고 싶다고 해보죠.1...

💡 FastAPI에서 PostgreSQL까지 흐름 이해하기FastAPI로 백엔드 API를 만들다 보면 다음과 같은 단어들을 자주 마주하게 됩니다.각자 따로 설명을 찾아보면 이해가 가면서도 개발하다보면 이게 뭐엿지 하게되는 상황이 꼭 있기 마련이다!!그래서 공부한김에 이해하기쉽게 정리해서 포스팅해봤다.처음엔 각각이 따로 노는 것처럼 보이지만, 알고 보면 이들은 하나의 흐름으로 연결됩니다.PydanticSQLAlchemypsycopg2PostgreSQL스키마(schema)🧭 전체 흐름 요약FastAPI (Pydantic 스키마) ↓SQLAlchemy (ORM) ↓psycopg2 (드라이버) ↓PostgreSQL (데이터베이스)🧱 각 구성요소 역할구성요소 설명FastAPI요청/응답 처리,..

📌 문제 상황FastAPI에서 카테고리를 다음과 같은 구조로 저장한다고 가정하자.main_category: 대분류 (필수)sub_category: 중분류 (선택)sub_sub_category: 소분류 (선택)DB 설계 시 sub_category, sub_sub_category는 nullable=True 로 되어 있고,입력값이 없으면 None 혹은 ""(빈 문자열)로 들어올 수 있다.하지만!중복 체크를 할 때 "None"과 ""를 구분하지 않으면실제로는 같은 카테고리인데 중복으로 인식되지 않는 문제가 발생할 수 있다.⚠️ 실제 발생 가능한 예시POST /categories{ "main_category": "생활/건강", "sub_category": "생활용품", "sub_sub_category": ..

서론기능 확장기본적인 다중 필터 API에서 아래 기능을 추가하고 싶다:페이지네이션 (page, size)정렬 (sort_by, order)복수 브랜드 선택 (brands=apple&brands=samsung)전체 API 예시GET /products?brands=apple&brands=samsung&category=전자기기&sort_by=price&order=desc&page=1&size=10본론라우터 정의from fastapi import APIRouter, Queryfrom typing import List, Optionalfrom enum import Enumrouter = APIRouter()class SortOrder(str, Enum): asc = "asc" desc = "desc"@..

FastAPI에서 다중 필터 검색 API 설계하기🔍 문제 상황제품 목록을 필터링하는 API를 만들고 싶다.사용자는 아래와 같이 여러 조건을 조합해서 검색할 수 있어야 한다:GET /products?brand=apple&category=전자기기&price_min=100000&price_max=300000이처럼 복수의 쿼리 파라미터를 받아서 조건에 따라 동적으로 필터링할 수 있는 API를 어떻게 설계할 수 있을까?🔗 엮인글[🚀 Dev/Python] - [FastAPI] Swagger UI에서 POST 요청 시 JSON 입력창으로 바뀌는 이유 [🚀 Dev/Python] - [FastAPI] DELETE 요청 시 JSON이 아닌 Path Param으로 값 전달하는 방법[🚀 Dev/Python] - [F..

발생FastAPI 프로젝트에서 유저 정보를 업데이트할 때,요청한 user_id와 조회된 user.id가 서로 다른 값으로 나왔다.id: 0a0884cb-052a-4a07-98ea-ce21539e322c, 👉🏻id: 0d13fcf3-4c31-4559-937c-cd3f5cb8e379, 엥? 왜...?디버깅 과정 요약✅ 직전에 id 타입을 varchar 에서 uuid 로 바꿨지...그게 문제인줄 알았지...router, crud, service 파라메터 변수 다 확인하고 바꾸고 ✅ UUID 타입은 uuid.UUID로 선언해두었고 모델에서도 잘 적용됨.✅ 엑셀로 업로드한 데이터도 이중으로 발생되던거 삭제하고 모델 생성으로 바꿔서uuid.UUID 타입으로 저장되는거 확인함.데이터 삭제하고 엑셀 3번쯤 올려서 ..

🚨 문제 상황FastAPI + SQLAlchemy + PostgreSQL 프로젝트에서 아래와 같은 에러 발생:sqlalchemy.exc.DataError: (psycopg2.errors.InvalidTextRepresentation)invalid input value for enum excludewordtype: "GENERAL"▶️ 실제 SQL 로그WHERE exclude_words.type = 'GENERAL'하지만 PostgreSQL ENUM 타입은 아래처럼 소문자로 정의되어 있었음:SELECT unnest(enum_range(NULL::excludewordtype));-- 결과:-- brand-- general❓ 왜 이런 문제가 발생했을까?✔️ 원인 1. Python Enum의 .name vs ..