mirror of
https://git.postgresql.org/git/postgresql.git
synced 2026-02-21 22:07:01 +08:00
1722d5eb05
As pointed out by Tom Lane, the patch introduced fragile and invasive design around plan invalidation handling when locking of prunable partitions was deferred from plancache.c to the executor. In particular, it violated assumptions about CachedPlan immutability and altered executor APIs in ways that are difficult to justify given the added complexity and overhead. This also removes the firstResultRels field added to PlannedStmt in commit 28317de72, which was intended to support deferred locking of certain ModifyTable result relations. Reported-by: Tom Lane <tgl@sss.pgh.pa.us> Discussion: https://postgr.es/m/605328.1747710381@sss.pgh.pa.us
85 lines
3.2 KiB
C
85 lines
3.2 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* explain.h
|
|
* prototypes for explain.c
|
|
*
|
|
* Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994-5, Regents of the University of California
|
|
*
|
|
* src/include/commands/explain.h
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef EXPLAIN_H
|
|
#define EXPLAIN_H
|
|
|
|
#include "executor/executor.h"
|
|
#include "parser/parse_node.h"
|
|
|
|
struct ExplainState; /* defined in explain_state.h */
|
|
|
|
/* Hook for plugins to get control in ExplainOneQuery() */
|
|
typedef void (*ExplainOneQuery_hook_type) (Query *query,
|
|
int cursorOptions,
|
|
IntoClause *into,
|
|
struct ExplainState *es,
|
|
const char *queryString,
|
|
ParamListInfo params,
|
|
QueryEnvironment *queryEnv);
|
|
extern PGDLLIMPORT ExplainOneQuery_hook_type ExplainOneQuery_hook;
|
|
|
|
/* Hook for EXPLAIN plugins to print extra information for each plan */
|
|
typedef void (*explain_per_plan_hook_type) (PlannedStmt *plannedstmt,
|
|
IntoClause *into,
|
|
struct ExplainState *es,
|
|
const char *queryString,
|
|
ParamListInfo params,
|
|
QueryEnvironment *queryEnv);
|
|
extern PGDLLIMPORT explain_per_plan_hook_type explain_per_plan_hook;
|
|
|
|
/* Hook for EXPLAIN plugins to print extra fields on individual plan nodes */
|
|
typedef void (*explain_per_node_hook_type) (PlanState *planstate,
|
|
List *ancestors,
|
|
const char *relationship,
|
|
const char *plan_name,
|
|
struct ExplainState *es);
|
|
extern PGDLLIMPORT explain_per_node_hook_type explain_per_node_hook;
|
|
|
|
/* Hook for plugins to get control in explain_get_index_name() */
|
|
typedef const char *(*explain_get_index_name_hook_type) (Oid indexId);
|
|
extern PGDLLIMPORT explain_get_index_name_hook_type explain_get_index_name_hook;
|
|
|
|
|
|
extern void ExplainQuery(ParseState *pstate, ExplainStmt *stmt,
|
|
ParamListInfo params, DestReceiver *dest);
|
|
extern void standard_ExplainOneQuery(Query *query, int cursorOptions,
|
|
IntoClause *into, struct ExplainState *es,
|
|
const char *queryString, ParamListInfo params,
|
|
QueryEnvironment *queryEnv);
|
|
|
|
extern TupleDesc ExplainResultDesc(ExplainStmt *stmt);
|
|
|
|
extern void ExplainOneUtility(Node *utilityStmt, IntoClause *into,
|
|
struct ExplainState *es, ParseState *pstate,
|
|
ParamListInfo params);
|
|
|
|
extern void ExplainOnePlan(PlannedStmt *plannedstmt, IntoClause *into,
|
|
struct ExplainState *es, const char *queryString,
|
|
ParamListInfo params, QueryEnvironment *queryEnv,
|
|
const instr_time *planduration,
|
|
const BufferUsage *bufusage,
|
|
const MemoryContextCounters *mem_counters);
|
|
|
|
extern void ExplainPrintPlan(struct ExplainState *es, QueryDesc *queryDesc);
|
|
extern void ExplainPrintTriggers(struct ExplainState *es,
|
|
QueryDesc *queryDesc);
|
|
|
|
extern void ExplainPrintJITSummary(struct ExplainState *es,
|
|
QueryDesc *queryDesc);
|
|
|
|
extern void ExplainQueryText(struct ExplainState *es, QueryDesc *queryDesc);
|
|
extern void ExplainQueryParameters(struct ExplainState *es,
|
|
ParamListInfo params, int maxlen);
|
|
|
|
#endif /* EXPLAIN_H */
|