플러터에서 애플리케이션의 데이터베이스 마이그레이션 방법은 무엇인가요?

Q1: 플러터에서 데이터베이스 마이그레이션이란 무엇인가요?
A1: 데이터베이스 마이그레이션은 앱이 업데이트되면서 데이터베이스 구조(테이블, 컬럼 등)를 변경하고 기존 데이터를 손실 없이 새로운 구조로 옮기는 작업을 말합니다. 플러터에서는 SQLite 같은 로컬 DB를 사용할 때 앱 버전 변경에 따라 스키마 변경을 처리하는 과정입니다.

Q2: 플러터에서 데이터베이스 마이그레이션을 어떻게 구현하나요?
A2: 주로 `sqflite` 패키지를 사용합니다. 데이터베이스를 생성할 때 `openDatabase` 함수에 `onUpgrade` 콜백을 지정하여 이전 버전부터 현재 버전까지 스키마 변경 작업(SQL 문 실행)을 순차적으로 적용합니다.

```dart
openDatabase(
path,
version: 2, // 현재 DB 버전 설정
onCreate: (db, version) {
db.execute('CREATE TABLE my_table(id INTEGER PRIMARY KEY, name TEXT)');
},
onUpgrade: (db, oldVersion, newVersion) async {
if (oldVersion < 2) {
await db.execute('ALTER TABLE my_table ADD COLUMN age INTEGER');
}
// 추가 버전 업그레이드 작업 작성
},
);
```

Q3: `onUpgrade` 함수에서는 무엇을 해야 하나요? A3: 이전 데이터베이스 버전부터 현재 버전까지 변경된 모든 스키마 수정 SQL문을 실행해야 합니다. 예를 들어, 컬럼 추가, 테이블 생성, 데이터 변환 등을 단계별로 처리합니다. 마이그레이션 단계가 여러 개일 경우, `oldVersion`과 `newVersion`을 비교해 조건별로 처리합니다.

Q4: 데이터베이스 버전 관리는 어떻게 하나요?
A4: `openDatabase` 함수 호출 시 `version` 인자를 사용해 현재 DB 구조 버전을 명시합니다. 앱이 처음 설치되면 `onCreate`가 호출되고, 앱 업데이트시 버전 번호가 올라가면 `onUpgrade`가 실행됩니다. 이 숫자에 따라 마이그레이션 로직을 분기 처리합니다.

Q5: 마이그레이션 도중 데이터 손실 위험은 없나요?
A5: 적절한 SQL 명령과 신중한 순서로 실행하면 데이터 손실을 방지할 수 있습니다. 예를 들어, 컬럼 추가는 기존 데이터를 유지합니다. 다만 테이블 삭제 후 재생성 시 데이터가 사라지므로 백업하거나 신중한 계획이 필요합니다.

Q6: 복잡한 마이그레이션 로직을 어떻게 관리하나요?
A6: 마이그레이션별로 별도의 함수나 클래스를 만들어 관리하고, `onUpgrade` 내에서 버전별로 해당 함수들을 호출하는 방식을 추천합니다. 여러 마이그레이션 스크립트를 파일로 분리해 유지보수하기 좋습니다.

Q7: 다른 패키지에서 제공하는 마이그레이션 지원은 있나요?
A7: `moor`(현재 drift), `floor` 같은 플러터 SQLite ORM 패키지는 내장된 마이그레이션 기능을 제공합니다. 이들 패키지에서는 어노테이션이나 마이그레이션 스크립트를 통해 더 편리하게 마이그레이션을 구현할 수 있습니다.

---

요약 :
- 플러터에서 SQLite 마이그레이션은 `openDatabase`의 `onUpgrade`에서 처리한다.
- DB 버전을 올리고, 각 버전별 변경사항에 맞춰 스키마 변경 SQL을 실행한다.
- 안전한 마이그레이션을 위해 단계별 함수 분리 및 데이터 백업 권장.
- ORM 패키지 사용 시 더 쉽게 마이그레이션 가능.

이를 숙지하면 안정적으로 앱 업데이트 시 데이터베이스를 변경하고 기존 사용자 데이터를 안전하게 유지할 수 있습니다.

