]> granicus.if.org Git - postgresql/commitdiff
Allow ORDER BY, LIMIT in sub-selects. Fix most (not all) cases where
authorTom Lane <tgl@sss.pgh.pa.us>
Sun, 5 Nov 2000 00:15:54 +0000 (00:15 +0000)
committerTom Lane <tgl@sss.pgh.pa.us>
Sun, 5 Nov 2000 00:15:54 +0000 (00:15 +0000)
the grammar did not allow redundant parentheses around sub-selects.
Distinguish LIMIT ALL from LIMIT 0; make the latter behave as one would
expect.

src/backend/executor/nodeLimit.c
src/backend/nodes/copyfuncs.c
src/backend/nodes/equalfuncs.c
src/backend/optimizer/plan/planner.c
src/backend/parser/analyze.c
src/backend/parser/gram.y
src/backend/utils/adt/ruleutils.c
src/include/nodes/parsenodes.h

index c7bc666c2f978ed09d90ea888e7af4d05442fe17..9e0cef44ab18e7c8be32950a7c569b6aa34c12a9 100644 (file)
@@ -8,7 +8,7 @@
  *
  *
  * IDENTIFICATION
- *       $Header: /cvsroot/pgsql/src/backend/executor/nodeLimit.c,v 1.1 2000/10/26 21:35:15 tgl Exp $
+ *       $Header: /cvsroot/pgsql/src/backend/executor/nodeLimit.c,v 1.2 2000/11/05 00:15:52 tgl Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -188,17 +188,11 @@ recompute_limits(Limit *node)
                                                                                                                econtext,
                                                                                                                &isNull,
                                                                                                                NULL));
-               /* Interpret NULL count as no count */
+               /* Interpret NULL count as no count (LIMIT ALL) */
                if (isNull)
                        limitstate->noCount = true;
-               else
-               {
-                       /* Currently, LIMIT 0 is specified as meaning no limit.
-                        * I think this is pretty bogus, but ...
-                        */
-                       if (limitstate->count <= 0)
-                               limitstate->noCount = true;
-               }
+               else if (limitstate->count < 0)
+                       limitstate->count = 0;
        }
        else
        {
index 9435a396f0795205aa45aef3c9213910b0cf627f..406e85ce623aefa7193805a547d682028a6e4474 100644 (file)
@@ -15,7 +15,7 @@
  * Portions Copyright (c) 1994, Regents of the University of California
  *
  * IDENTIFICATION
- *       $Header: /cvsroot/pgsql/src/backend/nodes/copyfuncs.c,v 1.128 2000/10/31 10:22:10 petere Exp $
+ *       $Header: /cvsroot/pgsql/src/backend/nodes/copyfuncs.c,v 1.129 2000/11/05 00:15:52 tgl Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -1826,6 +1826,7 @@ _copySelectStmt(SelectStmt *from)
        Node_Copy(from, newnode, distinctClause);
        if (from->into)
                newnode->into = pstrdup(from->into);
+       newnode->istemp = from->istemp;
        Node_Copy(from, newnode, targetList);
        Node_Copy(from, newnode, fromClause);
        Node_Copy(from, newnode, whereClause);
@@ -1835,10 +1836,13 @@ _copySelectStmt(SelectStmt *from)
        if (from->portalname)
                newnode->portalname = pstrdup(from->portalname);
        newnode->binary = from->binary;
-       newnode->istemp = from->istemp;
        Node_Copy(from, newnode, limitOffset);
        Node_Copy(from, newnode, limitCount);
        Node_Copy(from, newnode, forUpdate);
+       newnode->op = from->op;
+       newnode->all = from->all;
+       Node_Copy(from, newnode, larg);
+       Node_Copy(from, newnode, rarg);
 
        return newnode;
 }
index 8519fd6115e0b696d6c6cca23c81e13d2d37e381..08087136a10d96675b88700d86091599cdc73c43 100644 (file)
@@ -20,7 +20,7 @@
  * Portions Copyright (c) 1994, Regents of the University of California
  *
  * IDENTIFICATION
- *       $Header: /cvsroot/pgsql/src/backend/nodes/equalfuncs.c,v 1.78 2000/10/31 10:22:10 petere Exp $
+ *       $Header: /cvsroot/pgsql/src/backend/nodes/equalfuncs.c,v 1.79 2000/11/05 00:15:52 tgl Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -686,6 +686,8 @@ _equalSelectStmt(SelectStmt *a, SelectStmt *b)
                return false;
        if (!equalstr(a->into, b->into))
                return false;
+       if (a->istemp != b->istemp)
+               return false;
        if (!equal(a->targetList, b->targetList))
                return false;
        if (!equal(a->fromClause, b->fromClause))
@@ -702,14 +704,20 @@ _equalSelectStmt(SelectStmt *a, SelectStmt *b)
                return false;
        if (a->binary != b->binary)
                return false;
-       if (a->istemp != b->istemp)
-               return false;
        if (!equal(a->limitOffset, b->limitOffset))
                return false;
        if (!equal(a->limitCount, b->limitCount))
                return false;
        if (!equal(a->forUpdate, b->forUpdate))
                return false;
+       if (a->op != b->op)
+               return false;
+       if (a->all != b->all)
+               return false;
+       if (!equal(a->larg, b->larg))
+               return false;
+       if (!equal(a->rarg, b->rarg))
+               return false;
 
        return true;
 }
index f9c70f7137d4ea3527036d4a8567c24109fc3b19..5951e8f0c9b03a41206f3913e1d6aee6e45ac8f9 100644 (file)
@@ -8,7 +8,7 @@
  *
  *
  * IDENTIFICATION
