postgresql/src/backend/parser
Tom Lane d516974840 Support more object types within CREATE SCHEMA.
Having rejected the principle that we should know how to re-order
the sub-commands of CREATE SCHEMA, there is not really anything
except a little coding to stop us from supporting more object types.
This patch adds support for creating functions (including procedures
and aggregates), operators, types (including domains), collations,
and text search objects.

SQL:2021 specifies that we should allow functions, procedures,
types, domains, and collations, so this moves us a great deal
closer to full SQL compatibility of CREATE SCHEMA.  What remains
missing from their list are casts, transforms, roles, and some
object types we don't support yet (e.g. CREATE CHARACTER SET).
Supporting casts or transforms would be problematic because
they don't have names at all, let alone schema-qualified names,
so it'd be quite a stretch to say that they belong to a schema.
Roles likewise are not schema-qualified, plus they are global
to a cluster, making it even less reasonable to consider them
as belonging to a schema.  So I don't see us trying to complete
the list.

User-defined aggregates and operators are outside the spec's ken,
as are text search objects, so adding them does not do anything for
spec compatibility.  But they go along with these other object types,
plus it takes no additional code to support them since they are
represented as DefineStmts like some variants of CREATE TYPE.
It would indeed take some effort to reject them.

Author: Kirill Reshke <reshkekirill@gmail.com>
Author: Jian He <jian.universality@gmail.com>
Author: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/CALdSSPh4jUSDsWu3K58hjO60wnTRR0DuO4CKRcwa8EVuOSfXxg@mail.gmail.com
2026-04-06 15:16:25 -04:00
..
.gitignore Convert cvsignore to gitignore, and add .gitignore for build targets. 2010-09-22 12:57:04 +02:00
analyze.c Add UPDATE/DELETE FOR PORTION OF 2026-04-01 19:06:03 +02:00
check_keywords.pl Update copyright for 2026 2026-01-01 13:24:10 -05:00
gram.y Support more object types within CREATE SCHEMA. 2026-04-06 15:16:25 -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 SQL Property Graph Queries (SQL/PGQ) 2026-03-16 10:14:18 +01: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 Add UPDATE/DELETE FOR PORTION OF 2026-04-01 19:06:03 +02:00
parse_func.c Add UPDATE/DELETE FOR PORTION OF 2026-04-01 19:06:03 +02:00
parse_graphtable.c Fix cross variable references in graph pattern causing segfault 2026-03-31 11:47:19 +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 Support more object types within CREATE SCHEMA. 2026-04-06 15:16:25 -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.