Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Give example combining eager_graph with where/order (Fixes #565)

  • Loading branch information...
commit 5f888fa9e2f7de8f950adabf6991d05861407a5b 1 parent acb361d
@jeremyevans authored
Showing with 12 additions and 0 deletions.
  1. +12 −0 doc/advanced_associations.rdoc
12 doc/advanced_associations.rdoc
@@ -65,6 +65,18 @@ Remember, using +eager_graph+ is generally only necessary when you need to
filter/order based on columns in an associated table, it is recommended to
use +eager+ for eager loading if possible.
+One advantage of using +eager_graph+ is that you can easily filter/order
+on columns in an associated table on a per-query basis, using regular
+Sequel dataset methods. For example, if you only want to retrieve artists
+who have albums that start with A, and eager load just those albums,
+ordered by the albums name, you can do:
+ albums = Artist.
+ eager_graph(:albums).
+ where(, 'A%')).
+ order(:albums__name).
+ all
For lazy loading (e.g. Model[1].association), the <tt>:dataset</tt> option can be used
to specify an arbitrary dataset (one that uses different keys, multiple keys,
joins to other tables, etc.).
Please sign in to comment.
Something went wrong with that request. Please try again.