Add support for MERGE ... WHEN NOT MATCHED BY SOURCE.

Dean Rasheed <dean.a.rasheed@gmail.com>

Commit: 0294df2f1f842dfb0eed79007b21016f486a3c6c
Author: Dean Rasheed <dean.a.rasheed@gmail.com>
Date: 2024-03-30T10:00:26Z
Releases: 17.0
Add support for MERGE ... WHEN NOT MATCHED BY SOURCE.

This allows MERGE commands to include WHEN NOT MATCHED BY SOURCE
actions, which operate on rows that exist in the target relation, but
not in the data source. These actions can execute UPDATE, DELETE, or
DO NOTHING sub-commands.

This is in contrast to already-supported WHEN NOT MATCHED actions,
which operate on rows that exist in the data source, but not in the
target relation. To make this distinction clearer, such actions may
now be written as WHEN NOT MATCHED BY TARGET.

Writing WHEN NOT MATCHED without specifying BY SOURCE or BY TARGET is
equivalent to writing WHEN NOT MATCHED BY TARGET.

Dean Rasheed, reviewed by Alvaro Herrera, Ted Yu and Vik Fearing.

Discussion: https://postgr.es/m/CAEZATCWqnKGc57Y_JanUBHQXNKcXd7r=0R4NEZUVwP+syRkWbA@mail.gmail.com

Files

PathChange+/−
doc/src/sgml/mvcc.sgml modified +8 −4
doc/src/sgml/ref/merge.sgml modified +82 −18
src/backend/executor/execMain.c modified +4 −2
src/backend/executor/execPartition.c modified +15 −6
src/backend/executor/nodeModifyTable.c modified +236 −151
src/backend/nodes/nodeFuncs.c modified +3 −0
src/backend/optimizer/plan/createplan.c modified +6 −2
src/backend/optimizer/plan/planner.c modified +22 −0
src/backend/optimizer/plan/setrefs.c modified +18 −2
src/backend/optimizer/prep/prepjointree.c modified +42 −9
src/backend/optimizer/prep/preptlist.c modified +25 −1
src/backend/optimizer/util/pathnode.c modified +4 −1
src/backend/parser/gram.y modified +42 −20
src/backend/parser/parse_merge.c modified +32 −24
src/backend/utils/adt/ruleutils.c modified +39 −2
src/bin/psql/tab-complete.c modified +24 −6
src/include/catalog/catversion.h modified +1 −1
src/include/nodes/execnodes.h modified +12 −3
src/include/nodes/parsenodes.h modified +4 −3
src/include/nodes/pathnodes.h modified +2 −0
src/include/nodes/plannodes.h modified +2 −0
src/include/nodes/primnodes.h modified +9 −1
src/include/optimizer/pathnode.h modified +2 −1
src/include/parser/kwlist.h modified +2 −0
src/test/isolation/expected/merge-update.out modified +68 −20
src/test/isolation/specs/merge-update.spec modified +8 −2
src/test/regress/expected/merge.out modified +236 −63
src/test/regress/expected/rules.out modified +32 −0
src/test/regress/expected/updatable_views.out modified +90 −0
src/test/regress/sql/merge.sql modified +104 −18
src/test/regress/sql/rules.sql modified +19 −0
src/test/regress/sql/updatable_views.sql modified +32 −0
src/tools/pgindent/typedefs.list modified +1 −0

Documentation touched

Discussion