]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
Add note on the use of tuple_() for the IN operator
authorStepland <16676308+Stepland@users.noreply.github.com>
Mon, 16 Sep 2019 14:19:02 +0000 (16:19 +0200)
committerStepland <16676308+Stepland@users.noreply.github.com>
Mon, 16 Sep 2019 14:19:02 +0000 (16:19 +0200)
doc/build/orm/tutorial.rst

index 14ea82a0ddd2bb5e82429bc5e65b0d0b46b8b979..3e3ac0cd4a13b1f1d9636e900b0d08490da048c0 100644 (file)
@@ -783,6 +783,9 @@ Here's a rundown of some of the most common operators used in
         session.query(User.name).filter(User.name.like('%ed%'))
     ))
 
+ .. note:: for composite (multi-column) IN queries, group columns together
+    using :func:`.tuple_`
+
 * :meth:`NOT IN <.ColumnOperators.notin_>`::
 
     query.filter(~User.name.in_(['ed', 'wendy', 'jack']))