【Elixir】Ecto で Preload の色々

Ecto の preload 機能に焦点を当て、その使い方を色々と解説します。

単一の関連付けを Preload

もっとも基本的な使い方です。ユーザーとそのプロフィールを一緒に取得する例を見てみましょう。

1
2
3
# 単一の関連付けを preload する
query = from u in User, preload: [:profile]
users = Repo.all(query)

このコードは、User テーブルからすべてのユーザーを取得し、それぞれの profile も一緒に取得します。

複数の関連付けを Preload

複数の関連付けも一度に取得できます。たとえば、ユーザーとそのプロフィール、投稿を一緒に取得する場合：

1
2
3
# 複数の関連付けを preload する
query = from u in User, preload: [:profile, :posts]
users = Repo.all(query)

ネストされた関連付けを Preload

関連付けがネストしている場合も、一度のクエリで取得できます。

1
2
3
# ネストされた関連付けを preload する
query = from u in User, preload: [posts: :comments]
users = Repo.all(query)

この例では、ユーザーの投稿と、その投稿に対するコメントを一緒に取得します。

動的な Preload

条件に応じて動的に preload を行いたい場合もあります。

1
2
3
4
# 条件に応じて動的に preload する
dynamic_preload = if some_condition, do: [:profile], else: []
query = from u in User, preload: ^dynamic_preload
users = Repo.all(query)

Repo.preload/2 を使用する

すでにに取得したデータに対して後から preload することも可能です。

1
2
3
# 既に取得したデータに対して後から preload する
users = Repo.all(User)
users = Repo.preload(users, [:profile, :posts])

カスタムクエリで Preload

特定の条件にマッチする関連付けだけを preload したい場合は、カスタムクエリを使用できます。

1
2
3
4
# カスタムクエリを使用して preload する
custom_query = from p in Post, where: p.published == true
query = from u in User, preload: [posts: ^custom_query]
users = Repo.all(query)

この例では、公開されている Post のみを preload しています。

まとめ

Ecto の preload 機能は非常に強力で、多くのケースでデータベースの効率的な操作が可能です。
この記事で紹介したテクニックをマスターすれば、Ecto を更に効果的に使えるようになるでしょう。
以上、Elixir の Ecto での preload の使い方についてでした。是非とも実践に活かしてください。