summaryrefslogtreecommitdiff
path: root/doc/build/reference/orm/query.rst
blob: 6ff9048bc8ab13b501ce465388ad76e3ddc19839 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
.. _query_api_toplevel:

Querying
========

.. module:: sqlalchemy.orm

The Query Object
----------------

:class:`~sqlalchemy.orm.query.Query` is produced in terms of a given :class:`~sqlalchemy.orm.session.Session`, using the :func:`~sqlalchemy.orm.query.Query.query` function::

    q = session.query(SomeMappedClass)

Following is the full interface for the :class:`Query` object.

.. autoclass:: sqlalchemy.orm.query.Query
   :members:
   :undoc-members:

ORM-Specific Query Constructs
-----------------------------

.. autoclass:: aliased

.. autoclass:: sqlalchemy.orm.util.AliasedClass

.. autofunction:: join

.. autofunction:: outerjoin

Query Options
-------------

Options which are passed to ``query.options()``, to affect the behavior of loading.

.. autofunction:: contains_eager

.. autofunction:: defer

.. autofunction:: eagerload

.. autofunction:: eagerload_all

.. autofunction:: extension

.. autofunction:: joinedload

.. autofunction:: joinedload_all

.. autofunction:: lazyload

.. autofunction:: subqueryload

.. autofunction:: subqueryload_all

.. autofunction:: undefer