KotlinのRoomで複雑なクエリを使いこなす！初心者でもわかる応用テクニック

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

生徒

「先生、Roomを使ってデータベースを操作する方法は少しずつ分かってきたんですが、もっと複雑な条件でデータを取り出したいときはどうすればいいんですか？」

先生

「とても良いところに目をつけましたね。Roomでは、SQLのように複雑な条件や結合、並び替え、部分一致などを使って、必要なデータを柔軟に取り出すことができますよ。」

生徒

「なんだか難しそうですが、初心者でも使いこなせるんですか？」

先生

「もちろんです。今回は、KotlinでRoomを使って複雑なクエリを作る応用テクニックを、わかりやすく丁寧に解説していきましょう。」

1. Roomとは？改めておさらい

Roomとは、Androidで使われるデータベースライブラリのことです。アプリ内にデータを保存するために使われ、SQLiteというデータベースエンジンの操作を、より簡単に行えるようにしてくれます。

データベースとは、情報を整理して保管しておく場所のことです。例えば「名前」や「年齢」などの情報を表のように保存しておけます。

2. 複雑なクエリとは？

複雑なクエリとは、「特定の条件で絞り込む」「複数の表を組み合わせる」「並び替える」「部分一致で検索する」など、単純な「全件取得」や「IDで検索」よりも高度なデータの取り出し方のことです。

たとえば、「20歳以上で名前に『山』が含まれている人を年齢の高い順に並べて取得」などの処理が該当します。

3. Roomで複雑な検索条件を使うには？

Roomでは、@Queryアノテーションの中に、SQL文を直接書くことで複雑な条件を記述できます。以下に、名前にキーワードが含まれ、年齢が特定の値以上の人を抽出する例を紹介します。


@Dao
interface UserDao {
    @Query("SELECT * FROM users WHERE name LIKE '%' || :keyword || '%' AND age >= :minAge ORDER BY age DESC")
    fun searchUsers(keyword: String, minAge: Int): List<User>
}

この例では、LIKEというキーワードを使って部分一致検索を行い、ANDで複数の条件を組み合わせ、ORDER BYで並び替えをしています。

4. テーブル同士を結合（JOIN）して検索

複数のテーブル（表）に分けてデータを保存している場合、それらを組み合わせて検索するためには「JOIN（ジョイン）」を使います。JOINとは「つなげる」という意味です。

例えば「ユーザー情報」と「投稿記事」の2つのテーブルがあるとき、「特定のユーザーが書いた記事一覧」を取り出すには、ユーザーと記事を結びつける必要があります。


@Query("""
    SELECT users.name, posts.title
    FROM users
    INNER JOIN posts ON users.id = posts.user_id
    WHERE users.age >= :age
    ORDER BY posts.created_at DESC
""")
fun getPostsByUserAge(age: Int): List<UserWithPost>

INNER JOINを使うと、条件に一致するデータだけが組み合わされて結果として出てきます。

5. 結果を入れるデータクラスを定義する

上のようにテーブルを結合した結果は、複数のテーブルから項目を取り出すため、Roomが自動でマッピングできません。そのため、結果を入れる専用のデータクラスを定義する必要があります。


data class UserWithPost(
    val name: String,
    val title: String
)

このように、SQLで取り出す項目に合わせてKotlinのdata classを作ることで、結果をスムーズに扱えます。

6. BETWEENやINで範囲検索・複数条件

Roomでは、SQLと同様にBETWEENやINといった条件も使えます。例えば、「20歳〜30歳のユーザー」や「特定のIDを持つユーザー」を検索する場合に便利です。


@Query("SELECT * FROM users WHERE age BETWEEN :startAge AND :endAge")
fun getUsersInAgeRange(startAge: Int, endAge: Int): List<User>

@Query("SELECT * FROM users WHERE id IN (:ids)")
fun getUsersByIds(ids: List<Int>): List<User>

BETWEENは指定した範囲内、INは複数の値の中に一致するものを取り出すときに使います。

7. COUNTやSUMなどの集計処理もできる

Roomでは、件数を数えたり、合計を出したりする集計関数も利用できます。たとえば「登録されているユーザーの人数」や「全投稿の合計いいね数」などを簡単に取得できます。


@Query("SELECT COUNT(*) FROM users")
fun countUsers(): Int

@Query("SELECT SUM(likes) FROM posts")
fun totalLikes(): Int

このように、Roomでも一般的なSQLの構文がしっかりと使えるため、複雑なデータ処理にも対応できます。

8. Roomのクエリを使いこなすためのコツ

Roomの複雑なクエリを使いこなすには、次のようなポイントを意識すると良いでしょう。

必要なデータを明確にイメージすること
SQLの基本文法に少しずつ慣れること
クエリの結果に合わせてデータクラスを設計すること

最初は難しく感じるかもしれませんが、一つ一つの例を試していけば、少しずつ応用もできるようになります。