diff options
author | aplatkouski <5857672+aplatkouski@users.noreply.github.com> | 2020-06-22 11:34:39 -0400 |
---|---|---|
committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2020-06-25 19:42:28 -0400 |
commit | 2a1a9f5f5a9723f757439657d2bdf224baed8748 (patch) | |
tree | 0fb5b7e4dfbe21b329da52e0774ad557ecac1714 /doc/build/orm/tutorial.rst | |
parent | 3138201a82d4e62e56e44ca9c8914c20dd46d1b4 (diff) | |
download | sqlalchemy-2a1a9f5f5a9723f757439657d2bdf224baed8748.tar.gz |
Fix a wide variety of typos and broken links
Note the PR has a few remaining doc linking issues
listed in the comment that must be addressed separately.
Signed-off-by: aplatkouski <5857672+aplatkouski@users.noreply.github.com>
Closes: #5371
Pull-request: https://github.com/sqlalchemy/sqlalchemy/pull/5371
Pull-request-sha: 7e7d233cf3a0c66980c27db0fcdb3c7d93bc2510
Change-Id: I9c36e8d8804483950db4b42c38ee456e384c59e3
Diffstat (limited to 'doc/build/orm/tutorial.rst')
-rw-r--r-- | doc/build/orm/tutorial.rst | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/doc/build/orm/tutorial.rst b/doc/build/orm/tutorial.rst index 8ea8af4a2..a6ef57bed 100644 --- a/doc/build/orm/tutorial.rst +++ b/doc/build/orm/tutorial.rst @@ -849,7 +849,7 @@ A number of methods on :class:`_query.Query` immediately issue SQL and return a value containing loaded database results. Here's a brief tour: -* :meth:`_query.Query.all()` returns a list: +* :meth:`_query.Query.all` returns a list: .. sourcecode:: python+sql @@ -880,7 +880,7 @@ database results. Here's a brief tour: :ref:`faq_query_deduplicating` -* :meth:`_query.Query.first()` applies a limit of one and returns +* :meth:`_query.Query.first` applies a limit of one and returns the first result as a scalar: .. sourcecode:: python+sql @@ -896,7 +896,7 @@ database results. Here's a brief tour: [...] ('%ed', 1, 0) {stop}<User(name='ed', fullname='Ed Jones', nickname='eddie')> -* :meth:`_query.Query.one()` fully fetches all rows, and if not +* :meth:`_query.Query.one` fully fetches all rows, and if not exactly one object identity or composite row is present in the result, raises an error. With multiple rows found: @@ -949,8 +949,8 @@ Literal strings can be used flexibly with :class:`~sqlalchemy.orm.query.Query`, by specifying their use with the :func:`_expression.text` construct, which is accepted by most applicable methods. For example, -:meth:`~sqlalchemy.orm.query.Query.filter()` and -:meth:`~sqlalchemy.orm.query.Query.order_by()`: +:meth:`_query.Query.filter` and +:meth:`_query.Query.order_by`: .. sourcecode:: python+sql @@ -972,7 +972,7 @@ by most applicable methods. For example, fred Bind parameters can be specified with string-based SQL, using a colon. To -specify the values, use the :meth:`~sqlalchemy.orm.query.Query.params()` +specify the values, use the :meth:`_query.Query.params` method: .. sourcecode:: python+sql @@ -990,9 +990,9 @@ method: To use an entirely string-based statement, a :func:`_expression.text` construct representing a complete statement can be passed to -:meth:`~sqlalchemy.orm.query.Query.from_statement()`. Without further +:meth:`_query.Query.from_statement`. Without further specification, the ORM will match columns in the ORM mapping to the result -returned by the SQL statement based on column name:: +returned by the SQL statement based on column name: .. sourcecode:: python+sql @@ -1040,7 +1040,7 @@ Counting -------- :class:`~sqlalchemy.orm.query.Query` includes a convenience method for -counting called :meth:`~sqlalchemy.orm.query.Query.count()`: +counting called :meth:`_query.Query.count`: .. sourcecode:: python+sql @@ -1065,7 +1065,7 @@ counting called :meth:`~sqlalchemy.orm.query.Query.count()`: and always returns the right answer. Use ``func.count()`` if a particular statement absolutely cannot tolerate the subquery being present. -The :meth:`_query.Query.count()` method is used to determine +The :meth:`_query.Query.count` method is used to determine how many rows the SQL statement would return. Looking at the generated SQL above, SQLAlchemy always places whatever it is we are querying into a subquery, then counts the rows from that. In some cases @@ -1328,7 +1328,7 @@ The `Wikipedia page on SQL JOIN join techniques, several of which we'll illustrate here. To construct a simple implicit join between ``User`` and ``Address``, -we can use :meth:`_query.Query.filter()` to equate their related columns together. +we can use :meth:`_query.Query.filter` to equate their related columns together. Below we load the ``User`` and ``Address`` entities at once using this method: .. sourcecode:: python+sql |