SQLiteをモバイルアプリのローカルDBとして使う実装例

SQLiteをモバイルアプリのローカルDBとして使う実装例

はじめに

モバイルアプリケーション開発において、ローカルデータベースの選択は重要な決定です。ユーザーのデバイス上で効率よくデータを管理したい、オフライン機能を実装したい、そんな場面でSQLiteはとても便利な選択肢となります。本記事では、SQLiteをモバイルアプリのローカルDBとして活用する実装例を、実務的な視点からご紹介します。

SQLiteがモバイルアプリに向いている理由

SQLiteは、軽量で高速、そしてセットアップが簡単なリレーショナルデータベースです。モバイルアプリでの利用に特に適している理由を整理してみましょう。

まず第一に、ファイルベースの構造です。サーバーの立ち上げが不要で、単一のファイルとしてデバイスに保存されるため、複雑な設定が必要ありません。次に、メモリ効率の良さも大きなメリットです。リソースが限られたモバイルデバイスにおいて、軽量なデータベースエンジンは非常に価値があります。さらに、ACID特性に対応しており、トランザクション処理も安全に行えます。

加えて、iOS・Android両プラットフォームでネイティブサポートされており、既存のライブラリやフレームワークが豊富な点も見逃せません。

Androidでの実装例

Androidアプリでは、SQLiteHelper クラスを使用して実装するのが標準的です。以下は基本的な例です。

import android.content.Context
import android.database.sqlite.SQLiteDatabase
import android.database.sqlite.SQLiteOpenHelper

class UserDatabaseHelper(context: Context) : SQLiteOpenHelper(context, "users.db", null, 1) {
    
    override fun onCreate(db: SQLiteDatabase) {
        val createTableSQL = """
            CREATE TABLE users (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                name TEXT NOT NULL,
                email TEXT UNIQUE NOT NULL,
                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
            )
        """.trimIndent()
        db.execSQL(createTableSQL)
    }

    override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) {
        db.execSQL("DROP TABLE IF EXISTS users")
        onCreate(db)
    }
}

// データ挿入例
fun insertUser(context: Context, name: String, email: String) {
    val db = UserDatabaseHelper(context).writableDatabase
    val values = android.content.ContentValues().apply {
        put("name", name)
        put("email", email)
    }
    db.insert("users", null, values)
    db.close()
}

// データ取得例
fun getAllUsers(context: Context): List<String> {
    val db = UserDatabaseHelper(context).readableDatabase
    val cursor = db.query("users", null, null, null, null, null, null)
    val users = mutableListOf<String>()
    
    while (cursor.moveToNext()) {
        val name = cursor.getString(cursor.getColumnIndexOrThrow("name"))
        users.add(name)
    }
    cursor.close()
    db.close()
    return users
}

このアプローチでは、テーブル作成と更新処理を一元管理でき、データベースのバージョン管理も容易です。

iOSでの実装例

iOSではCore Dataやfts5などの選択肢もありますが、SQLiteを直接使う場合はFoundationフレームワークの機能を活用します。

import SQLite3

class UserDatabase {
    var db: OpaquePointer?
    
    init() {
        openDatabase()
        createTable()
    }
    
    func openDatabase() {
        let fileURL = try! FileManager.default
            .url(for: .documentDirectory, in: .userDomainMask, appropriateFor: nil, create: false)
            .appendingPathComponent("users.db")
        
        if sqlite3_open(fileURL.path, &db) == SQLITE_OK {
            print("Successfully opened database")
        }
    }
    
    func createTable() {
        let createTableSQL = """
            CREATE TABLE IF NOT EXISTS users (
                id INTEGER PRIMARY KEY AUTOINCREMENT,
                name TEXT NOT NULL,
                email TEXT UNIQUE NOT NULL,
                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
            )
        """
        
        if sqlite3_exec(db, createTableSQL, nil, nil, nil) == SQLITE_OK {
            print("Table created successfully")
        }
    }
    
    func insertUser(name: String, email: String) {
        let insertSQL = "INSERT INTO users (name, email) VALUES (?, ?)"
        var statement: OpaquePointer?
        
        if sqlite3_prepare_v2(db, insertSQL, -1, &statement, nil) == SQLITE_OK {
            sqlite3_bind_text(statement, 1, name, -1, SQLITE_TRANSIENT)
            sqlite3_bind_text(statement, 2, email, -1, SQLITE_TRANSIENT)
            
            if sqlite3_step(statement) == SQLITE_DONE {
                print("User inserted successfully")
            }
        }
        sqlite3_finalize(statement)
    }
}

実装時の注意点

SQLiteをモバイルアプリで使用する際は、いくつかの注意点があります。

スレッドセーフティは重要です。SQLiteへのアクセスをメインスレッドから行う場合、UIのフリーズを避けるため、重い処理はバックグラウンドスレッドで実行することをお勧めします。

データベースサイズの監視も必要です。定期的に不要なレコードを削除し、デバイスの容量を圧迫しないようにしましょう。

セキュリティの観点からは、暗号化の導入を検討する価値があります。SQLCipherなどのライブラリを使用すれば、データベースファイル全体を暗号化できます。

まとめ

SQLiteはモバイルアプリのローカルデータベースとして、シンプルで効果的な選択肢です。セットアップが容易でありながら、本格的なリレーショナルデータベース機能を提供するため、多くのプロダクション環境で採用されています。AndroidやiOSでの基本的な実装は比較的単純ですが、スレッド管理やセキュリティなどの実装時の工夫が品質の向上につながります。

皆さんのモバイルアプリ開発に、SQLiteが活躍することを祈っています。