postgresql/src/backend/parser
Richard Guo 8d829f5a02 Fix JSON_ARRAY(query) empty set handling and view deparsing
According to the SQL/JSON standard, JSON_ARRAY(query) must return an
empty JSON array ('[]') when the subquery returns zero rows.

Previously, the parser rewrote JSON_ARRAY(query) into a JSON_ARRAYAGG
aggregate function.  Because this aggregate evaluates to NULL over an
empty set without a GROUP BY clause, the constructor erroneously
returned NULL.  Additionally, this premature rewrite baked physical
implementation details into the catalog, preventing ruleutils.c from
deparsing the original syntax for views.

This patch resolves both issues by introducing a new
JSCTOR_JSON_ARRAY_QUERY constructor type.  The parser builds the
executable form --- a COALESCE-wrapped JSON_ARRAYAGG subquery --- from
raw parse nodes via transformExprRecurse, and stores it in the func
field.  The original transformed Query is kept in a new orig_query
field so that ruleutils.c can deparse the original syntax for views.
During planning, eval_const_expressions replaces the node with the
pre-built func expression.

The deparsing issue was reported by Tom Lane.

Bump catalog version.

Bug: #19418
Reported-by: Lukas Eder <lukas.eder@gmail.com>
Author: Richard Guo <guofenglinux@gmail.com>
Reviewed-by: Amit Langote <amitlangote09@gmail.com>
Discussion: https://postgr.es/m/19418-591ba1f29862ef5b@postgresql.org
2026-05-01 09:42:00 +09:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
analyze.c Fix UPDATE/DELETE ... WHERE CURRENT OF on a table with virtual columns. 2026-04-22 11:50:17 +01:00
check_keywords.pl Update copyright for 2026 2026-01-01 13:24:10 -05:00
gram.y Harmonize function parameter names for Postgres 19. 2026-04-22 12:47:19 -04:00
gramparse.h Update copyright for 2026 2026-01-01 13:24:10 -05:00
Makefile SQL Property Graph Queries (SQL/PGQ) 2026-03-16 10:14:18 +01:00
meson.build SQL Property Graph Queries (SQL/PGQ) 2026-03-16 10:14:18 +01:00
parse_agg.c Add UPDATE/DELETE FOR PORTION OF 2026-04-01 19:06:03 +02:00
parse_clause.c Fix collation of expressions in GRAPH_TABLE COLUMNS clause 2026-04-24 08:43:26 +02:00
parse_coerce.c Update copyright for 2026 2026-01-01 13:24:10 -05:00
parse_collate.c Add UPDATE/DELETE FOR PORTION OF 2026-04-01 19:06:03 +02:00
parse_cte.c Update copyright for 2026 2026-01-01 13:24:10 -05:00
parse_enr.c Update copyright for 2026 2026-01-01 13:24:10 -05:00
parse_expr.c Fix JSON_ARRAY(query) empty set handling and view deparsing 2026-05-01 09:42:00 +09:00
parse_func.c Add UPDATE/DELETE FOR PORTION OF 2026-04-01 19:06:03 +02:00
parse_graphtable.c Fix collation of expressions in GRAPH_TABLE COLUMNS clause 2026-04-24 08:43:26 +02:00
parse_jsontable.c Use fallthrough attribute instead of comment 2026-02-19 08:51:12 +01:00
parse_merge.c Add UPDATE/DELETE FOR PORTION OF 2026-04-01 19:06:03 +02:00
parse_node.c Update copyright for 2026 2026-01-01 13:24:10 -05:00
parse_oper.c Don't include storage/lock.h in so many headers 2026-03-24 17:11:12 +01:00
parse_param.c Update copyright for 2026 2026-01-01 13:24:10 -05:00
parse_relation.c SQL Property Graph Queries (SQL/PGQ) 2026-03-16 10:14:18 +01:00
parse_target.c SQL Property Graph Queries (SQL/PGQ) 2026-03-16 10:14:18 +01:00
parse_type.c Update copyright for 2026 2026-01-01 13:24:10 -05:00
parse_utilcmd.c Fix attnum remapping in generateClonedExtStatsStmt() 2026-04-30 11:04:57 -04:00
parser.c Update copyright for 2026 2026-01-01 13:24:10 -05:00
README Update parser README to include parse_jsontable.c 2025-09-08 10:07:14 +09:00
scan.l SQL Property Graph Queries (SQL/PGQ) 2026-03-16 10:14:18 +01:00
scansup.c Update copyright for 2026 2026-01-01 13:24:10 -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_enr.c	handle ephemeral named rels (trigger transition tables, ...)
parse_func.c	handle functions, table.column and column identifiers
parse_jsontable.c handle JSON_TABLE
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.