aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorEtsuro Fujita <efujita@postgresql.org>2023-09-21 19:45:00 +0900
committerEtsuro Fujita <efujita@postgresql.org>2023-09-21 19:45:00 +0900
commitc621467d2bc6435d07db4471998ca9c9f0c57777 (patch)
tree386734e7e854d94622d9ea07ee7c6372319e3687 /src
parent5cfba1ad69c6d43184645419476f6cc62e5dd3c5 (diff)
downloadpostgresql-c621467d2bc6435d07db4471998ca9c9f0c57777.tar.gz
postgresql-c621467d2bc6435d07db4471998ca9c9f0c57777.zip
Update comment about set_join_pathlist_hook().
The comment introduced by commit e7cb7ee14 was a bit too terse, which could lead to extensions doing different things within the hook function than we intend to allow. Extend the comment to explain what they can do within the hook function. Back-patch to all supported branches. In passing, I rephrased a nearby comment that I recently added to the back branches. Reviewed by David Rowley and Andrei Lepikhov. Discussion: https://postgr.es/m/CAPmGK15SBPA1nr3Aqsdm%2BYyS-ay0Ayo2BRYQ8_A2To9eLqwopQ%40mail.gmail.com
Diffstat (limited to 'src')
-rw-r--r--src/backend/optimizer/path/joinpath.c5
1 files changed, 4 insertions, 1 deletions
diff --git a/src/backend/optimizer/path/joinpath.c b/src/backend/optimizer/path/joinpath.c
index 821d282497b..b2916ad6901 100644
--- a/src/backend/optimizer/path/joinpath.c
+++ b/src/backend/optimizer/path/joinpath.c
@@ -333,7 +333,10 @@ add_paths_to_joinrel(PlannerInfo *root,
jointype, &extra);
/*
- * 6. Finally, give extensions a chance to manipulate the path list.
+ * 6. Finally, give extensions a chance to manipulate the path list. They
+ * could add new paths (such as CustomPaths) by calling add_path(), or
+ * add_partial_path() if parallel aware. They could also delete or modify
+ * paths added by the core code.
*/
if (set_join_pathlist_hook)
set_join_pathlist_hook(root, joinrel, outerrel, innerrel,