postgresql/src/backend/parser
Amit Langote c0fc075186 SQL/JSON: Fix issues with DEFAULT .. ON ERROR / EMPTY
SQL/JSON query functions allow specifying an expression to return
when either of ON ERROR or ON EMPTY condition occurs when evaluating
the JSON path expression.  The parser (transformJsonBehavior()) checks
that the specified expression is one of the supported expressions, but
there are two issues with how the check is done that are fixed in this
commit:

* No check for some expressions related to coercion, such as
  CoerceViaIO, that may appear in the transformed user-specified
  expressions that include cast(s)

* An unsupported expression may be masked by a coercion-related
  expression, which must be flagged by checking the latter's
  argument expression recursively

Author: Jian He <jian.universality@gmail.com>
Author: Amit Langote <amitlangote09@gmail.com>
Reported-by: Jian He <jian.universality@gmail.com>
Discussion: https://postgr.es/m/CACJufxEqhqsfrg_p7EMyo5zak3d767iFDL8vz_4%3DZBHpOtrghw@mail.gmail.com
Discussion: https://postgr.es/m/CACJufxGOerH1QJknm1noh-Kz5FqU4p7QfeZSeVT2tN_4SLXYNg@mail.gmail.com
2024-04-18 14:46:35 +09:00
..
.gitignore
Makefile Add basic JSON_TABLE() functionality 2024-04-04 20:20:15 +09:00
README Remove outdated reference to a removed file 2023-06-15 22:35:42 +09:00
analyze.c Allow planner to use Merge Append to efficiently implement UNION 2024-03-25 14:31:14 +13:00
check_keywords.pl Update copyright for 2024 2024-01-03 20:49:05 -05:00
gram.y Fix ALTER DOMAIN NOT NULL syntax 2024-04-15 08:34:45 +02:00
gramparse.h Update copyright for 2024 2024-01-03 20:49:05 -05:00
meson.build Add basic JSON_TABLE() functionality 2024-04-04 20:20:15 +09:00
parse_agg.c Add RETURNING support to MERGE. 2024-03-17 13:58:59 +00:00
parse_clause.c Add basic JSON_TABLE() functionality 2024-04-04 20:20:15 +09:00
parse_coerce.c Update copyright for 2024 2024-01-03 20:49:05 -05:00
parse_collate.c Update copyright for 2024 2024-01-03 20:49:05 -05:00
parse_cte.c Add RETURNING support to MERGE. 2024-03-17 13:58:59 +00:00
parse_enr.c Update copyright for 2024 2024-01-03 20:49:05 -05:00
parse_expr.c SQL/JSON: Fix issues with DEFAULT .. ON ERROR / EMPTY 2024-04-18 14:46:35 +09:00
parse_func.c Add RETURNING support to MERGE. 2024-03-17 13:58:59 +00:00
parse_jsontable.c SQL/JSON: Improve some error messages 2024-04-18 14:45:48 +09:00
parse_merge.c Add support for MERGE ... WHEN NOT MATCHED BY SOURCE. 2024-03-30 10:00:26 +00:00
parse_node.c Remove unused #include's from backend .c files 2024-03-04 12:02:20 +01:00
parse_oper.c Update copyright for 2024 2024-01-03 20:49:05 -05:00
parse_param.c Update copyright for 2024 2024-01-03 20:49:05 -05:00
parse_relation.c Fix type-checking of RECORD-returning functions in FROM, redux. 2024-04-15 12:56:56 -04:00
parse_target.c Add basic JSON_TABLE() functionality 2024-04-04 20:20:15 +09:00
parse_type.c Add a const decoration 2024-01-25 13:34:49 +01:00
parse_utilcmd.c Grammar fixes for split/merge partitions code 2024-04-15 16:00:02 +03:00
parser.c Make the order of the header file includes consistent 2024-03-13 15:07:00 +01:00
scan.l Update copyright for 2024 2024-01-03 20:49:05 -05:00
scansup.c Update copyright for 2024 2024-01-03 20:49:05 -05: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_enr.c	handle ephemeral named rels (trigger transition tables, ...)
parse_func.c	handle functions, table.column and column identifiers
parse_merge.c	handle MERGE
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.