Rails 애플리케이션 개발 및 운영 과정에서 데이터 마이그레이션은 피할 수 없는 중요한 작업입니다. 여기서 데이터 마이그레이션이란, 단일 데이터베이스 내에서 데이터의 형태를 변경하거나 이동시키는 협의의 작업을 의미합니다. 'Hello World' 단계부터 대규모 IPO에 이르기까지, 애플리케이션의 성장에 따라 데이터 구조 및 내용의 변경이 수반되며, 이는 필연적으로 데이터 마이그레이션을 요구합니다. 하지만 현재 Rails 생태계에서는 이러한 데이터 마이그레이션에 대한 통일된 공식적인 접근 방식이 부재하여 각 팀마다 다양한 해결책을 모색하고 있는 실정입니다.
본 강연에서는 2024년 현재 Rails 환경에서 활용 가능한 다양한 데이터 마이그레이션 접근 방식을 소개하고 각 방식의 특성 및 고려사항을 논합니다.
주요 데이터 마이그레이션 접근 방식:
- SQL 직접 실행: 가장 원시적인 방법으로, 터미널이나 GUI 툴을 통해 SQL 문을 직접 실행합니다. 단순하지만, 애플리케이션의 유효성 검사나 콜백 등을 우회하여 데이터 무결성을 해칠 위험이 높고, 실행 기록 관리 및 권한 관리가 어렵다는 단점이 있습니다.
- Rails 콘솔:
rails console을 통해 Active Record 기반의 모델을 사용하여 데이터를 조작하는 방식입니다. 애플리케이션 로직(유효성 검사, 콜백 등)이 적용되어 SQL 직접 실행보다는 안전하지만, 대화형 실행 방식의 특성상 스크립트 복사/붙여넣기 오류, 오타 등으로 인한 운영 실수(Operator Error) 위험이 여전히 존재합니다. - DB 마이그레이션 스크립트 내 포함: 스키마 변경을 위한 DB 마이그레이션 스크립트(Active Record Migration) 내에 데이터 조작 로직을 함께 작성하는 방식입니다. 스키마 변경과 데이터 변경을 동시에 수행할 때 편리하며, 기존 배포 파이프라인에 통합하기 용이합니다. 그러나 스키마 마이그레이션과 데이터 마이그레이션은 라이프사이클이 다르고, 시간이 지남에 따라 모델 상태가 변경되어 스크립트 실행 시점에 문제가 발생할 수 있다는 근본적인 단점이 있습니다.
- Rake 태스크 또는 Ruby 스크립트: 별도의 Rake 태스크나 순수 Ruby 스크립트를 작성하여 실행하는 방식입니다. Rails 콘솔의 스크립트 복붙 위험을 줄이고, 테스트 코드 작성을 통해 안전성을 높일 수 있습니다. 실행 환경(예: Rails Runner)에서 Rails 설정을 로드하여 애플리케이션 로직을 적용할 수 있습니다. 다만, 어떤 스크립트가 언제 어느 환경에서 실행되었는지에 대한 관리를 팀 자체적으로 수행해야 하는 부담이 있습니다.
- 전용 Gem 활용: 데이터 마이그레이션 관리를 위한 다양한 Gem들이 존재합니다.
data-migrate,migration-data,rails-data-migrations,data_fix,rails-data-fix,seed-migration등 여러 시도가 있었으며, 현재는data-migrateGem이 비교적 활발히 유지보수되고 있습니다. 이러한 Gem들은 별도의 관리 폴더, 실행 순서 지정, 실행 기록 관리 등의 기능을 제공하지만, 일부 Gem은 Rails 내부 API에 의존하여 버전 업그레이드 시 문제가 발생할 가능성도 있습니다. - Maintenance Tasks Gem (Shopify): Shopify에서 개발한 Gem으로, 웹 UI를 통해 데이터 마이그레이션 작업을 관리하고 실행할 수 있습니다. 작업 정의, 실행, 중지/재개 기능 등을 제공하는 고기능 솔루션입니다. 도입 비용이 발생할 수 있으나, 복잡하고 장시간 소요되는 데이터 마이그레이션 작업 관리에 매우 유용할 수 있습니다.
국내외 설문 조사 결과에 따르면, 여전히 Rake 태스크/Ruby 스크립트 방식이 가장 널리 사용되고 있으며, DB 직접 실행이나 Rails 콘솔 사용은 감소하는 추세입니다. Rails 코어 팀의 접근 방식 또한 require_relative를 사용한 Ruby 스크립트 실행을 선호하며, Rails Guides 7.2 이후 버전에서는 스키마와 데이터 마이그레이션의 분리를 권장하고 Maintenance Tasks Gem을 언급하는 등 변화가 있었습니다.
접근 방식 선택 기준:
데이터 마이그레이션 방식을 선택할 때는 여러 요소를 종합적으로 고려해야 합니다. 주요 고려사항으로는 운영 정비 비용, 긴급 대응 능력, 운영 실수 및 데이터 불일치 발생 위험, 팀의 숙련도 및 문화, 배포 파이프라인과의 통합 수준 등이 있습니다. 예를 들어, 데이터 무결성과 실행 기록 관리를 최우선으로 한다면 관리 비용이 증가할 수 있으며, 긴급한 데이터 복구가 필요한 상황에서는 빠른 실행이 가능한 방식이 필요할 수 있습니다. 또한, 배포와 데이터 마이그레이션을 얼마나 밀접하게 관리할 것인지, 반드시 지켜야 할 ‘노크아웃 팩터’(예: 감사 기록 필수, 테스트 필수)는 무엇인지 등을 명확히 해야 합니다. 데이터 마이그레이션 스크립트와 초기/기준 데이터를 관리하는 시드(Seed) 스크립트를 분리하여 관리하는 것도 혼란을 줄이는 좋은 방법입니다.
결론적으로, Rails에서의 데이터 마이그레이션에 대한 단 하나의 정답은 존재하지 않습니다. 다양한 접근 방식은 각기 다른 장점과 위험을 내포하고 있으며, 최적의 방식은 팀과 프로젝트의 특정 요구사항과 제약 조건에 따라 달라집니다. 본 강연에서 제시된 다양한 방법론과 선택 기준들을 바탕으로, 각 팀은 데이터 무결성 확보, 운영 효율성 증대, 그리고 위험 최소화라는 목표를 달성하기 위해 팀원들과 충분히 논의하고 가장 적합한 전략을 수립하고 실천해야 합니다. 이러한 과정을 통해 Rails 프로젝트의 데이터 마이그레이션 작업을 보다 안전하고 효율적으로 관리할 수 있을 것입니다.