Kotlinでデータベースのバックアップとリストアを行う方法を解説！初心者でも安心のステップバイステップ

Kotlinでデータベースのバックアップとリストアを行う方法

先生と生徒の会話形式で理解しよう

生徒

「先生、Kotlinで作ったアプリのデータを消えないようにしたいんですが、何か方法はありますか？」

先生

「それなら、データベースのバックアップとリストアを行う仕組みを作るのが良いですね。」

生徒

「バックアップとリストアって、どういうことですか？」

先生

「大切なデータを守るための方法ですよ。これからKotlinでのやり方を、初心者でも分かるように説明していきましょう。」

1. バックアップとリストアとは？

バックアップとは、今あるデータを別の場所にコピーして保存しておくことです。リストアとは、その保存しておいたデータをもとに戻すことです。

たとえば、スマートフォンの連絡先をバックアップしておけば、機種変更したときにリストアすることで、連絡先をすぐに戻すことができます。

2. Kotlinで使われるRoomのデータベース

KotlinでAndroidアプリを作るとき、Roomというライブラリを使ってデータベースを管理するのが一般的です。Roomは、内部的にSQLiteというデータベースを使っています。

SQLiteは、ファイルとして保存されているので、このファイルをコピーしたり復元したりすることで、バックアップやリストアが可能になります。

3. SQLiteファイルの場所を知ろう

Androidアプリで使われるデータベースのファイルは、アプリごとの内部ストレージに保存されています。KotlinでRoomを使った場合、通常は次のような場所に保存されています。


val dbFile = context.getDatabasePath("your_database_name.db")

ここで「your_database_name.db」の部分は、自分が設定したデータベースの名前に置き換えてください。

4. データベースをバックアップする方法

Roomのデータベースファイルをコピーすれば、それがバックアップになります。下記のように、外部ストレージや指定フォルダへコピーします。


fun backupDatabase(context: Context) {
    val dbFile = context.getDatabasePath("your_database_name.db")
    val backupFile = File(context.getExternalFilesDir(null), "backup.db")
    dbFile.copyTo(backupFile, overwrite = true)
}

この処理を行うことで、データベースのバックアップファイル「backup.db」が作成されます。

5. データベースをリストアする方法

リストアは、バックアップされたファイルを元の場所にコピーし直すだけです。ただし、アプリのデータベースが開いている状態では上書きできないため注意が必要です。


fun restoreDatabase(context: Context) {
    val dbFile = context.getDatabasePath("your_database_name.db")
    val backupFile = File(context.getExternalFilesDir(null), "backup.db")
    backupFile.copyTo(dbFile, overwrite = true)
}

このコードで、以前保存していたデータベースの内容が復元されます。

6. バックアップ時の注意点

データベースのバックアップを安全に行うためには、次のようなポイントを守ることが大切です。

データベースを操作していないタイミングで行う
ストレージのパーミッション（許可）を事前に取得する
ファイル名に日付や時刻をつけて複数保存できるようにする

7. パーミッション（権限）設定について

Androidでは、外部ストレージにアクセスするにはユーザーの許可が必要です。Kotlinで次のように書いて許可をリクエストします。


ActivityCompat.requestPermissions(this,
    arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE),
    1)

また、AndroidManifest.xmlに以下の記述を忘れないようにしましょう。


<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

8. 自動バックアップの考え方

バックアップは手動でもできますが、自動で行えるようにすることで安心感が増します。たとえば、アプリを閉じるときに自動でバックアップ処理を実行することも可能です。

ただし、自動化する場合は、保存先の容量や処理時間にも気を配る必要があります。

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

9. 初心者でも安心して使える工夫

バックアップやリストアと聞くと難しそうですが、実は「コピー」と「貼り付け」を行うだけのイメージです。

Kotlinでは、ファイル操作もシンプルに書けるので、正しいタイミングでコピーするだけで、安全にデータを守ることができます。

初心者の方は、まずは手動でボタンを押してバックアップするような実装から始めると良いでしょう。

【未経験OK】Kotlinで始めるプログラミング入門｜ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと？」という基本から、世界中で使われている最新言語Kotlin（コトリン）を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。