- *       $Header: /cvsroot/pgsql/src/backend/optimizer/plan/planner.c,v 1.93 2000/10/26 21:36:09 tgl Exp $
+ *       $Header: /cvsroot/pgsql/src/backend/optimizer/plan/planner.c,v 1.94 2000/11/05 00:15:53 tgl Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -809,25 +809,26 @@ union_planner(Query *parse,
                                if (IsA(parse->limitCount, Const))
                                {
                                        Const      *limitc = (Const *) parse->limitCount;
-                                       int                     count = (int) (limitc->constvalue);
+                                       int32           count = DatumGetInt32(limitc->constvalue);
 
                                        /*
-                                        * The constant can legally be either 0 ("ALL") or a
-                                        * positive integer.  If it is not ALL, we also need
-                                        * to consider the OFFSET part of LIMIT.
+                                        * A NULL-constant LIMIT represents "LIMIT ALL",
+                                        * which we treat the same as no limit (ie,
+                                        * expect to retrieve all the tuples).
                                         */
-                                       if (count > 0)
+                                       if (!limitc->constisnull && count > 0)
                                        {
                                                tuple_fraction = (double) count;
+                                               /* We must also consider the OFFSET, if present */
                                                if (parse->limitOffset != NULL)
                                                {
                                                        if (IsA(parse->limitOffset, Const))
                                                        {
-                                                               int                     offset;
+                                                               int32           offset;
 
                                                                limitc = (Const *) parse->limitOffset;
-                                                               offset = (int) (limitc->constvalue);
-                                                               if (offset > 0)
+                                                               offset = DatumGetInt32(limitc->constvalue);
+                                                               if (!limitc->constisnull && offset > 0)
                                                                        tuple_fraction += (double) offset;
                                                        }
                                                        else
@@ -850,14 +851,14 @@ union_planner(Query *parse,
                        }
 
                        /*
-                        * Check for a retrieve-into-portal, ie DECLARE CURSOR.
+                        * If no LIMIT, check for retrieve-into-portal, ie DECLARE CURSOR.
                         *
                         * We have no real idea how many tuples the user will ultimately
                         * FETCH from a cursor, but it seems a good bet that he
                         * doesn't want 'em all.  Optimize for 10% retrieval (you
                         * gotta better number?)
                         */
-                       if (parse->isPortal)
+                       else if (parse->isPortal)
                                tuple_fraction = 0.10;
                }
 
index b86dab4bea0d3671d8f479f81baef340ab2135be..45e81aec60811d77b999c17da9d59dc9c961905e 100644 (file)
@@ -6,7 +6,7 @@
  * Portions Copyright (c) 1996-2000, PostgreSQL, Inc
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- *     $Id: analyze.c,v 1.162 2000/11/04 18:29:09 momjian Exp $
+ *     $Id: analyze.c,v 1.163 2000/11/05 00:15:54 tgl Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -46,8 +46,8 @@ static Query *transformIndexStmt(ParseState *pstate, IndexStmt *stmt);
 static Query *transformExtendStmt(ParseState *pstate, ExtendStmt *stmt);
 static Query *transformRuleStmt(ParseState *query, RuleStmt *stmt);
 static Query *transformSelectStmt(ParseState *pstate, SelectStmt *stmt);
-static Query *transformSetOperationStmt(ParseState *pstate, SetOperationStmt *stmt);
-static Node *transformSetOperationTree(ParseState *pstate, Node *node);
+static Query *transformSetOperationStmt(ParseState *pstate, SelectStmt *stmt);
+static Node *transformSetOperationTree(ParseState *pstate, SelectStmt *stmt);
 static Query *transformUpdateStmt(ParseState *pstate, UpdateStmt *stmt);
 static Query *transformCreateStmt(ParseState *pstate, CreateStmt *stmt);
 static Query *transformAlterTableStmt(ParseState *pstate, AlterTableStmt *stmt);
@@ -257,11 +257,12 @@ transformStmt(ParseState *pstate, Node *parseTree)
                        break;
 
                case T_SelectStmt:
-                       result = transformSelectStmt(pstate, (SelectStmt *) parseTree);
-                       break;
-
-               case T_SetOperationStmt:
-                       result = transformSetOperationStmt(pstate, (SetOperationStmt *) parseTree);
+                       if (((SelectStmt *) parseTree)->op == SETOP_NONE)
+                               result = transformSelectStmt(pstate,
+                                                                                        (SelectStmt *) parseTree);
+                       else
+                               result = transformSetOperationStmt(pstate,
+                                                                                                  (SelectStmt *) parseTree);
                        break;
 
                default:
@@ -1173,7 +1174,7 @@ transformCreateStmt(ParseState *pstate, CreateStmt *stmt)
                                        found=1;
                                }
                                if (!found)
-                                       elog(ERROR, "columns in foreign key table of constraint not found.");
+                                       elog(ERROR, "columns referenced in foreign key constraint not found.");
                        }
 
                        /*
@@ -1772,29 +1773,30 @@ transformSelectStmt(ParseState *pstate, SelectStmt *stmt)
 
 /*
  * transformSetOperationsStmt -
- *       transforms a SetOperations Statement
+ *       transforms a set-operations tree
  *
- * SetOperations is actually just a SELECT, but with UNION/INTERSECT/EXCEPT
+ * A set-operation tree is just a SELECT, but with UNION/INTERSECT/EXCEPT
  * structure to it.  We must transform each leaf SELECT and build up a top-
  * level Query that contains the leaf SELECTs as subqueries in its rangetable.
- * The SetOperations tree (with leaf SelectStmts replaced by RangeTblRef nodes)
- * becomes the setOperations field of the top-level Query.
+ * The tree of set operations is converted into the setOperations field of
+ * the top-level Query.
  */
 static Query *
-transformSetOperationStmt(ParseState *pstate, SetOperationStmt *stmt)
+transformSetOperationStmt(ParseState *pstate, SelectStmt *stmt)
 {
        Query      *qry = makeNode(Query);
-       Node       *node;
        SelectStmt *leftmostSelect;
        Query      *leftmostQuery;
+       SetOperationStmt *sostmt;
        char       *into;
+       bool            istemp;
        char       *portalname;
        bool            binary;
-       bool            istemp;
        List       *sortClause;
        Node       *limitOffset;
        Node       *limitCount;
        List       *forUpdate;
+       Node       *node;
        List       *lefttl,
                           *dtlist;
        int                     tllen;
@@ -1802,50 +1804,55 @@ transformSetOperationStmt(ParseState *pstate, SetOperationStmt *stmt)
        qry->commandType = CMD_SELECT;
 
        /*
-        * Find leftmost leaf SelectStmt and extract the one-time-only items
-        * from it.
+        * Find leftmost leaf SelectStmt; extract the one-time-only items
+        * from it and from the top-level node.
         */
-       node = stmt->larg;
-       while (node && IsA(node, SetOperationStmt))
-               node = ((SetOperationStmt *) node)->larg;
-       Assert(node && IsA(node, SelectStmt));
-       leftmostSelect = (SelectStmt *) node;
-
+       leftmostSelect = stmt->larg;
+       while (leftmostSelect && leftmostSelect->op != SETOP_NONE)
+               leftmostSelect = leftmostSelect->larg;
+       Assert(leftmostSelect && IsA(leftmostSelect, SelectStmt) &&
+                  leftmostSelect->larg == NULL);
        into = leftmostSelect->into;
-       portalname = leftmostSelect->portalname;
-       binary = leftmostSelect->binary;
        istemp = leftmostSelect->istemp;
-       sortClause = leftmostSelect->sortClause;
-       limitOffset = leftmostSelect->limitOffset;
-       limitCount = leftmostSelect->limitCount;
-       forUpdate = leftmostSelect->forUpdate;
+       portalname = stmt->portalname;
+       binary = stmt->binary;
 
        /* clear them to prevent complaints in transformSetOperationTree() */
        leftmostSelect->into = NULL;
-       leftmostSelect->portalname = NULL;
-       leftmostSelect->binary = false;
        leftmostSelect->istemp = false;
-       leftmostSelect->sortClause = NIL;
-       leftmostSelect->limitOffset = NULL;
-       leftmostSelect->limitCount = NULL;
-       leftmostSelect->forUpdate = NIL;
+       stmt->portalname = NULL;
+       stmt->binary = false;
+
+       /*
+        * These are not one-time, exactly, but we want to process them here
+        * and not let transformSetOperationTree() see them --- else it'll just
+        * recurse right back here!
+        */
+       sortClause = stmt->sortClause;
+       limitOffset = stmt->limitOffset;
+       limitCount = stmt->limitCount;
+       forUpdate = stmt->forUpdate;
+
+       stmt->sortClause = NIL;
+       stmt->limitOffset = NULL;
+       stmt->limitCount = NULL;
+       stmt->forUpdate = NIL;
 
-       /* We don't actually support forUpdate with set ops at the moment. */
+       /* We don't support forUpdate with set ops at the moment. */
        if (forUpdate)
                elog(ERROR, "SELECT FOR UPDATE is not allowed with UNION/INTERSECT/EXCEPT");
 
        /*
         * Recursively transform the components of the tree.
         */
-       stmt = (SetOperationStmt *)
-               transformSetOperationTree(pstate, (Node *) stmt);
-       Assert(stmt && IsA(stmt, SetOperationStmt));
-       qry->setOperations = (Node *) stmt;
+       sostmt = (SetOperationStmt *) transformSetOperationTree(pstate, stmt);
+       Assert(sostmt && IsA(sostmt, SetOperationStmt));
+       qry->setOperations = (Node *) sostmt;
 
        /*
         * Re-find leftmost SELECT (now it's a sub-query in rangetable)
         */
-       node = stmt->larg;
+       node = sostmt->larg;
        while (node && IsA(node, SetOperationStmt))
                node = ((SetOperationStmt *) node)->larg;
        Assert(node && IsA(node, RangeTblRef));
@@ -1858,7 +1865,7 @@ transformSetOperationStmt(ParseState *pstate, SetOperationStmt *stmt)
         */
        qry->targetList = NIL;
        lefttl = leftmostQuery->targetList;
-       foreach(dtlist, stmt->colTypes)
+       foreach(dtlist, sostmt->colTypes)
        {
                Oid             colType = (Oid) lfirsti(dtlist);
                char   *colName = ((TargetEntry *) lfirst(lefttl))->resdom->resname;
@@ -1953,11 +1960,47 @@ transformSetOperationStmt(ParseState *pstate, SetOperationStmt *stmt)
  *             Recursively transform leaves and internal nodes of a set-op tree
  */
 static Node *
-transformSetOperationTree(ParseState *pstate, Node *node)
+transformSetOperationTree(ParseState *pstate, SelectStmt *stmt)
 {
-       if (IsA(node, SelectStmt))
+       bool    isLeaf;
+
+       Assert(stmt && IsA(stmt, SelectStmt));
+
+       /*
+        * Validity-check both leaf and internal SELECTs for disallowed ops.
+        */
+       if (stmt->into)
+               elog(ERROR, "INTO is only allowed on first SELECT of UNION/INTERSECT/EXCEPT");
+       if (stmt->portalname)           /* should not happen */
+               elog(ERROR, "Portal may not appear in UNION/INTERSECT/EXCEPT");
+       /* We don't support forUpdate with set ops at the moment. */
+       if (stmt->forUpdate)
+               elog(ERROR, "SELECT FOR UPDATE is not allowed with UNION/INTERSECT/EXCEPT");
+
+       /*
+        * If an internal node of a set-op tree has ORDER BY, UPDATE, or LIMIT
+        * clauses attached, we need to treat it like a leaf node to generate
+        * an independent sub-Query tree.  Otherwise, it can be represented by
+        * a SetOperationStmt node underneath the parent Query.
+        */
+       if (stmt->op == SETOP_NONE)
        {
-               SelectStmt *stmt = (SelectStmt *) node;
+               Assert(stmt->larg == NULL && stmt->rarg == NULL);
+               isLeaf = true;
+       }
+       else
+       {
+               Assert(stmt->larg != NULL && stmt->rarg != NULL);
+               if (stmt->sortClause || stmt->limitOffset || stmt->limitCount ||
+                       stmt->forUpdate)
+                       isLeaf = true;
+               else
+                       isLeaf = false;
+       }
+
+       if (isLeaf)
+       {
+               /* Process leaf SELECT */
                List   *save_rtable;
                List   *selectList;
                Query  *selectQuery;
@@ -1965,20 +2008,6 @@ transformSetOperationTree(ParseState *pstate, Node *node)
                RangeTblEntry *rte;
                RangeTblRef *rtr;
 
-               /*
-                * Validity-check leaf SELECTs for disallowed ops.  INTO check is
-                * necessary, the others should have been disallowed by grammar.
-                */
-               if (stmt->into)
-                       elog(ERROR, "INTO is only allowed on first SELECT of UNION/INTERSECT/EXCEPT");
-               if (stmt->portalname)
-                       elog(ERROR, "Portal is only allowed on first SELECT of UNION/INTERSECT/EXCEPT");
-               if (stmt->sortClause)
-                       elog(ERROR, "ORDER BY is only allowed at end of UNION/INTERSECT/EXCEPT");
-               if (stmt->limitOffset || stmt->limitCount)
-                       elog(ERROR, "LIMIT is only allowed at end of UNION/INTERSECT/EXCEPT");
-               if (stmt->forUpdate)
-                       elog(ERROR, "FOR UPDATE is only allowed at end of UNION/INTERSECT/EXCEPT");
                /*
                 * Transform SelectStmt into a Query.  We do not want any previously
                 * transformed leaf queries to be visible in the outer context of
@@ -2011,21 +2040,26 @@ transformSetOperationTree(ParseState *pstate, Node *node)
                Assert(rte == rt_fetch(rtr->rtindex, pstate->p_rtable));
                return (Node *) rtr;
        }
-       else if (IsA(node, SetOperationStmt))
+       else
        {
-               SetOperationStmt *op = (SetOperationStmt *) node;
+               /* Process an internal node (set operation node) */
+               SetOperationStmt *op = makeNode(SetOperationStmt);
                List   *lcoltypes;
                List   *rcoltypes;
                const char *context;
 
-               context = (op->op == SETOP_UNION ? "UNION" :
-                                  (op->op == SETOP_INTERSECT ? "INTERSECT" :
+               context = (stmt->op == SETOP_UNION ? "UNION" :
+                                  (stmt->op == SETOP_INTERSECT ? "INTERSECT" :
                                        "EXCEPT"));
+
+               op->op = stmt->op;
+               op->all = stmt->all;
+
                /*
                 * Recursively transform the child nodes.
                 */
-               op->larg = transformSetOperationTree(pstate, op->larg);
-               op->rarg = transformSetOperationTree(pstate, op->rarg);
+               op->larg = transformSetOperationTree(pstate, stmt->larg);
+               op->rarg = transformSetOperationTree(pstate, stmt->rarg);
                /*
                 * Verify that the two children have the same number of non-junk
                 * columns, and determine the types of the merged output columns.
@@ -2048,14 +2082,9 @@ transformSetOperationTree(ParseState *pstate, Node *node)
                        lcoltypes = lnext(lcoltypes);
                        rcoltypes = lnext(rcoltypes);
                }
+
                return (Node *) op;
        }
-       else
-       {
-               elog(ERROR, "transformSetOperationTree: unexpected node %d",
-                        (int) nodeTag(node));
-               return NULL;                    /* keep compiler quiet */
-       }
 }
 
 /*
index f6859429f2ac5e9ec56b85c51a384aacc9ba411f..2fbfa853dd300663a4c211fcf8c638d0f796a90a 100644 (file)
@@ -11,7 +11,7 @@
  *
  *
  * IDENTIFICATION
- *       $Header: /cvsroot/pgsql/src/backend/parser/gram.y,v 2.203 2000/11/04 21:04:55 momjian Exp $
+ *       $Header: /cvsroot/pgsql/src/backend/parser/gram.y,v 2.204 2000/11/05 00:15:54 tgl Exp $
  *
  * HISTORY
  *       AUTHOR                        DATE                    MAJOR EVENT
@@ -80,7 +80,11 @@ static Node *makeA_Expr(int oper, char *opname, Node *lexpr, Node *rexpr);
 static Node *makeTypeCast(Node *arg, TypeName *typename);
 static Node *makeRowExpr(char *opr, List *largs, List *rargs);
 static void mapTargetColumns(List *source, List *target);
-static SelectStmt *findLeftmostSelect(Node *node);
+static SelectStmt *findLeftmostSelect(SelectStmt *node);
+static void insertSelectOptions(SelectStmt *stmt,
+                                                               List *sortClause, List *forUpdate,
+                                                               Node *limitOffset, Node *limitCount);
+static Node *makeSetOp(SetOperation op, bool all, Node *larg, Node *rarg);
 static bool exprIsNullConstant(Node *arg);
 static Node *doNegate(Node *n);
 static void doNegateFloat(Value *v);
@@ -134,7 +138,7 @@ static void doNegateFloat(Value *v);
                UnlistenStmt, UpdateStmt, VacuumStmt, VariableResetStmt,
                VariableSetStmt, VariableShowStmt, ViewStmt
 
-%type <node>   select_clause, select_subclause
+%type <node>   select_no_parens, select_clause, simple_select
 
 %type <list>   SessionList
 %type <node>   SessionClause
@@ -174,8 +178,8 @@ static void doNegateFloat(Value *v);
 %type <chr>            operation, TriggerOneEvent
 
 %type <list>   stmtblock, stmtmulti,
-               result, OptTempTableName, relation_name_list, OptTableElementList,
-               OptUnder, OptInherit, definition, opt_distinct,
+               into_clause, OptTempTableName, relation_name_list,
+               OptTableElementList, OptUnder, OptInherit, definition, opt_distinct,
                opt_with, func_args, func_args_list, func_as,
                oper_argtypes, RuleActionList, RuleActionMulti,
                opt_column_list, columnList, opt_va_list, va_list,
@@ -183,13 +187,13 @@ static void doNegateFloat(Value *v);
                from_clause, from_list, opt_array_bounds,
                expr_list, attrs, target_list, update_target_list,
                def_list, opt_indirection, group_clause, TriggerFuncArgs,
-               opt_select_limit
+               select_limit, opt_select_limit
 
 %type <typnam> func_arg, func_return, aggr_argtype
 
 %type <boolean>        opt_arg, TriggerForOpt, TriggerForType, OptTemp
 
-%type <list>   for_update_clause, update_list
+%type <list>   for_update_clause, opt_for_update_clause, update_list
 %type <boolean>        opt_all
 %type <boolean>        opt_table
 %type <boolean>        opt_chain, opt_trans
@@ -385,6 +389,7 @@ static void doNegateFloat(Value *v);
 %right         UMINUS
 %left          '.'
 %left          '[' ']'
+%left          '(' ')'
 %left          TYPECAST
 %%
 
@@ -444,6 +449,7 @@ stmt :      AlterSchemaStmt
                | ListenStmt
                | UnlistenStmt
                | LockStmt
+               | NotifyStmt
                | ProcedureStmt
                | ReindexStmt
                | RemoveAggrStmt
@@ -1527,7 +1533,14 @@ OptInherit:  INHERITS '(' relation_name_list ')'         { $$ = $3; }
 
 CreateAsStmt:  CREATE OptTemp TABLE relation_name OptUnder OptCreateAs AS SelectStmt
                                {
-                                       SelectStmt *n = findLeftmostSelect($8);
+                                       /*
+                                        * When the SelectStmt is a set-operation tree, we must
+                                        * stuff the INTO information into the leftmost component
+                                        * Select, because that's where analyze.c will expect
+                                        * to find it.  Similarly, the output column names must
+                                        * be attached to that Select's target list.
+                                        */
+                                       SelectStmt *n = findLeftmostSelect((SelectStmt *) $8);
                                        if (n->into != NULL)
                                                elog(ERROR,"CREATE TABLE/AS SELECT may not specify INTO");
                                        n->istemp = $2;
@@ -1541,7 +1554,7 @@ CreateAsStmt:  CREATE OptTemp TABLE relation_name OptUnder OptCreateAs AS Select
                ;
 
 OptCreateAs:  '(' CreateAsList ')'                             { $$ = $2; }
-                       | /*EMPTY*/                                                     { $$ = NULL; }
+                       | /*EMPTY*/                                                     { $$ = NIL; }
                ;
 
 CreateAsList:  CreateAsList ',' CreateAsElement        { $$ = lappend($1, $3); }
@@ -2682,7 +2695,6 @@ RuleStmt:  CREATE RULE name AS
                ;
 
 RuleActionList:  NOTHING                               { $$ = NIL; }
-               | SelectStmt                                    { $$ = makeList1($1); }
                | RuleActionStmt                                { $$ = makeList1($1); }
                | '[' RuleActionMulti ']'               { $$ = $2; }
                | '(' RuleActionMulti ')'               { $$ = $2; } 
@@ -2703,7 +2715,17 @@ RuleActionMulti:  RuleActionMulti ';' RuleActionStmtOrEmpty
                                }
                ;
 
-RuleActionStmt:        InsertStmt
+/*
+ * Allowing RuleActionStmt to be a SelectStmt creates an ambiguity:
+ * is the RuleActionList "((SELECT foo))" a standalone RuleActionStmt,
+ * or a one-entry RuleActionMulti list?  We don't really care, but yacc
+ * wants to know.  We use operator precedence to resolve the ambiguity:
+ * giving this rule a higher precedence than ')' will force a reduce
+ * rather than shift decision, causing the one-entry-list interpretation
+ * to be chosen.
+ */
+RuleActionStmt:        SelectStmt                              %prec TYPECAST
+               | InsertStmt
                | UpdateStmt
                | DeleteStmt
                | NotifyStmt
@@ -3070,7 +3092,6 @@ OptimizableStmt:  SelectStmt
                | CursorStmt
                | UpdateStmt
                | InsertStmt
-               | NotifyStmt
                | DeleteStmt                                    /* by default all are $$=$1 */
                ;
 
@@ -3225,7 +3246,7 @@ UpdateStmt:  UPDATE opt_only relation_name
  *****************************************************************************/
 CursorStmt:  DECLARE name opt_cursor CURSOR FOR SelectStmt
                                {
-                                       SelectStmt *n = findLeftmostSelect($6);
+                                       SelectStmt *n = (SelectStmt *)$6;
                                        n->portalname = $2;
                                        n->binary = $3;
                                        $$ = $6;
@@ -3246,55 +3267,99 @@ opt_cursor:  BINARY                                             { $$ = TRUE; }
  *
  *****************************************************************************/
 
-/* A complete SELECT statement looks like this.  Note sort, for_update,
- * and limit clauses can only appear once, not in each set operation.
- * 
- * The rule returns either a SelectStmt node or a SetOperationStmt tree.
- * One-time clauses are attached to the leftmost SelectStmt leaf.
- *
- * NOTE: only the leftmost SelectStmt leaf should have INTO, either.
- * However, this is not checked by the grammar; parse analysis must check it.
+/* A complete SELECT statement looks like this.
+ *
+ * The rule returns either a single SelectStmt node or a tree of them,
+ * representing a set-operation tree.
+ *
+ * To avoid ambiguity problems with nested parentheses, we have to define
+ * a "select_no_parens" nonterminal in which there are no parentheses
+ * at the outermost level.  This is used in the production
+ *             c_expr: '(' select_no_parens ')'
+ * This gives a unique parsing of constructs where a subselect is nested
+ * in an expression with extra parentheses: the parentheses are not part
+ * of the subselect but of the outer expression.  yacc is not quite bright
+ * enough to handle the situation completely, however.  To prevent a shift/
+ * reduce conflict, we also have to attach a precedence to the
+ *             SelectStmt: select_no_parens
+ * rule that is higher than the precedence of ')'.  This means that when
+ * "((SELECT foo" has been parsed in an expression context, and the
+ * next token is ')', the parser will follow the '(' SelectStmt ')' reduction
+ * path rather than '(' select_no_parens ')'.  The upshot is that excess
+ * parens don't work in this context: SELECT ((SELECT foo)) will give a
+ * parse error, whereas SELECT ((SELECT foo) UNION (SELECT bar)) is OK.
+ * This is ugly, but it beats not allowing excess parens anywhere...
+ *
+ * In all other contexts, we can use SelectStmt which allows outer parens.
  */
 
-SelectStmt:      select_clause sort_clause for_update_clause opt_select_limit
+SelectStmt: select_no_parens                   %prec TYPECAST
                        {
-                               SelectStmt *n = findLeftmostSelect($1);
+                               $$ = $1;
+                       }
+               | '(' SelectStmt ')'
+                       {
+                               $$ = $2;
+                       }
+               ;
 
-                               n->sortClause = $2;
-                               n->forUpdate = $3;
-                               n->limitOffset = nth(0, $4);
-                               n->limitCount = nth(1, $4);
+select_no_parens: simple_select
+                       {
+                               $$ = $1;
+                       }
+               | select_clause sort_clause opt_for_update_clause opt_select_limit
+                       {
+                               insertSelectOptions((SelectStmt *) $1, $2, $3,
+                                                                       nth(0, $4), nth(1, $4));
+                               $$ = $1;
+                       }
+               | select_clause for_update_clause opt_select_limit
+                       {
+                               insertSelectOptions((SelectStmt *) $1, NIL, $2,
+                                                                       nth(0, $3), nth(1, $3));
+                               $$ = $1;
+                       }
+               | select_clause select_limit
+                       {
+                               insertSelectOptions((SelectStmt *) $1, NIL, NIL,
+                                                                       nth(0, $2), nth(1, $2));
                                $$ = $1;
                        }
                ;
 
-/* This rule parses Select statements that can appear within set operations,
- * including UNION, INTERSECT and EXCEPT.  '(' and ')' can be used to specify
- * the ordering of the set operations.  Without '(' and ')' we want the
- * operations to be ordered per the precedence specs at the head of this file.
- *
- * Since parentheses around SELECTs also appear in the expression grammar,
- * there is a parse ambiguity if parentheses are allowed at the top level of a
- * select_clause: are the parens part of the expression or part of the select?
- * We separate select_clause into two levels to resolve this: select_clause
- * can have top-level parentheses, select_subclause cannot.
- *
- * Note that sort clauses cannot be included at this level --- a sort clause
- * can only appear at the end of the complete Select, and it will be handled
- * by the topmost SelectStmt rule.  Likewise FOR UPDATE and LIMIT.
- */
-select_clause: '(' select_subclause ')'
+select_clause: simple_select
                        {
-                               $$ = $2; 
+                               $$ = $1;
                        }
-               | select_subclause
+               | '(' SelectStmt ')'
                        {
-                               $$ = $1; 
+                               $$ = $2;
                        }
                ;
 
-select_subclause: SELECT opt_distinct target_list
-                        result from_clause where_clause
+/*
+ * This rule parses SELECT statements that can appear within set operations,
+ * including UNION, INTERSECT and EXCEPT.  '(' and ')' can be used to specify
+ * the ordering of the set operations.  Without '(' and ')' we want the
+ * operations to be ordered per the precedence specs at the head of this file.
+ *
+ * As with select_no_parens, simple_select cannot have outer parentheses,
+ * but can have parenthesized subclauses.
+ *
+ * Note that sort clauses cannot be included at this level --- SQL92 requires
+ *             SELECT foo UNION SELECT bar ORDER BY baz
+ * to be parsed as
+ *             (SELECT foo UNION SELECT bar) ORDER BY baz
+ * not
+ *             SELECT foo UNION (SELECT bar ORDER BY baz)
+ * Likewise FOR UPDATE and LIMIT.  This does not limit functionality,
+ * because you can reintroduce sort and limit clauses inside parentheses.
+ *
+ * NOTE: only the leftmost component SelectStmt should have INTO.
+ * However, this is not checked by the grammar; parse analysis must check it.
+ */
+simple_select: SELECT opt_distinct target_list
+                        into_clause from_clause where_clause
                         group_clause having_clause
                                {
                                        SelectStmt *n = makeNode(SelectStmt);
@@ -3310,35 +3375,20 @@ select_subclause: SELECT opt_distinct target_list
                                }
                | select_clause UNION opt_all select_clause
                        {       
-                               SetOperationStmt *n = makeNode(SetOperationStmt);
-                               n->op = SETOP_UNION;
-                               n->all = $3;
-                               n->larg = $1;
-                               n->rarg = $4;
-                               $$ = (Node *) n;
+                               $$ = makeSetOp(SETOP_UNION, $3, $1, $4);
                        }
                | select_clause INTERSECT opt_all select_clause
                        {
-                               SetOperationStmt *n = makeNode(SetOperationStmt);
-                               n->op = SETOP_INTERSECT;
-                               n->all = $3;
-                               n->larg = $1;
-                               n->rarg = $4;
-                               $$ = (Node *) n;
+                               $$ = makeSetOp(SETOP_INTERSECT, $3, $1, $4);
                        }
                | select_clause EXCEPT opt_all select_clause
                        {
-                               SetOperationStmt *n = makeNode(SetOperationStmt);
-                               n->op = SETOP_EXCEPT;
-                               n->all = $3;
-                               n->larg = $1;
-                               n->rarg = $4;
-                               $$ = (Node *) n;
+                               $$ = makeSetOp(SETOP_EXCEPT, $3, $1, $4);
                        }
                ; 
 
                /* easy way to return two values. Can someone improve this?  bjm */
-result:  INTO OptTempTableName                 { $$ = $2; }
+into_clause:  INTO OptTempTableName            { $$ = $2; }
                | /*EMPTY*/                                             { $$ = lcons(makeInteger(FALSE), NIL); }
                ;
 
@@ -3391,7 +3441,6 @@ opt_distinct:  DISTINCT                                                   { $$ = makeList1(NIL); }
                ;
 
 sort_clause:  ORDER BY sortby_list                             { $$ = $3; }
-               | /*EMPTY*/                                                             { $$ = NIL; }
                ;
 
 sortby_list:  sortby                                                   { $$ = makeList1($1); }
@@ -3413,7 +3462,7 @@ OptUseOp:  USING all_Op                                                   { $$ = $2; }
                ;
 
 
-opt_select_limit:      LIMIT select_limit_value ',' select_offset_value
+select_limit:  LIMIT select_limit_value ',' select_offset_value
                        { $$ = makeList2($4, $2); }
                | LIMIT select_limit_value OFFSET select_offset_value
                        { $$ = makeList2($4, $2); }
@@ -3423,20 +3472,22 @@ opt_select_limit:       LIMIT select_limit_value ',' select_offset_value
                        { $$ = makeList2($2, $4); }
                | OFFSET select_offset_value
                        { $$ = makeList2($2, NULL); }
-               | /* EMPTY */
-                       { $$ = makeList2(NULL, NULL); }
+               ;
+
+opt_select_limit:      select_limit                            { $$ = $1; }
+               | /* EMPTY */                                                   { $$ = makeList2(NULL,NULL); }
                ;
 
 select_limit_value:  Iconst
                        {
                                Const   *n = makeNode(Const);
 
-                               if ($1 < 1)
-                                       elog(ERROR, "Selection limit must be ALL or a positive integer value");
+                               if ($1 < 0)
+                                       elog(ERROR, "LIMIT must not be negative");
 
                                n->consttype    = INT4OID;
                                n->constlen             = sizeof(int4);
-                               n->constvalue   = (Datum)$1;
+                               n->constvalue   = Int32GetDatum($1);
                                n->constisnull  = FALSE;
                                n->constbyval   = TRUE;
                                n->constisset   = FALSE;
@@ -3445,12 +3496,13 @@ select_limit_value:  Iconst
                        }
                | ALL
                        {
+                               /* LIMIT ALL is represented as a NULL constant */
                                Const   *n = makeNode(Const);
 
                                n->consttype    = INT4OID;
                                n->constlen             = sizeof(int4);
-                               n->constvalue   = (Datum)0;
-                               n->constisnull  = FALSE;
+                               n->constvalue   = (Datum) 0;
+                               n->constisnull  = TRUE;
                                n->constbyval   = TRUE;
                                n->constisset   = FALSE;
                                n->constiscast  = FALSE;
@@ -3471,9 +3523,12 @@ select_offset_value:     Iconst
                        {
                                Const   *n = makeNode(Const);
 
+                               if ($1 < 0)
+                                       elog(ERROR, "OFFSET must not be negative");
+
                                n->consttype    = INT4OID;
                                n->constlen             = sizeof(int4);
-                               n->constvalue   = (Datum)$1;
+                               n->constvalue   = Int32GetDatum($1);
                                n->constisnull  = FALSE;
                                n->constbyval   = TRUE;
                                n->constisset   = FALSE;
@@ -3490,6 +3545,7 @@ select_offset_value:      Iconst
                                $$ = (Node *)n;
                        }
                ;
+
 /*
  *     jimmy bell-style recursive queries aren't supported in the
  *     current system.
@@ -3522,6 +3578,9 @@ having_clause:  HAVING a_expr
 
 for_update_clause:  FOR UPDATE update_list             { $$ = $3; }
                | FOR READ ONLY                                                 { $$ = NULL; }
+               ;
+
+opt_for_update_clause: for_update_clause               { $$ = $1; }
                | /* EMPTY */                                                   { $$ = NULL; }
                ;
 
@@ -3565,7 +3624,7 @@ table_ref:  relation_expr
                                        $1->name = $2;
                                        $$ = (Node *) $1;
                                }
-               | '(' select_subclause ')' alias_clause
+               | '(' SelectStmt ')' alias_clause
                                {
                                        RangeSubselect *n = makeNode(RangeSubselect);
                                        n->subquery = $2;
@@ -4101,7 +4160,7 @@ opt_interval:  datetime                                                   { $$ = makeList1($1); }
  * Define row_descriptor to allow yacc to break the reduce/reduce conflict
  *  with singleton expressions.
  */
-row_expr: '(' row_descriptor ')' IN '(' select_subclause ')'
+row_expr: '(' row_descriptor ')' IN '(' SelectStmt ')'
                                {
                                        SubLink *n = makeNode(SubLink);
                                        n->lefthand = $2;
@@ -4111,7 +4170,7 @@ row_expr: '(' row_descriptor ')' IN '(' select_subclause ')'
                                        n->subselect = $6;
                                        $$ = (Node *)n;
                                }
-               | '(' row_descriptor ')' NOT IN '(' select_subclause ')'
+               | '(' row_descriptor ')' NOT IN '(' SelectStmt ')'
                                {
                                        SubLink *n = makeNode(SubLink);
                                        n->lefthand = $2;
@@ -4121,7 +4180,7 @@ row_expr: '(' row_descriptor ')' IN '(' select_subclause ')'
                                        n->subselect = $7;
                                        $$ = (Node *)n;
                                }
-               | '(' row_descriptor ')' all_Op sub_type '(' select_subclause ')'
+               | '(' row_descriptor ')' all_Op sub_type '(' SelectStmt ')'
                                {
                                        SubLink *n = makeNode(SubLink);
                                        n->lefthand = $2;
@@ -4134,7 +4193,7 @@ row_expr: '(' row_descriptor ')' IN '(' select_subclause ')'
                                        n->subselect = $7;
                                        $$ = (Node *)n;
                                }
-               | '(' row_descriptor ')' all_Op '(' select_subclause ')'
+               | '(' row_descriptor ')' all_Op '(' SelectStmt ')'
                                {
                                        SubLink *n = makeNode(SubLink);
                                        n->lefthand = $2;
@@ -4458,7 +4517,7 @@ a_expr:  c_expr
                                                $$ = n;
                                        }
                                }
-               | a_expr all_Op sub_type '(' select_subclause ')'
+               | a_expr all_Op sub_type '(' SelectStmt ')'
                                {
                                        SubLink *n = makeNode(SubLink);
                                        n->lefthand = makeList1($1);
@@ -4851,7 +4910,7 @@ c_expr:  attr
                                        n->agg_distinct = FALSE;
                                        $$ = (Node *)n;
                                }
-               | '(' select_subclause ')'
+               | '(' select_no_parens ')'
                                {
                                        SubLink *n = makeNode(SubLink);
                                        n->lefthand = NIL;
@@ -4861,7 +4920,7 @@ c_expr:  attr
                                        n->subselect = $2;
                                        $$ = (Node *)n;
                                }
-               | EXISTS '(' select_subclause ')'
+               | EXISTS '(' SelectStmt ')'
                                {
                                        SubLink *n = makeNode(SubLink);
                                        n->lefthand = NIL;
@@ -4960,7 +5019,7 @@ trim_list:  a_expr FROM expr_list
                                { $$ = $1; }
                ;
 
-in_expr:  select_subclause
+in_expr:  SelectStmt
                                {
                                        SubLink *n = makeNode(SubLink);
                                        n->subselect = $1;
@@ -5688,20 +5747,71 @@ mapTargetColumns(List *src, List *dst)
                src = lnext(src);
                dst = lnext(dst);
        }
-       return;
 } /* mapTargetColumns() */
 
 
 /* findLeftmostSelect()
- *             Find the leftmost SelectStmt in a SetOperationStmt parsetree.
+ *             Find the leftmost component SelectStmt in a set-operation parsetree.
  */
 static SelectStmt *
-findLeftmostSelect(Node *node)
+findLeftmostSelect(SelectStmt *node)
 {
-       while (node && IsA(node, SetOperationStmt))
-               node = ((SetOperationStmt *) node)->larg;
-       Assert(node && IsA(node, SelectStmt));
-       return (SelectStmt *) node;
+       while (node && node->op != SETOP_NONE)
+               node = node->larg;
+       Assert(node && IsA(node, SelectStmt) && node->larg == NULL);
+       return node;
+}
+
+/* insertSelectOptions()
+ *             Insert ORDER BY, etc into an already-constructed SelectStmt.
+ *
+ * This routine is just to avoid duplicating code in SelectStmt productions.
+ */
+static void
+insertSelectOptions(SelectStmt *stmt,
+                                       List *sortClause, List *forUpdate,
+                                       Node *limitOffset, Node *limitCount)
+{
+       /*
+        * Tests here are to reject constructs like
+        *      (SELECT foo ORDER BY bar) ORDER BY baz
+        */
+       if (sortClause)
+       {
+               if (stmt->sortClause)
+                       elog(ERROR, "Multiple ORDER BY clauses not allowed");
+               stmt->sortClause = sortClause;
+       }
+       if (forUpdate)
+       {
+               if (stmt->forUpdate)
+                       elog(ERROR, "Multiple FOR UPDATE clauses not allowed");
+               stmt->forUpdate = forUpdate;
+       }
+       if (limitOffset)
+       {
+               if (stmt->limitOffset)
+                       elog(ERROR, "Multiple OFFSET clauses not allowed");
+               stmt->limitOffset = limitOffset;
+       }
+       if (limitCount)
+       {
+               if (stmt->limitCount)
+                       elog(ERROR, "Multiple LIMIT clauses not allowed");
+               stmt->limitCount = limitCount;
+       }
+}
+
+static Node *
+makeSetOp(SetOperation op, bool all, Node *larg, Node *rarg)
+{
+       SelectStmt *n = makeNode(SelectStmt);
+
+       n->op = op;
+       n->all = all;
+       n->larg = (SelectStmt *) larg;
+       n->rarg = (SelectStmt *) rarg;
+       return (Node *) n;
 }
 
 
index 70dfe9706bc34c6046a88ab39e7e35a69fb4ccde..cc25a5a026a84b9cc57956df9ed963b28da4f960 100644 (file)
@@ -3,7 +3,7 @@
  *                             back to source text
  *
  * IDENTIFICATION
- *       $Header: /cvsroot/pgsql/src/backend/utils/adt/ruleutils.c,v 1.67 2000/10/26 21:37:45 tgl Exp $
+ *       $Header: /cvsroot/pgsql/src/backend/utils/adt/ruleutils.c,v 1.68 2000/11/05 00:15:53 tgl Exp $
  *
  *       This software is copyrighted by Jan Wieck - Hamburg.
  *
@@ -941,7 +941,11 @@ get_select_query_def(Query *query, deparse_context *context)
        if (query->limitCount != NULL)
        {
                appendStringInfo(buf, " LIMIT ");
-               get_rule_expr(query->limitCount, context);
+               if (IsA(query->limitCount, Const) &&
+                       ((Const *) query->limitCount)->constisnull)
+                       appendStringInfo(buf, "ALL");
+               else
+                       get_rule_expr(query->limitCount, context);
        }
 }
 
index 3913d88ce91a4bdc54d1e89758c9027d5af0ab08..6ac6d0be4dad013ca1428ef4b527f6c553c9a347 100644 (file)
@@ -7,7 +7,7 @@
  * Portions Copyright (c) 1996-2000, PostgreSQL, Inc
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- * $Id: parsenodes.h,v 1.117 2000/10/18 16:16:10 momjian Exp $
+ * $Id: parsenodes.h,v 1.118 2000/11/05 00:15:53 tgl Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -782,7 +782,7 @@ typedef struct InsertStmt
        /*
         * An INSERT statement has *either* VALUES or SELECT, never both.
         * If VALUES, a targetList is supplied (empty for DEFAULT VALUES).
-        * If SELECT, a complete SelectStmt (or SetOperation tree) is supplied.
+        * If SELECT, a complete SelectStmt (or set-operation tree) is supplied.
         */
        List       *targetList;         /* the target list (of ResTarget) */
        Node       *selectStmt;         /* the source SELECT */
@@ -816,51 +816,71 @@ typedef struct UpdateStmt
 
 /* ----------------------
  *             Select Statement
+ *
+ * A "simple" SELECT is represented in the output of gram.y by a single
+ * SelectStmt node.  A SELECT construct containing set operators (UNION,
+ * INTERSECT, EXCEPT) is represented by a tree of SelectStmt nodes, in
+ * which the leaf nodes are component SELECTs and the internal nodes
+ * represent UNION, INTERSECT, or EXCEPT operators.  Using the same node
+ * type for both leaf and internal nodes allows gram.y to stick ORDER BY,
+ * LIMIT, etc, clause values into a SELECT statement without worrying
+ * whether it is a simple or compound SELECT.
  * ----------------------
  */
+typedef enum SetOperation
+{
+       SETOP_NONE = 0,
+       SETOP_UNION,
+       SETOP_INTERSECT,
+       SETOP_EXCEPT
+} SetOperation;
+
 typedef struct SelectStmt
 {
        NodeTag         type;
+       /*
+        * These fields are used only in "leaf" SelectStmts.
+        */
        List       *distinctClause; /* NULL, list of DISTINCT ON exprs, or
                                                                 * lcons(NIL,NIL) for all (SELECT
                                                                 * DISTINCT) */
        char       *into;                       /* name of table (for select into table) */
+       bool            istemp;                 /* into is a temp table? */
        List       *targetList;         /* the target list (of ResTarget) */
-       List       *fromClause;         /* the from clause */
-       Node       *whereClause;        /* qualifications */
+       List       *fromClause;         /* the FROM clause */
+       Node       *whereClause;        /* WHERE qualification */
        List       *groupClause;        /* GROUP BY clauses */
-       Node       *havingClause;       /* having conditional-expression */
+       Node       *havingClause;       /* HAVING conditional-expression */
+       /*
+        * These fields are used in both "leaf" SelectStmts and upper-level
+        * SelectStmts.  portalname/binary may only be set at the top level.
+        */
        List       *sortClause;         /* sort clause (a list of SortGroupBy's) */
        char       *portalname;         /* the portal (cursor) to create */
        bool            binary;                 /* a binary (internal) portal? */
-       bool            istemp;                 /* into is a temp table */
        Node       *limitOffset;        /* # of result tuples to skip */
        Node       *limitCount;         /* # of result tuples to return */
        List       *forUpdate;          /* FOR UPDATE clause */
+       /*
+        * These fields are used only in upper-level SelectStmts.
+        */
+       SetOperation op;                        /* type of set op */
+       bool            all;                    /* ALL specified? */
+       struct SelectStmt *larg;        /* left child */
+       struct SelectStmt *rarg;        /* right child */
+       /* Eventually add fields for CORRESPONDING spec here */
 } SelectStmt;
 
 /* ----------------------
- *             Select Statement with Set Operations
- *
- * UNION/INTERSECT/EXCEPT operations are represented in the output of gram.y
- * as a tree whose leaves are SelectStmts and internal nodes are
- * SetOperationStmts.  The statement-wide info (ORDER BY, etc clauses)
- * is placed in the leftmost SelectStmt leaf.
+ *             Set Operation node for post-analysis query trees
  *
- * After parse analysis, there is a top-level Query node containing the leaf
- * SELECTs as subqueries in its range table.  Its setOperations field is the
- * SetOperationStmt tree with leaf SelectStmt nodes replaced by RangeTblRef
- * nodes.  The statement-wide options such as ORDER BY are attached to this
- * top-level Query.
+ * After parse analysis, a SELECT with set operations is represented by a
+ * top-level Query node containing the leaf SELECTs as subqueries in its
+ * range table.  Its setOperations field shows the tree of set operations,
+ * with leaf SelectStmt nodes replaced by RangeTblRef nodes, and internal
+ * nodes replaced by SetOperationStmt nodes.
  * ----------------------
  */
-typedef enum SetOperation
-{
-       SETOP_UNION,
-       SETOP_INTERSECT,
-       SETOP_EXCEPT
-} SetOperation;
-
 typedef struct SetOperationStmt
 {
        NodeTag         type;
@@ -870,7 +890,7 @@ typedef struct SetOperationStmt
        Node       *rarg;                       /* right child */
        /* Eventually add fields for CORRESPONDING spec here */
 
-       /* This field is filled in during parse analysis: */
+       /* Fields derived during parse analysis: */
        List       *colTypes;           /* integer list of OIDs of output column types */
 } SetOperationStmt;