Thread view

#1229: more eager loading detail in ORM tutorial
---------------------------+------------------------------------------------
Reporter: zzzeek | Owner: zzzeek
Type: enhancement | Status: new
Priority: high | Milestone: 0.5.0
Component: documentation | Severity: minor - half an hour
Keywords: | Status_field: awaiting triage
---------------------------+------------------------------------------------
under "Working with Related Objects", take the "eager loading" blurb and
make a new section for it "Automatic Eager Loading". put the eagerload()
option there, then add another section "Manual Eager Loading" with a basic
example of query.join(xx).options(contains_eager(...)). Make sure it
links to the more detailed section on contains_eager() in the mapping
docs. both eagerload() and contains_eager() should now be considered as
equals as there is an appropriateness to each one.
--
Ticket URL: <http://www.sqlalchemy.org/trac/ticket/1229&gt;
sqlalchemy <http://www.sqlalchemy.org/&gt;
The Database Toolkit for Python