upgrade로 적용하고 롤백하기

마이그레이션 파일은 있지만 데이터베이스는 아직 변경되지 않았습니다. 명령 하나로 이 스크립트를 실제 테이블로 바꿀 수 있습니다. 🚀

flask db upgrade는 보류 중인 모든 마이그레이션을 실행하고 데이터베이스를 순서대로 최신 버전까지 올립니다.

내부적으로 Alembic은 보류 중인 각 스크립트 안의 upgrade 함수를 실행하여 create 및 alter 작업을 적용합니다.

실행이 성공하면 새 리비전 ID가 alembic_version 테이블에 저장됩니다. 그러면 Alembic이 현재 위치를 기억할 수 있습니다.

upgrade는 영리하게 작동합니다. 이미 적용된 마이그레이션은 건너뛰고 보류 중인 항목만 실행하므로 다시 실행해도 안전합니다.

마이그레이션에 문제가 생겼다면 데이터베이스를 직접 수정하지 않습니다. 대신 정상 상태로 확인된 버전으로 롤백합니다.

flask db downgrade는 해당 마이그레이션의 downgrade 함수를 실행하여 가장 최근 변경을 취소합니다.

두 명령 모두 대상을 지정할 수 있습니다. revision ID를 전달하면 마이그레이션 이력의 정확한 지점으로 바로 이동합니다.

언제든 flask db current를 실행하면 현재 데이터베이스가 기준으로 삼고 있는 리비전이 출력됩니다. 빠르게 정상 여부를 확인할 때 유용합니다.

flask db history는 모든 마이그레이션을 순서대로 나열하므로 첫 리비전부터 최신 리비전까지 전체 경로를 볼 수 있습니다.

배포할 때는 릴리스 단계로 upgrade를 실행하고 migrate는 실행하지 않습니다. 프로덕션은 팀이 이미 검토한 스크립트를 그대로 재실행할 뿐입니다.

flask db upgrade로 변경 사항을 적용하고 downgrade로 되돌렸으며, current와 history로 상태와 이력을 확인하는 방법을 배웠습니다. 🎉