[android] 안드로이드 Room Database의 데이터베이스 오류 처리 방법

15 Dec 2023

android

안드로이드 앱을 개발하다 보면 데이터베이스 조작 시 발생하는 오류를 다뤄야 할 때가 있습니다. 안드로이드에서는 Room Database를 사용하여 SQLite 데이터베이스를 다룹니다. 이번 글에서는 안드로이드 Room Database에서 발생하는 일반적인 데이터베이스 오류를 처리하는 방법을 알아보겠습니다.

1. 데이터베이스 오류가 발생하는 경우

Room Database를 사용하는 안드로이드 앱의 경우, 다음과 같은 상황에서 데이터베이스 오류가 발생할 수 있습니다.

데이터베이스 연결에 실패하는 경우
데이터베이스 쿼리 실행 중 오류가 발생하는 경우
데이터베이스 스키마가 변경될 때 기존 데이터와 충돌이 발생하는 경우

2. 데이터베이스 오류 처리 방법

2.1. 데이터베이스 연결 오류 처리

데이터베이스 연결 오류를 처리할 때에는 Room Database의 RoomDatabase.Callback을 사용하여 onCreate()나 onOpen() 메서드에서 오류를 처리할 수 있습니다.

@Database(entities = {User.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {

    public abstract UserDao userDao();

    private static AppDatabase INSTANCE;

    public static AppDatabase getInstance(final Context context) {
        if (INSTANCE == null) {
            synchronized (AppDatabase.class) {
                if (INSTANCE == null) {
                    INSTANCE = Room.databaseBuilder(context.getApplicationContext(),
                            AppDatabase.class, "app_database").addCallback(new Callback() {
                        @Override
                        public void onOpen(@NonNull SupportSQLiteDatabase db) {
                            // 데이터베이스 연결 성공 처리
                        }

                        @Override
                        public void onCreate(@NonNull SupportSQLiteDatabase db) {
                            // 데이터베이스 생성 성공 처리
                        }
                    })
                    .build();
                }
            }
        }
        return INSTANCE;
    }
}

2.2. 데이터베이스 쿼리 오류 처리

데이터베이스 쿼리 실행 중 오류가 발생하는 경우에는 Room의 비동기 쿼리를 처리하는 방법을 사용하여 오류를 처리할 수 있습니다.

AppDatabase.getInstance(this).userDao().getUser(userId)
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe(user -> {
        // 쿼리 성공 처리
    }, throwable -> {
        // 쿼리 실패 처리
    });

2.3. 데이터베이스 스키마 충돌 처리

데이터베이스 스키마가 변경된 경우에는 Room Database의 fallbackToDestructiveMigration() 메서드를 사용하여 충돌을 해결할 수 있습니다.

AppDatabase appDatabase = Room.databaseBuilder(context.getApplicationContext(),
        AppDatabase.class, "app_database")
        .fallbackToDestructiveMigration()
        .build();

3. 요약

안드로이드 Room Database를 사용하는 앱에서 데이터베이스 오류를 처리하는 방법에 대해 알아보았습니다. 데이터베이스 연결 오류, 쿼리 오류, 스키마 충돌 등 다양한 상황에서 적절한 처리를 통해 안정적인 데이터베이스 조작을 할 수 있습니다.

참고 문헌:

Android Developers - Room Persistence Library