본문 바로가기

프로그래밍/데이터베이스

Alembic 연동

Alembic은 Python에서 사용되는 데이터베이스 마이그레이션 도구입니다. 기존 데이터베이스와 Alembic을 연동하는 방법을 알아보겠습니다.

 

1. Alembic 설치

먼저 Python 패키지 관리자인 pip를 사용하여 Alembic을 설치해야 합니다. 명령 프롬프트(Windows) 또는 터미널(Mac/Linux)에서 다음 명령을 실행합니다.

pip install alembic

 

 

2. Alembic 초기화

Alembic을 사용하려는 프로젝트 루트 디렉토리에서 다음 명령을 실행하여 Alembic을 초기화합니다

alembic init alembic

 

3. 설정 파일 편집

초기화 명령을 실행하면 `alembic.ini` 파일과 `alembic` 디렉토리가 생성됩니다. `alembic.ini` 파일을 열어 데이터베이스 연결 정보를 편집합니다. `[alembic]` 섹션에서 `sqlalchemy.url` 속성을 기존 데이터베이스의 연결 문자열로 설정해야 합니다.

 

4. 모델 작성

Alembic은 SQLAlchemy를 기반으로 하므로, 데이터베이스 모델은 SQLAlchemy 모델로 작성해야 합니다. 기존 데이터베이스와 일치하도록 SQLAlchemy 모델을 작성하세요.

 

5. 마이그레이션 스크립트 생성

Alembic은 데이터베이스 스키마 변경을 추적하기 위해 마이그레이션 스크립트를 사용합니다. 마이그레이션 스크립트를 생성하려면 다음 명령을 실행합니다

alembic revision --autogenerate -m "마이그레이션 메시지"

6. 마이그레이션 적용

생성된 마이그레이션 스크립트를 데이터베이스에 적용하기 위해 다음 명령을 실행합니다

alembic upgrade head