postgresql/src/backend/parser
Tom Lane 46b773d4fe Improve documentation about CREATE TABLE ... LIKE.
The docs failed to explain that LIKE INCLUDING INDEXES would not preserve
the names of indexes and associated constraints.  Also, it wasn't mentioned
that EXCLUDE constraints would be copied by this option.  The latter
oversight seems enough of a documentation bug to justify back-patching.

In passing, do some minor copy-editing in the same area, and add an entry
for LIKE under "Compatibility", since it's not exactly a faithful
implementation of the standard's feature.

Discussion: <20160728151154.AABE64016B@smtp.hushmail.com>
2016-07-28 13:26:58 -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 Improve documentation about CREATE TABLE ... LIKE. 2016-07-28 13:26:58 -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.