postgresql/src/backend/parser
Tom Lane 19e972d558 Rethink node-level representation of partial-aggregation modes.
The original coding had three separate booleans representing partial
aggregation behavior, which was confusing, unreadable, and error-prone,
not least because the booleans weren't always listed in the same order.
It was also inadequate for the allegedly-desirable future extension to
support intermediate partial aggregation, because we'd need separate
markers for serialization and deserialization in such a case.

Merge these bools into an enum "AggSplit" to provide symbolic names for
the supported operating modes (and document what those are).  By assigning
the values of the enum constants carefully, we can treat AggSplit values
as options bitmasks so that tests of what to do aren't noticeably more
expensive than before.

While at it, get rid of Aggref.aggoutputtype.  That's not needed since
commit 59a3795c2 got rid of setrefs.c's special-purpose Aggref comparison
code, and it likewise seemed more confusing than helpful.

Assorted comment cleanup as well (there's still more that I want to do
in that line).

catversion bump for change in Aggref node contents.  Should be the last
one for partial-aggregation changes.

Discussion: <29309.1466699160@sss.pgh.pa.us>
2016-06-26 14:33:38 -04:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
Makefile Move keywords.c/kwlookup.c into src/common/. 2016-03-23 20:22:08 -04:00
README Move keywords.c/kwlookup.c into src/common/. 2016-03-23 20:22:08 -04:00
analyze.c Add support for more extensive testing of raw_expression_tree_walker(). 2016-05-23 19:08:26 -04:00
check_keywords.pl Update copyright for 2016 2016-01-02 13:33:40 -05:00
gram.y Add VACUUM (DISABLE_PAGE_SKIPPING) for emergencies. 2016-06-17 15:48:57 -04:00
parse_agg.c Fix type-safety problem with parallel aggregate serial/deserialization. 2016-06-22 16:52:41 -04:00
parse_clause.c Run pgindent on a batch of (mostly-planner-related) source files. 2016-04-06 11:34:02 -04:00
parse_coerce.c Add defenses against putting expanded objects into Const nodes. 2016-01-21 12:56:08 -05:00
parse_collate.c Update copyright for 2016 2016-01-02 13:33:40 -05:00
parse_cte.c Update copyright for 2016 2016-01-02 13:33:40 -05:00
parse_expr.c Fix unexpected side-effects of operator_precedence_warning. 2016-04-21 23:17:36 -04:00
parse_func.c Rethink node-level representation of partial-aggregation modes. 2016-06-26 14:33:38 -04:00
parse_node.c Update copyright for 2016 2016-01-02 13:33:40 -05:00
parse_oper.c Update copyright for 2016 2016-01-02 13:33:40 -05:00
parse_param.c Update copyright for 2016 2016-01-02 13:33:40 -05:00
parse_relation.c pgindent run for 9.6 2016-06-09 18:02:36 -04:00
parse_target.c Revert CREATE INDEX ... INCLUDING ... 2016-04-08 21:52:13 +03:00
parse_type.c Add defenses against putting expanded objects into Const nodes. 2016-01-21 12:56:08 -05:00
parse_utilcmd.c pgindent run for 9.6 2016-06-09 18:02:36 -04:00
parser.c Update copyright for 2016 2016-01-02 13:33:40 -05:00
scan.l Update comment about allowing GUCs to change scanning. 2016-06-21 20:23:31 -04:00
scansup.c Introduce parse_ident() 2016-03-18 18:16:14 +03:00

README

src/backend/parser/README

Parser
======

This directory does more than tokenize and parse SQL queries.  It also
creates Query structures for the various complex queries that are passed
to the optimizer and then executor.

parser.c	things start here
scan.l		break query into tokens
scansup.c	handle escapes in input strings
gram.y		parse the tokens and produce a "raw" parse tree
analyze.c	top level of parse analysis for optimizable queries
parse_agg.c	handle aggregates, like SUM(col1),  AVG(col2), ...
parse_clause.c	handle clauses like WHERE, ORDER BY, GROUP BY, ...
parse_coerce.c	handle coercing expressions to different data types
parse_collate.c	assign collation information in completed expressions
parse_cte.c	handle Common Table Expressions (WITH clauses)
parse_expr.c	handle expressions like col, col + 3, x = 3 or x = 4
parse_func.c	handle functions, table.column and column identifiers
parse_node.c	create nodes for various structures
parse_oper.c	handle operators in expressions
parse_param.c	handle Params (for the cases used in the core backend)
parse_relation.c support routines for tables and column handling
parse_target.c	handle the result list of the query
parse_type.c	support routines for data type handling
parse_utilcmd.c	parse analysis for utility commands (done at execution time)

See also src/common/keywords.c, which contains the table of standard
keywords and the keyword lookup function.  We separated that out because
various frontend code wants to use it too.