postgresql/src/backend/parser
Kevin Grittner 18ce3a4ab2 Add infrastructure to support EphemeralNamedRelation references.
A QueryEnvironment concept is added, which allows new types of
objects to be passed into queries from parsing on through
execution.  At this point, the only thing implemented is a
collection of EphemeralNamedRelation objects -- relations which
can be referenced by name in queries, but do not exist in the
catalogs.  The only type of ENR implemented is NamedTuplestore, but
provision is made to add more types fairly easily.

An ENR can carry its own TupleDesc or reference a relation in the
catalogs by relid.

Although these features can be used without SPI, convenience
functions are added to SPI so that ENRs can easily be used by code
run through SPI.

The initial use of all this is going to be transition tables in
AFTER triggers, but that will be added to each PL as a separate
commit.

An incidental effect of this patch is to produce a more informative
error message if an attempt is made to modify the contents of a CTE
from a referencing DML statement.  No tests previously covered that
possibility, so one is added.

Kevin Grittner and Thomas Munro
Reviewed by Heikki Linnakangas, David Fetter, and Thomas Munro
with valuable comments and suggestions from many others
2017-03-31 23:17:18 -05:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
analyze.c Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
check_keywords.pl Clean up Perl code according to perlcritic 2017-03-27 08:18:22 -04:00
gram.y Cast result of copyObject() to correct type 2017-03-28 21:59:23 -04:00
Makefile Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
parse_agg.c Remove vestigial resolveUnknown arguments from transformSortClause etc. 2017-01-25 09:35:00 -05:00
parse_clause.c Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
parse_coerce.c Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
parse_collate.c Spelling fixes in code comments 2017-03-14 12:58:39 -04:00
parse_cte.c Change unknown-type literals to type text in SELECT and RETURNING lists. 2017-01-25 09:17:24 -05:00
parse_enr.c Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
parse_expr.c Cast result of copyObject() to correct type 2017-03-28 21:59:23 -04:00
parse_func.c Allow referring to functions without arguments when unique 2017-03-14 23:55:19 -04:00
parse_node.c Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
parse_oper.c Replace LookupFuncNameTypeNames() with LookupFuncWithArgs() 2017-03-06 13:31:47 -05:00
parse_param.c Spelling fixes in code comments 2017-03-14 12:58:39 -04:00
parse_relation.c Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
parse_target.c Add infrastructure to support EphemeralNamedRelation references. 2017-03-31 23:17:18 -05:00
parse_type.c Make more use of castNode() 2017-02-21 11:59:09 -05:00
parse_utilcmd.c Cast result of copyObject() to correct type 2017-03-28 21:59:23 -04:00
parser.c Change representation of statement lists, and add statement location info. 2017-01-14 16:02:35 -05:00
README Move keywords.c/kwlookup.c into src/common/. 2016-03-23 20:22:08 -04:00
scan.l Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
scansup.c Update copyright via script for 2017 2017-01-03 13:48:53 -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.