Flutter에서 애플리케이션의 데이터베이스 마이그레이션은 데이터베이스 스키마의 변경이나 데이터 구조의 변화를 관리하는 중요한 과정입니다.

데이터베이스 마이그레이션을 통해 애플리케이션의 데이터 무결성을 유지하고, 새로운 기능을 추가하거나 기존 기능을 개선할 수 있습니다.

Flutter에서는 주로 SQLite 데이터베이스를 사용하며, 이를 위해 `sqflite` 패키지를 많이 활용합니다.

아래에서는 Flutter에서 데이터베이스 마이그레이션을 수행하는 방법에 대해 자세히 설명하겠습니다.

1. 데이터베이스 초기화 먼저, 데이터베이스를 초기화하는 방법을 살펴보겠습니다.

`sqflite` 패키지를 사용하여 데이터베이스를 생성하고, 초기 스키마를 설정합니다.

```dart import 'package:sqflite/sqflite.dart'; import 'package:path/path.dart'; Future initializeDatabase() async { String path = join(await getDatabasesPath(), 'my_database.db'); return await openDatabase( path, version: 1, // 초기 버전 onCreate: (Database db, int version) async { await db.execute(''' CREATE TABLE users ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER ) '''); }, ); } ```

2. 데이터베이스 버전 관리 데이터베이스 마이그레이션을 위해서는 데이터베이스의 버전을 관리해야 합니다.

`openDatabase` 메서드에서 `version` 매개변수를 사용하여 데이터베이스의 버전을 설정하고, `onUpgrade` 콜백을 통해 마이그레이션 로직을 구현합니다.

```dart Future initializeDatabase() async { String path = join(await getDatabasesPath(), 'my_database.db'); return await openDatabase( path, version: 2, // 새로운 버전 onCreate: (Database db, int version) async { await db.execute(''' CREATE TABLE users ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER ) '''); }, onUpgrade: (Database db, int oldVersion, int newVersion) async { if (oldVersion <

2) { // 버전 2로의 마이그레이션 await db.execute('ALTER TABLE users ADD COLUMN email TEXT'); } // 추가적인 버전 업그레이드 로직을 여기에 추가 }, ); } ```

3. 마이그레이션 로직 작성 `onUpgrade` 콜백 내에서 데이터베이스의 이전 버전과 새로운 버전을 비교하여 필요한 마이그레이션 작업을 수행합니다.

예를 들어, 새로운 컬럼을 추가하거나 테이블을 변경하는 등의 작업을 수행할 수 있습니다.

```dart onUpgrade: (Database db, int oldVersion, int newVersion) async { if (oldVersion <

2) { await db.execute('ALTER TABLE users ADD COLUMN email TEXT'); } if (oldVersion <

3) { await db.execute(''' CREATE TABLE orders ( id INTEGER PRIMARY KEY AUTOINCREMENT, userId INTEGER, amount REAL, FOREIGN KEY (userId) REFERENCES users (id) ) '''); } } ```

4. 데이터베이스 마이그레이션 테스트 마이그레이션이 제대로 작동하는지 확인하기 위해, 데이터베이스를 초기화하고, 데이터를 삽입한 후, 버전을 올려 마이그레이션을 테스트합니다.

이 과정에서 데이터가 손실되지 않고, 새로운 스키마가 적용되는지 확인해야 합니다.



5. 마이그레이션 관리 도구 사용 복잡한 데이터베이스 마이그레이션을 관리하기 위해, `moor`와 같은 ORM(Object-Relational Mapping) 라이브러리를 사용할 수도 있습니다.

`moor`는 데이터베이스 마이그레이션을 보다 쉽게 관리할 수 있는 기능을 제공하며, SQL 쿼리를 Dart 코드로 작성할 수 있게 해줍니다.

결론 Flutter에서 데이터베이스 마이그레이션은 애플리케이션의 데이터 구조를 변경할 때 필수적인 과정입니다.

`sqflite` 패키지를 사용하여 데이터베이스를 초기화하고, 버전을 관리하며, `onUpgrade` 콜백을 통해 마이그레이션 로직을 구현함으로써 데이터 무결성을 유지할 수 있습니다.

데이터베이스 마이그레이션을 잘 관리하면 애플리케이션의 확장성과 유지보수성을 높일 수 있습니다.