planner_hook

Description

Hook for plugins to get control in planner()

Interface type

planner_hook_type

Header

src/include/optimizer/planner.h

Subsystem

Query planning

Initial value

NULL (no hook installed)

C interface

typedef PlannedStmt *(*planner_hook_type) (Query *parse, const char *query_string, int cursorOptions, ParamListInfo boundParams);
extern PGDLLIMPORT planner_hook_type planner_hook;

Call sites

src/backend/optimizer/plan/planner.c:316

Core call context: src/backend/optimizer/plan/planner.c:310–324

planner(Query *parse, const char *query_string, int cursorOptions,
		ParamListInfo boundParams)
{
	PlannedStmt *result;

	if (planner_hook)
		result = (*planner_hook) (parse, query_string, cursorOptions, boundParams);
	else
		result = standard_planner(parse, query_string, cursorOptions, boundParams);

	pgstat_report_plan_id(result->planId, false);

	return result;
}

Related entries

• The Planner/Optimizer

Documentation and source

• Interface declaration
• Core definition
• Call sites

Related entries

• create_upper_paths_hookcreate_upper_paths_hook
• get_relation_info_hookget_relation_info_hook
• join_search_hookjoin_search_hook
• set_join_pathlist_hookset_join_pathlist_hook
• set_rel_pathlist_hookset_rel_pathlist_hook