~ubuntu-branches/debian/jessie/sqlalchemy/jessie

« back to all changes in this revision

Viewing changes to doc/build/core/expression_api.rst

  • Committer: Package Import Robot
  • Author(s): Piotr Ożarowski
  • Date: 2013-10-28 22:29:40 UTC
  • mfrom: (1.4.24)
  • Revision ID: package-import@ubuntu.com-20131028222940-wvyqffl4g617caun
Tags: 0.8.3-1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
This section presents the API reference for the SQL Expression Language.  For a full introduction to its usage,
9
9
see :ref:`sqlexpression_toplevel`.
10
10
 
11
 
Functions
12
 
---------
13
 
 
14
 
The expression package uses functions to construct SQL expressions.  The return value of each function is an object instance which is a subclass of :class:`~sqlalchemy.sql.expression.ClauseElement`.
15
 
 
16
 
.. autofunction:: alias
17
 
 
18
 
.. autofunction:: and_
19
 
 
20
 
.. autofunction:: asc
21
 
 
22
 
.. autofunction:: between
23
 
 
24
 
.. autofunction:: bindparam
25
 
 
26
 
.. autofunction:: case
27
 
 
28
 
.. autofunction:: cast
29
 
 
30
 
.. autofunction:: sqlalchemy.sql.expression.column
31
 
 
32
 
.. autofunction:: collate
33
 
 
34
 
.. autofunction:: delete
35
 
 
36
 
.. autofunction:: desc
37
 
 
38
 
.. autofunction:: distinct
39
 
 
40
 
.. autofunction:: except_
41
 
 
42
 
.. autofunction:: except_all
43
 
 
44
 
.. autofunction:: exists
45
 
 
46
 
.. autofunction:: extract
47
 
 
48
 
.. autofunction:: false
49
 
 
50
 
.. autodata:: func
51
 
 
52
 
.. autofunction:: insert
53
 
 
54
 
.. autofunction:: intersect
55
 
 
56
 
.. autofunction:: intersect_all
57
 
 
58
 
.. autofunction:: join
59
 
 
60
 
.. autofunction:: label
61
 
 
62
 
.. autofunction:: literal
63
 
 
64
 
.. autofunction:: literal_column
65
 
 
66
 
.. autofunction:: not_
67
 
 
68
 
.. autofunction:: null
69
 
 
70
 
.. autofunction:: nullsfirst
71
 
 
72
 
.. autofunction:: nullslast
73
 
 
74
 
.. autofunction:: or_
75
 
 
76
 
.. autofunction:: outparam
77
 
 
78
 
.. autofunction:: outerjoin
79
 
 
80
 
.. autofunction:: over
81
 
 
82
 
.. autofunction:: select
83
 
 
84
 
.. autofunction:: subquery
85
 
 
86
 
.. autofunction:: sqlalchemy.sql.expression.table
87
 
 
88
 
.. autofunction:: text
89
 
 
90
 
.. autofunction:: true
91
 
 
92
 
.. autofunction:: tuple_
93
 
 
94
 
.. autofunction:: type_coerce
95
 
 
96
 
.. autofunction:: union
97
 
 
98
 
.. autofunction:: union_all
99
 
 
100
 
.. autofunction:: update
101
 
 
102
 
Classes
103
 
-------
104
 
 
105
 
.. autoclass:: Alias
106
 
   :members:
107
 
   :show-inheritance:
108
 
   :inherited-members:
109
 
 
110
 
.. autoclass:: BinaryExpression
111
 
   :members:
112
 
   :show-inheritance:
113
 
   :inherited-members:
114
 
 
115
 
.. autoclass:: BindParameter
116
 
   :members:
117
 
   :show-inheritance:
118
 
   :inherited-members:
119
 
 
120
 
.. autoclass:: ClauseElement
121
 
   :members:
122
 
   :show-inheritance:
123
 
 
124
 
.. autoclass:: ClauseList
125
 
   :members:
126
 
   :show-inheritance:
127
 
 
128
 
.. autoclass:: ColumnClause
129
 
   :members:
130
 
   :show-inheritance:
131
 
   :inherited-members:
132
 
 
133
 
