<aside>

</aside>

안녕하세요! 데이터베이스 마이그레이션 5부의 네 번째 시간, 25강입니다! 🔧

지난 24강에서는 데이터베이스 스키마 변경 관리의 필요성을 느끼고, SQLAlchemy를 위한 마이그레이션 도구인 Alembic을 우리 프로젝트에 소개하며 초기 환경 설정(alembic init)까지 마쳤습니다. 이제 프로젝트 폴더에는 alembic.ini 파일과 alembic/ 디렉토리가 생겼죠!

하지만 아직 Alembic이 우리 데이터베이스에 연결하고, 우리가 정의한 SQLAlchemy 모델(Task)을 인식하도록 설정을 완료하지는 않았습니다. 이번 시간에는 Alembic 설정 파일들(alembic.ini, env.py)을 직접 수정하여 우리 프로젝트 환경에 맞게 구성하는 방법을 배웁니다.

그리고 드디어! 설정된 Alembic 환경을 사용하여, 우리가 21강에서 정의했던 Task 모델을 기반으로 첫 번째 마이그레이션 스크립트를 자동으로 생성하고, 이 스크립트를 실제 데이터베이스에 적용하여 tasks 테이블을 만드는 마법 같은 과정을 직접 경험해 볼 거예요! ✨

자, 이제 Alembic 설정을 완료하고 데이터베이스에 첫 테이블을 만들어 봅시다!

📚 챕터 소개

이번 25강에서는 24강에서 초기화한 Alembic 마이그레이션 환경을 실제로 작동하도록 설정하는 과정을 다룹니다. 먼저, alembic.ini 설정 파일에 데이터베이스 연결 URL을 올바르게 지정합니다. 그 다음, 핵심 설정 파일인 alembic/env.py를 수정하여 Alembic이 우리의 **SQLAlchemy 모델 메타데이터(Base.metadata)**를 인식하고, FastAPI의 비동기(async) 데이터베이스 환경에서 올바르게 동작하도록 구성합니다.

설정이 완료되면, alembic revision --autogenerate 명령어를 사용하여 현재 정의된 SQLAlchemy 모델(Task) 상태를 기반으로 첫 번째 마이그레이션 스크립트 (즉, tasks 테이블을 생성하는 스크립트)를 자동으로 생성하는 방법을 실습합니다. 생성된 스크립트의 내용을 간단히 살펴보고, 마지막으로 alembic upgrade head 명령어를 실행하여 이 마이그레이션 스크립트를 실제 데이터베이스에 적용함으로써 tasks 테이블이 생성되는 것을 확인합니다.

🎯 챕터 목표

이 강의를 마치면 여러분은 다음을 할 수 있게 됩니다:

1. alembic.ini 파일에 **데이터베이스 연결 URL(sqlalchemy.url)**을 올바르게 설정할 수 있습니다.
2. alembic/env.py 파일을 수정하여 SQLAlchemy **모델 메타데이터(Base.metadata)**를 Alembic에 인식시키고, 비동기(async) 환경 설정을 적용할 수 있습니다.
3. alembic revision --autogenerate 명령을 사용하여 모델 기반의 마이그레이션 스크립트를 자동으로 생성할 수 있습니다.
4. 생성된 마이그레이션 스크립트의 기본적인 구조(upgrade, downgrade 함수)를 이해합니다.
5. alembic upgrade head 명령을 사용하여 마이그레이션을 데이터베이스에 적용하고 테이블을 생성할 수 있습니다.

🏗️ 이번 강의의 프로젝트 구조 및 주요 변경 파일