From: Mike Bayer Date: Thu, 7 Aug 2014 13:59:59 +0000 (-0400) Subject: - clarify docs that contains_eager() is included in the of_type() system, X-Git-Tag: rel_0_9_8~69 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8cc9f89b5eca14252e202ef6e88d3d35496930f6;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git - clarify docs that contains_eager() is included in the of_type() system, fix #2438 --- diff --git a/doc/build/orm/inheritance.rst b/doc/build/orm/inheritance.rst index 623892b333..642f3420c2 100644 --- a/doc/build/orm/inheritance.rst +++ b/doc/build/orm/inheritance.rst @@ -472,7 +472,8 @@ subselect back to the parent ``companies`` table. Eager Loading of Specific or Polymorphic Subtypes ++++++++++++++++++++++++++++++++++++++++++++++++++ -The :func:`.joinedload` and :func:`.subqueryload` options also support +The :func:`.joinedload`, :func:`.subqueryload`, :func:`.contains_eager` and +other loading-related options also support paths which make use of :func:`~sqlalchemy.orm.interfaces.PropComparator.of_type`. Below we load ``Company`` rows while eagerly loading related ``Engineer`` objects, querying the ``employee`` and ``engineer`` tables simultaneously:: @@ -500,11 +501,13 @@ can be loaded:: ) .. versionadded:: 0.8 - :func:`.joinedload` and :func:`.subqueryload` support + :func:`.joinedload`, :func:`.subqueryload`, :func:`.contains_eager` + and related loader options support paths that are qualified with :func:`~sqlalchemy.orm.interfaces.PropComparator.of_type`, supporting single target types as well as :func:`.orm.with_polymorphic` targets. + Single Table Inheritance ------------------------