postgresql/src/backend/parser
Alvaro Herrera fcec6caafa Support XMLTABLE query expression
XMLTABLE is defined by the SQL/XML standard as a feature that allows
turning XML-formatted data into relational form, so that it can be used
as a <table primary> in the FROM clause of a query.

This new construct provides significant simplicity and performance
benefit for XML data processing; what in a client-side custom
implementation was reported to take 20 minutes can be executed in 400ms
using XMLTABLE.  (The same functionality was said to take 10 seconds
using nested PostgreSQL XPath function calls, and 5 seconds using
XMLReader under PL/Python).

The implemented syntax deviates slightly from what the standard
requires.  First, the standard indicates that the PASSING clause is
optional and that multiple XML input documents may be given to it; we
make it mandatory and accept a single document only.  Second, we don't
currently support a default namespace to be specified.

This implementation relies on a new executor node based on a hardcoded
method table.  (Because the grammar is fixed, there is no extensibility
in the current approach; further constructs can be implemented on top of
this such as JSON_TABLE, but they require changes to core code.)

Author: Pavel Stehule, Álvaro Herrera
Extensively reviewed by: Craig Ringer
Discussion: https://postgr.es/m/CAFj8pRAgfzMD-LoSmnMGybD0WsEznLHWap8DO79+-GTRAPR4qA@mail.gmail.com
2017-03-08 12:40:26 -03:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
analyze.c Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
check_keywords.pl Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
gram.y Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
Makefile Suppress "unused variable" warnings with older versions of flex. 2017-02-19 13:04:30 -05:00
parse_agg.c Remove vestigial resolveUnknown arguments from transformSortClause etc. 2017-01-25 09:35:00 -05:00
parse_clause.c Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
parse_coerce.c Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
parse_collate.c Make more use of castNode() 2017-02-21 11:59:09 -05: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_expr.c Make more use of castNode() 2017-02-21 11:59:09 -05:00
parse_func.c Replace LookupFuncNameTypeNames() with LookupFuncWithArgs() 2017-03-06 13:31:47 -05:00
parse_node.c Make more use of castNode() 2017-02-21 11:59:09 -05:00
parse_oper.c Replace LookupFuncNameTypeNames() with LookupFuncWithArgs() 2017-03-06 13:31:47 -05:00
parse_param.c Update copyright via script for 2017 2017-01-03 13:48:53 -05:00
parse_relation.c Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
parse_target.c Support XMLTABLE query expression 2017-03-08 12:40:26 -03:00
parse_type.c Make more use of castNode() 2017-02-21 11:59:09 -05:00
parse_utilcmd.c Remove objname/objargs split for referring to objects 2017-03-06 13:31:47 -05: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.