postgresql/src/backend/parser
Michael Paquier bb45156f34 Show names of DEALLOCATE as constants in pg_stat_statements
This commit switches query jumbling so as prepared statement names are
treated as constants in DeallocateStmt.  A boolean field is added to
DeallocateStmt to make a distinction between ALL and named prepared
statements, as "name" was used to make this difference before, NULL
meaning DEALLOCATE ALL.

Prior to this commit, DEALLOCATE was not tracked in pg_stat_statements,
for the reason that it was not possible to treat its name parameter as a
constant.  Now that query jumbling applies to all the utility nodes,
this reason does not apply anymore.

Like 638d42a3c5, this can be a huge advantage for monitoring where
prepared statement names are randomly generated, preventing bloat in
pg_stat_statements.  A couple of tests are added to track the new
behavior.

Author: Dagfinn Ilmari Mannsåker, Michael Paquier
Reviewed-by: Julien Rouhaud
Discussion: https://postgr.es/m/ZMhT9kNtJJsHw6jK@paquier.xyz
2023-08-27 17:27:44 +09:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
Makefile Revert SQL/JSON features 2022-09-01 17:07:14 -04:00
README Remove outdated reference to a removed file 2023-06-15 22:35:42 +09:00
analyze.c Avoid unnecessary plancache revalidation of utility statements. 2023-08-24 12:02:46 -04:00
check_keywords.pl Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
gram.y Show names of DEALLOCATE as constants in pg_stat_statements 2023-08-27 17:27:44 +09:00
gramparse.h Update copyright for 2023 2023-01-02 15:00:37 -05:00
meson.build Update copyright for 2023 2023-01-02 15:00:37 -05:00
parse_agg.c Fix failure to detect some cases of improperly-nested aggregates. 2023-03-13 12:40:28 -04:00
parse_clause.c Add missing initializations of p_perminfo 2023-07-14 14:56:35 +09:00
parse_coerce.c Make Vars be outer-join-aware. 2023-01-30 13:16:20 -05:00
parse_collate.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
parse_cte.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
parse_enr.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
parse_expr.c Fix translation markers 2023-08-24 10:25:51 +02:00
parse_func.c Add SysCacheGetAttrNotNull for guaranteed not-null attrs 2023-03-25 22:49:33 +01:00
parse_merge.c Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
parse_node.c Allow underscores in integer and numeric constants. 2023-02-04 09:48:51 +00:00
parse_oper.c Remove useless casts to (void *) in hash_search() calls 2023-02-06 09:41:01 +01:00
parse_param.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
parse_relation.c Add missing initializations of p_perminfo 2023-07-14 14:56:35 +09:00
parse_target.c Add more SQL/JSON constructor functions 2023-07-26 17:08:33 +09:00
parse_type.c Handle \v as a whitespace character in parsers 2023-07-06 08:16:24 +09:00
parse_utilcmd.c Catalog not-null constraints 2023-08-25 13:31:24 +02:00
parser.c Code review for recent SQL/JSON commits 2023-04-04 14:04:30 +02:00
scan.l Handle \v as a whitespace character in parsers 2023-07-06 08:16:24 +09:00
scansup.c Handle \v as a whitespace character in parsers 2023-07-06 08:16:24 +09: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.