Provide example for exists

Fixes: #5423
Change-Id: I716f8de17c49d7eefbbce5ddd9da203bfc9fe47f
(cherry picked from commit 90a97ad9b63d5aa80439a20e7a9db450026d58de)

diff --git a/lib/sqlalchemy/sql/selectable.py b/lib/sqlalchemy/sql/selectable.py
index 56962271b6bf40aef0571ea0573d9b7cdba2a206..1e73d64552b9e1c990c1e62f7d4e74737ac84728 100644 (file)
--- a/lib/sqlalchemy/sql/selectable.py
+++ b/lib/sqlalchemy/sql/selectable.py
@@ -4048,7 +4048,15 @@ class Exists(UnaryExpression):
 
             # use on an existing select()
             s = select([table.c.col1]).where(table.c.col2==5)
-            s = exists(s)
+            s_e = exists(s)
+
+            # an exists is usually used in a where of another select
+            # to produce a WHERE EXISTS (SELECT ... )
+            select([table.c.col1]).where(s_e)
+
+            # but can also be used in a select to produce a
+            # SELECT EXISTS (SELECT ... ) query
+            select([s_e])
 
             # construct a select() at once
             exists(['*'], **select_arguments).where(criterion)