postgresql/src/backend/parser
Tom Lane 608b167f9f Allow user control of CTE materialization, and change the default behavior.
Historically we've always materialized the full output of a CTE query,
treating WITH as an optimization fence (so that, for example, restrictions
from the outer query cannot be pushed into it).  This is appropriate when
the CTE query is INSERT/UPDATE/DELETE, or is recursive; but when the CTE
query is non-recursive and side-effect-free, there's no hazard of changing
the query results by pushing restrictions down.

Another argument for materialization is that it can avoid duplicate
computation of an expensive WITH query --- but that only applies if
the WITH query is called more than once in the outer query.  Even then
it could still be a net loss, if each call has restrictions that
would allow just a small part of the WITH query to be computed.

Hence, let's change the behavior for WITH queries that are non-recursive
and side-effect-free.  By default, we will inline them into the outer
query (removing the optimization fence) if they are called just once.
If they are called more than once, we will keep the old behavior by
default, but the user can override this and force inlining by specifying
NOT MATERIALIZED.  Lastly, the user can force the old behavior by
specifying MATERIALIZED; this would mainly be useful when the query had
deliberately been employing WITH as an optimization fence to prevent a
poor choice of plan.

Andreas Karlsson, Andrew Gierth, David Fetter

Discussion: https://postgr.es/m/87sh48ffhb.fsf@news-spur.riddles.org.uk
2019-02-16 16:11:12 -05:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
analyze.c Add collation assignment to CALL statement 2019-02-07 08:25:47 +01:00
check_keywords.pl Update copyright for 2019 2019-01-02 12:44:25 -05:00
gram.y Allow user control of CTE materialization, and change the default behavior. 2019-02-16 16:11:12 -05:00
Makefile Revert MERGE patch 2018-04-12 11:22:56 +01:00
parse_agg.c Refactor planner's header files. 2019-01-29 15:48:51 -05:00
parse_clause.c Refactor planner's header files. 2019-01-29 15:48:51 -05:00
parse_coerce.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
parse_collate.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
parse_cte.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
parse_enr.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
parse_expr.c Renaming for new subscripting mechanism 2019-02-01 12:50:32 -03:00
parse_func.c Allow generalized expression syntax for partition bounds 2019-01-25 11:28:49 +01:00
parse_node.c Renaming for new subscripting mechanism 2019-02-01 12:50:32 -03:00
parse_oper.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
parse_param.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
parse_relation.c Allow RECORD and RECORD[] to be specified in function coldeflists. 2019-01-30 19:25:33 -05:00
parse_target.c Renaming for new subscripting mechanism 2019-02-01 12:50:32 -03:00
parse_type.c More unconstify use 2019-02-13 11:50:16 +01:00
parse_utilcmd.c Refactor planner's header files. 2019-01-29 15:48:51 -05:00
parser.c Replace the data structure used for keyword lookup. 2019-01-06 17:02:57 -05:00
README Move keywords.c/kwlookup.c into src/common/. 2016-03-23 20:22:08 -04:00
scan.l Replace the data structure used for keyword lookup. 2019-01-06 17:02:57 -05:00
scansup.c Update copyright for 2019 2019-01-02 12:44:25 -05:00

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.