.. autoclass:: ColumnCollection
134
 
   :members:
135
 
   :show-inheritance:
136
 
 
137
 
.. autoclass:: ColumnElement
138
 
   :members:
139
 
   :show-inheritance:
140
 
   :inherited-members:
141
 
 
142
 
.. autoclass:: sqlalchemy.sql.operators.ColumnOperators
143
 
   :members:
144
 
   :special-members:
145
 
   :inherited-members:
146
 
   :show-inheritance:
147
 
 
148
 
 
149
 
.. autoclass:: CompoundSelect
150
 
   :members:
151
 
   :show-inheritance:
152
 
   :inherited-members:
153
 
 
154
 
.. autoclass:: sqlalchemy.sql.operators.custom_op
155
 
   :members:
156
 
 
157
 
.. autoclass:: CTE
158
 
   :members:
159
 
   :show-inheritance:
160
 
   :inherited-members:
161
 
 
162
 
.. autoclass:: Delete
163
 
   :members:
164
 
   :show-inheritance:
165
 
   :inherited-members:
166
 
 
167
 
.. autoclass:: Executable
168
 
   :members:
169
 
   :show-inheritance:
170
 
 
171
 
.. autoclass:: FunctionElement
172
 
   :members:
173
 
   :show-inheritance:
174
 
   :inherited-members:
175
 
 
176
 
.. autoclass:: Function
177
 
   :members:
178
 
   :show-inheritance:
179
 
   :inherited-members:
180
 
 
181
 
.. autoclass:: FromClause
182
 
   :members:
183
 
   :show-inheritance:
184
 
 
185
 
.. autoclass:: Insert
186
 
   :members:
187
 
   :show-inheritance:
188
 
   :inherited-members:
189
 
 
190
 
.. autoclass:: Join
191
 
   :members:
192
 
   :show-inheritance:
193
 
   :inherited-members:
194
 
 
195
 
.. autoclass:: sqlalchemy.sql.operators.Operators
196
 
   :members:
197
 
   :special-members:
198
 
 
199
 
.. autoclass:: Select
200
 
   :members:
201
 
   :show-inheritance:
202
 
   :inherited-members:
203
 
 
204
 
.. autoclass:: Selectable
205
 
   :members:
206
 
   :show-inheritance:
207
 
 
208
 
.. autoclass:: SelectBase
209
 
   :members:
210
 
   :show-inheritance:
211
 
 
212
 
.. autoclass:: TableClause
213
 
   :members:
214
 
   :show-inheritance:
215
 
   :inherited-members:
216
 
 
217
 
.. autoclass:: UnaryExpression
218
 
   :members:
219
 
   :show-inheritance:
220
 
 
221
 
.. autoclass:: Update
222
 
  :members:
223
 
  :inherited-members:
224
 
  :show-inheritance:
225
 
 
226
 
.. autoclass:: UpdateBase
227
 
  :members:
228
 
  :show-inheritance:
229
 
 
230
 
.. autoclass:: ValuesBase
231
 
    :members:
232
 
    :show-inheritance:
233
 
 
234
 
.. _generic_functions:
235
 
 
236
 
Generic Functions
237
 
-----------------
238
 
 
239
 
SQL functions which are known to SQLAlchemy with regards to database-specific
240
 
rendering, return types and argument behavior. Generic functions are invoked
241
 
like all SQL functions, using the :attr:`func` attribute::
242
 
 
243
 
    select([func.count()]).select_from(sometable)
244
 
 
245
 
Note that any name not known to :attr:`func` generates the function name as is
246
 
- there is no restriction on what SQL functions can be called, known or
247
 
unknown to SQLAlchemy, built-in or user defined. The section here only
248
 
describes those functions where SQLAlchemy already knows what argument and
249
 
return types are in use.
250
 
 
251
 
.. automodule:: sqlalchemy.sql.functions
252
 
   :members:
253
 
   :undoc-members:
254
 
   :show-inheritance:
255
 
 
 
11
 
 
12
.. toctree::
 
13
    :maxdepth: 1
 
14
 
 
15
    sqlelement
 
16
    selectable
 
17
    dml
 
18
    functions
 
19
    types
256
20