데이터베이스 준비하기: airflow db migrate
Apache Airflow Official Documentation (in-repo snapshot) — Apache Software Foundation installation/setting-up-the-database.rst (전체, L1-39)
이 모듈을 다 읽으면
- airflow db migrate 명령이 언제, 왜 필요한지 설명할 수 있다
- airflow db upgrade가 왜 deprecated 되었는지, 무엇으로 대체되었는지 말할 수 있다
- Helm 차트 같은 일부 배포에서 DB 마이그레이션이 자동화되는 경우를 설명할 수 있다
Airflow는 반드시 데이터베이스가 필요하다. 실험/학습 목적이라면 기본 SQLite로 충분하지만, 실제 사용에는 다른 DB 설정이 필요하다. 이 짧은 모듈은 스키마 생성/마이그레이션에 쓰이는 `airflow db migrate` 명령의 역할과 주의사항을 정리한다.
airflow db migrate: 스키마 생성과 마이그레이션
데이터베이스 스키마가 아직 없다면 생성하고, 이미 있다면 최신 버전으로 마이그레이션하기 위해 `airflow db migrate` 명령을 실행해야 한다. 마이그레이션이 실행되는 동안에는 Airflow 컴포넌트가 실행 중이지 않아야 한다.
Airflow 2.7.0 이전에는 이 목적으로 `airflow db upgrade`가 사용되었으나, 이후 `airflow db migrate`로 이름이 바뀌면서 `db upgrade`는 deprecated 되었다.
핵심 포인트
- airflow db migrate는 스키마가 없으면 생성하고 있으면 최신으로 마이그레이션하며, 실행 중에는 Airflow 컴포넌트를 모두 정지해야 한다
- airflow db upgrade는 Airflow 2.7.0부터 airflow db migrate로 대체되어 deprecated 되었다
자동화된 마이그레이션과 후속 조치
Helm 차트 같은 일부 배포 방식에서는 Airflow를 업그레이드할 때 DB 초기화와 마이그레이션 실행이 자동으로 처리된다. 업그레이드 이후에는 때때로 추가적인 post-migration 조치가 필요할 수 있으며, 이는 `/installation/upgrading` 문서에서 더 자세히 다룬다.
핵심 포인트
- Helm 차트 배포에서는 DB 초기화와 마이그레이션이 업그레이드 과정에 자동으로 포함될 수 있다
- 업그레이드 후 추가 post-migration 조치가 필요할 수 있으며 별도 upgrading 문서에서 안내한다