PublicArchive/sqlalchemy
2
0
Fork 0
mirror of https://github.com/sqlalchemy/sqlalchemy.git synced 2026-05-31 04:48:02 -04:00
Code Issues Packages Projects Releases Wiki Activity

- remove "completely raw", whatever that is

Browse Source
This commit is contained in:
Mike Bayer
2015-07-26 16:29:30 -04:00
parent 2997d3910d
commit 7d268d4bcb
1 changed files with 16 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/build/orm/tutorial.rst
Vendored
+16 -21
View File
@@ -968,23 +968,8 @@ mapper (below illustrated using an asterisk):
('ed',)
{stop}[<User(name='ed', fullname='Ed Jones', password='f8s7ccs')>]
You can use :meth:`~sqlalchemy.orm.query.Query.from_statement()` to go
completely "raw", using string names to identify desired columns:
.. sourcecode:: python+sql
{sql}>>> session.query("id", "name", "thenumber12").\
... from_statement(text("SELECT id, name, 12 as "
... "thenumber12 FROM users where name=:name")).\
... params(name='ed').all()
SELECT id, name, 12 as thenumber12 FROM users where name=?
('ed',)
{stop}[(1, u'ed', 12)]
The :func:`.text` construct also supports the :meth:`.TextClause.columns`
method, which can be used to associate ORM-mapped columns explicitly.
This is useful to make an explicit mapping of columns in the string
statement to those that are mapped:
Or alternatively, specify how the columns map to the :func:`.text` construct
explicitly using the :meth:`.TextClause.columns` method:
.. sourcecode:: python+sql
@@ -995,12 +980,17 @@ statement to those that are mapped:
('ed',)
{stop}[<User(name='ed', fullname='Ed Jones', password='f8s7ccs')>]
We can choose columns to return individually as well, as in any other case:
.. versionchanged:: 1.0.0
The :class:`.Query` construct emits warnings when string SQL
fragments are coerced to :func:`.text`, and :func:`.text` should
be used explicitly. See :ref:`migration_2992` for background.
.. sourcecode:: python+sql
>>> stmt = text("SELECT name, id FROM users where name=:name")
>>> stmt = stmt.columns(User.name, User.id)
{sql}>>> session.query(User.id, User.name).\
... from_statement(stmt).params(name='ed').all()
SELECT name, id FROM users where name=?
('ed',)
{stop}[(1, u'ed')]
.. seealso::
@@ -1009,6 +999,11 @@ statement to those that are mapped:
:func:`.text` and related constructs is very similar to that of the
Core :func:`.select` object.
.. versionchanged:: 1.0.0
The :class:`.Query` construct emits warnings when string SQL
fragments are coerced to :func:`.text`, and :func:`.text` should
be used explicitly. See :ref:`migration_2992` for background.
Counting
--------