execMain.c 53.0 KB
Newer Older
1 2
/*-------------------------------------------------------------------------
 *
3
 * execMain.c
4
 *	  top level executor interface routines
5 6
 *
 * INTERFACE ROUTINES
7 8 9
 *	ExecutorStart()
 *	ExecutorRun()
 *	ExecutorEnd()
10
 *
11 12 13 14
 *	The old ExecutorMain() has been replaced by ExecutorStart(),
 *	ExecutorRun() and ExecutorEnd()
 *
 *	These three procedures are the external interfaces to the executor.
15
 *	In each case, the query descriptor is required as an argument.
16
 *
17
 *	ExecutorStart() must be called at the beginning of execution of any
18 19 20
 *	query plan and ExecutorEnd() should always be called at the end of
 *	execution of a plan.
 *
21
 *	ExecutorRun accepts direction and count arguments that specify whether
22
 *	the plan is to be executed forwards, backwards, and for how many tuples.
23
 *
B
Bruce Momjian 已提交
24
 * Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
B
Add:  
Bruce Momjian 已提交
25
 * Portions Copyright (c) 1994, Regents of the University of California
26 27 28
 *
 *
 * IDENTIFICATION
29
 *	  $Header: /cvsroot/pgsql/src/backend/executor/execMain.c,v 1.206 2003/05/05 17:57:47 tgl Exp $
30 31 32
 *
 *-------------------------------------------------------------------------
 */
33 34
#include "postgres.h"

35 36
#include "access/heapam.h"
#include "catalog/heap.h"
37
#include "catalog/namespace.h"
38
#include "commands/tablecmds.h"
39
#include "commands/trigger.h"
B
Bruce Momjian 已提交
40 41 42 43 44 45
#include "executor/execdebug.h"
#include "executor/execdefs.h"
#include "miscadmin.h"
#include "optimizer/var.h"
#include "parser/parsetree.h"
#include "utils/acl.h"
46
#include "utils/lsyscache.h"
47

48

49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
typedef struct execRowMark
{
	Relation	relation;
	Index		rti;
	char		resname[32];
} execRowMark;

typedef struct evalPlanQual
{
	Index		rti;
	EState	   *estate;
	PlanState  *planstate;
	struct evalPlanQual *next;	/* stack of active PlanQual plans */
	struct evalPlanQual *free;	/* list of free PlanQual plans */
} evalPlanQual;

65
/* decls for local routines only used within this module */
66
static void InitPlan(QueryDesc *queryDesc);
67
static void initResultRelInfo(ResultRelInfo *resultRelInfo,
B
Bruce Momjian 已提交
68 69 70
				  Index resultRelationIndex,
				  List *rangeTable,
				  CmdType operation);
71
static TupleTableSlot *ExecutePlan(EState *estate, PlanState *planstate,
B
Bruce Momjian 已提交
72 73 74 75
			CmdType operation,
			long numberTuples,
			ScanDirection direction,
			DestReceiver *destfunc);
76
static void ExecSelect(TupleTableSlot *slot,
B
Bruce Momjian 已提交
77 78
		   DestReceiver *destfunc,
		   EState *estate);
79
static void ExecInsert(TupleTableSlot *slot, ItemPointer tupleid,
B
Bruce Momjian 已提交
80
		   EState *estate);
81
static void ExecDelete(TupleTableSlot *slot, ItemPointer tupleid,
B
Bruce Momjian 已提交
82
		   EState *estate);
83
static void ExecUpdate(TupleTableSlot *slot, ItemPointer tupleid,
B
Bruce Momjian 已提交
84
		   EState *estate);
85
static TupleTableSlot *EvalPlanQualNext(EState *estate);
86
static void EndEvalPlanQual(EState *estate);
87
static void ExecCheckRTEPerms(RangeTblEntry *rte, CmdType operation);
88
static void ExecCheckXactReadOnly(Query *parsetree, CmdType operation);
89 90 91
static void EvalPlanQualStart(evalPlanQual *epq, EState *estate,
							  evalPlanQual *priorepq);
static void EvalPlanQualStop(evalPlanQual *epq);
92

93 94
/* end of local decls */

95

96
/* ----------------------------------------------------------------
97 98 99 100 101
 *		ExecutorStart
 *
 *		This routine must be called at the beginning of any execution of any
 *		query plan
 *
102 103 104 105
 * Takes a QueryDesc previously created by CreateQueryDesc (it's not real
 * clear why we bother to separate the two functions, but...).  The tupDesc
 * field of the QueryDesc is filled in to describe the tuples that will be
 * returned, and the internal fields (estate and planstate) are set up.
106
 *
107 108
 * NB: the CurrentMemoryContext when this is called will become the parent
 * of the per-query context used for this Executor invocation.
109 110
 * ----------------------------------------------------------------
 */
111 112
void
ExecutorStart(QueryDesc *queryDesc)
113
{
114
	EState	   *estate;
115
	MemoryContext oldcontext;
116

117
	/* sanity checks: queryDesc must not be started already */
118
	Assert(queryDesc != NULL);
119 120 121
	Assert(queryDesc->estate == NULL);

	/*
122
	 * Build EState, switch into per-query memory context for startup.
123 124 125 126
	 */
	estate = CreateExecutorState();
	queryDesc->estate = estate;

127 128 129 130 131
	oldcontext = MemoryContextSwitchTo(estate->es_query_cxt);

	/*
	 * Fill in parameters, if any, from queryDesc
	 */
132
	estate->es_param_list_info = queryDesc->params;
133

V
Vadim B. Mikheev 已提交
134
	if (queryDesc->plantree->nParamExec > 0)
135
		estate->es_param_exec_vals = (ParamExecData *)
136
			palloc0(queryDesc->plantree->nParamExec * sizeof(ParamExecData));
137

138 139
	estate->es_instrument = queryDesc->doInstrument;

140
	/*
141 142
	 * Make our own private copy of the current query snapshot data.
	 *
B
Bruce Momjian 已提交
143 144 145
	 * This "freezes" our idea of which tuples are good and which are not for
	 * the life of this query, even if it outlives the current command and
	 * current snapshot.
146
	 */
147
	estate->es_snapshot = CopyQuerySnapshot();
148

149
	/*
150
	 * Initialize the plan state tree
151
	 */
152
	InitPlan(queryDesc);
153 154

	MemoryContextSwitchTo(oldcontext);
155 156 157
}

/* ----------------------------------------------------------------
158 159 160 161 162 163 164
 *		ExecutorRun
 *
 *		This is the main routine of the executor module. It accepts
 *		the query descriptor from the traffic cop and executes the
 *		query plan.
 *
 *		ExecutorStart must have been called already.
165
 *
166 167 168
 *		If direction is NoMovementScanDirection then nothing is done
 *		except to start up/shut down the destination.  Otherwise,
 *		we retrieve up to 'count' tuples in the specified direction.
169
 *
170
 *		Note: count = 0 is interpreted as no portal limit, i.e., run to
171
 *		completion.
172
 *
173 174
 * ----------------------------------------------------------------
 */
175
TupleTableSlot *
176
ExecutorRun(QueryDesc *queryDesc,
177
			ScanDirection direction, long count)
178
{
179
	EState	   *estate;
180
	CmdType		operation;
B
Bruce Momjian 已提交
181 182
	CommandDest dest;
	DestReceiver *destfunc;
183
	TupleTableSlot *result;
184 185 186 187 188 189 190 191
	MemoryContext oldcontext;

	/* sanity checks */
	Assert(queryDesc != NULL);

	estate = queryDesc->estate;

	Assert(estate != NULL);
192

B
Bruce Momjian 已提交
193
	/*
194
	 * Switch into per-query memory context
195
	 */
196
	oldcontext = MemoryContextSwitchTo(estate->es_query_cxt);
197

B
Bruce Momjian 已提交
198
	/*
B
Bruce Momjian 已提交
199 200
	 * extract information from the query descriptor and the query
	 * feature.
201
	 */
202 203 204
	operation = queryDesc->operation;
	dest = queryDesc->dest;

205 206 207 208 209 210 211 212
	/*
	 * If the transaction is read-only, we need to check if any writes
	 * are planned to non-temporary tables.  This is done here at this
	 * rather late stage so that we can handle EXPLAIN vs. EXPLAIN
	 * ANALYZE easily.
	 */
	ExecCheckXactReadOnly(queryDesc->parsetree, operation);

B
Bruce Momjian 已提交
213
	/*
214
	 * startup tuple receiver
215
	 */
216 217
	estate->es_processed = 0;
	estate->es_lastoid = InvalidOid;
218

219
	destfunc = DestToFunction(dest);
220 221
	(*destfunc->setup) (destfunc, operation, queryDesc->portalName,
						queryDesc->tupDesc);
222

223 224 225 226 227 228 229
	/*
	 * run plan
	 */
	if (direction == NoMovementScanDirection)
		result = NULL;
	else
		result = ExecutePlan(estate,
230
							 queryDesc->planstate,
231 232 233 234
							 operation,
							 count,
							 direction,
							 destfunc);
235

236 237 238
	/*
	 * shutdown receiver
	 */
239 240
	(*destfunc->cleanup) (destfunc);

241 242
	MemoryContextSwitchTo(oldcontext);

243
	return result;
244 245 246
}

/* ----------------------------------------------------------------
247 248
 *		ExecutorEnd
 *
249
 *		This routine must be called at the end of execution of any
250
 *		query plan
251 252 253
 * ----------------------------------------------------------------
 */
void
254
ExecutorEnd(QueryDesc *queryDesc)
255
{
256
	EState	   *estate;
257
	MemoryContext oldcontext;
258

259 260
	/* sanity checks */
	Assert(queryDesc != NULL);
261

262 263
	estate = queryDesc->estate;

264
	Assert(estate != NULL);
265

266
	/*
267
	 * Switch into per-query memory context to run ExecEndPlan
268
	 */
269 270 271
	oldcontext = MemoryContextSwitchTo(estate->es_query_cxt);

	ExecEndPlan(queryDesc->planstate, estate);
272

273
	/*
274
	 * Must switch out of context before destroying it
275
	 */
276
	MemoryContextSwitchTo(oldcontext);
277

278
	/*
279 280
	 * Release EState and per-query memory context.  This should release
	 * everything the executor has allocated.
281
	 */
282 283 284 285 286 287
	FreeExecutorState(estate);

	/* Reset queryDesc fields that no longer point to anything */
	queryDesc->tupDesc = NULL;
	queryDesc->estate = NULL;
	queryDesc->planstate = NULL;
288
}
289

290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325
/* ----------------------------------------------------------------
 *		ExecutorRewind
 *
 *		This routine may be called on an open queryDesc to rewind it
 *		to the start.
 * ----------------------------------------------------------------
 */
void
ExecutorRewind(QueryDesc *queryDesc)
{
	EState	   *estate;
	MemoryContext oldcontext;

	/* sanity checks */
	Assert(queryDesc != NULL);

	estate = queryDesc->estate;

	Assert(estate != NULL);

	/* It's probably not sensible to rescan updating queries */
	Assert(queryDesc->operation == CMD_SELECT);

	/*
	 * Switch into per-query memory context
	 */
	oldcontext = MemoryContextSwitchTo(estate->es_query_cxt);

	/*
	 * rescan plan
	 */
	ExecReScan(queryDesc->planstate, NULL);

	MemoryContextSwitchTo(oldcontext);
}

326

327 328 329 330
/*
 * ExecCheckRTPerms
 *		Check access permissions for all relations listed in a range table.
 */
331
void
332
ExecCheckRTPerms(List *rangeTable, CmdType operation)
333 334 335 336
{
	List	   *lp;

	foreach(lp, rangeTable)
337
	{
338 339
		RangeTblEntry *rte = lfirst(lp);

340
		ExecCheckRTEPerms(rte, operation);
341 342 343 344 345 346 347 348
	}
}

/*
 * ExecCheckRTEPerms
 *		Check access permissions for a single RTE.
 */
static void
349
ExecCheckRTEPerms(RangeTblEntry *rte, CmdType operation)
350
{
351
	Oid			relOid;
352
	AclId		userid;
353
	AclResult	aclcheck_result;
354

B
Bruce Momjian 已提交
355
	/*
356 357 358 359 360 361 362 363 364 365 366 367
	 * If it's a subquery, recursively examine its rangetable.
	 */
	if (rte->rtekind == RTE_SUBQUERY)
	{
		ExecCheckRTPerms(rte->subquery->rtable, operation);
		return;
	}

	/*
	 * Otherwise, only plain-relation RTEs need to be checked here.
	 * Function RTEs are checked by init_fcache when the function is prepared
	 * for execution. Join and special RTEs need no checks.
B
Bruce Momjian 已提交
368
	 */
369
	if (rte->rtekind != RTE_RELATION)
370 371
		return;

372
	relOid = rte->relid;
373 374

	/*
B
Bruce Momjian 已提交
375 376
	 * userid to check as: current user unless we have a setuid
	 * indication.
377
	 *
B
Bruce Momjian 已提交
378 379
	 * Note: GetUserId() is presently fast enough that there's no harm in
	 * calling it separately for each RTE.	If that stops being true, we
380
	 * could call it once in ExecCheckRTPerms and pass the userid down
B
Bruce Momjian 已提交
381
	 * from there.	But for now, no need for the extra clutter.
382
	 */
383
	userid = rte->checkAsUser ? rte->checkAsUser : GetUserId();
384

385
#define CHECK(MODE)		pg_class_aclcheck(relOid, userid, MODE)
386

387
	if (rte->checkForRead)
388
	{
389
		aclcheck_result = CHECK(ACL_SELECT);
390
		if (aclcheck_result != ACLCHECK_OK)
391
			aclcheck_error(aclcheck_result, get_rel_name(relOid));
392 393 394 395 396 397 398 399 400
	}

	if (rte->checkForWrite)
	{
		/*
		 * Note: write access in a SELECT context means SELECT FOR UPDATE.
		 * Right now we don't distinguish that from true update as far as
		 * permissions checks are concerned.
		 */
401 402 403
		switch (operation)
		{
			case CMD_INSERT:
404
				aclcheck_result = CHECK(ACL_INSERT);
405
				break;
406
			case CMD_SELECT:
407
			case CMD_UPDATE:
408 409 410 411
				aclcheck_result = CHECK(ACL_UPDATE);
				break;
			case CMD_DELETE:
				aclcheck_result = CHECK(ACL_DELETE);
412 413 414 415
				break;
			default:
				elog(ERROR, "ExecCheckRTEPerms: bogus operation %d",
					 operation);
416
				aclcheck_result = ACLCHECK_OK;	/* keep compiler quiet */
417 418
				break;
		}
419
		if (aclcheck_result != ACLCHECK_OK)
420
			aclcheck_error(aclcheck_result, get_rel_name(relOid));
421
	}
422 423
}

424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448
static void
ExecCheckXactReadOnly(Query *parsetree, CmdType operation)
{
	if (!XactReadOnly)
		return;

	/* CREATE TABLE AS or SELECT INTO */
	if (operation == CMD_SELECT && parsetree->into != NULL)
		goto fail;

	if (operation == CMD_DELETE || operation == CMD_INSERT
		|| operation == CMD_UPDATE)
	{
		List *lp;

		foreach(lp, parsetree->rtable)
		{
			RangeTblEntry *rte = lfirst(lp);

			if (rte->rtekind != RTE_RELATION)
				continue;

			if (!rte->checkForWrite)
				continue;

449
			if (isTempNamespace(get_rel_namespace(rte->relid)))
450 451 452 453 454 455 456 457 458 459 460 461 462
				continue;

			goto fail;
		}
	}

	return;

fail:
	elog(ERROR, "transaction is read-only");
}


463
/* ----------------------------------------------------------------
464 465 466 467
 *		InitPlan
 *
 *		Initializes the query plan: open files, allocate storage
 *		and start up the rule manager
468 469
 * ----------------------------------------------------------------
 */
470 471
static void
InitPlan(QueryDesc *queryDesc)
472
{
473 474 475 476 477
	CmdType		operation = queryDesc->operation;
	Query *parseTree = queryDesc->parsetree;
	Plan *plan = queryDesc->plantree;
	EState *estate = queryDesc->estate;
	PlanState  *planstate;
B
Bruce Momjian 已提交
478 479
	List	   *rangeTable;
	Relation	intoRelationDesc;
480
	bool		do_select_into;
B
Bruce Momjian 已提交
481
	TupleDesc	tupType;
482

483
	/*
484 485 486
	 * Do permissions checks.  It's sufficient to examine the query's
	 * top rangetable here --- subplan RTEs will be checked during
	 * ExecInitSubPlan().
487
	 */
488
	ExecCheckRTPerms(parseTree->rtable, operation);
489

B
Bruce Momjian 已提交
490
	/*
B
Bruce Momjian 已提交
491
	 * get information from query descriptor
492
	 */
493
	rangeTable = parseTree->rtable;
494

B
Bruce Momjian 已提交
495
	/*
B
Bruce Momjian 已提交
496
	 * initialize the node's execution state
497
	 */
498 499
	estate->es_range_table = rangeTable;

B
Bruce Momjian 已提交
500
	/*
501
	 * if there is a result relation, initialize result relation stuff
502
	 */
503
	if (parseTree->resultRelation != 0 && operation != CMD_SELECT)
504
	{
505 506 507
		List	   *resultRelations = parseTree->resultRelations;
		int			numResultRelations;
		ResultRelInfo *resultRelInfos;
B
Bruce Momjian 已提交
508

509 510 511 512 513 514 515
		if (resultRelations != NIL)
		{
			/*
			 * Multiple result relations (due to inheritance)
			 * parseTree->resultRelations identifies them all
			 */
			ResultRelInfo *resultRelInfo;
516

517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533
			numResultRelations = length(resultRelations);
			resultRelInfos = (ResultRelInfo *)
				palloc(numResultRelations * sizeof(ResultRelInfo));
			resultRelInfo = resultRelInfos;
			while (resultRelations != NIL)
			{
				initResultRelInfo(resultRelInfo,
								  lfirsti(resultRelations),
								  rangeTable,
								  operation);
				resultRelInfo++;
				resultRelations = lnext(resultRelations);
			}
		}
		else
		{
			/*
B
Bruce Momjian 已提交
534 535
			 * Single result relation identified by
			 * parseTree->resultRelation
536 537 538 539 540 541 542 543
			 */
			numResultRelations = 1;
			resultRelInfos = (ResultRelInfo *) palloc(sizeof(ResultRelInfo));
			initResultRelInfo(resultRelInfos,
							  parseTree->resultRelation,
							  rangeTable,
							  operation);
		}
544

545 546 547 548
		estate->es_result_relations = resultRelInfos;
		estate->es_num_result_relations = numResultRelations;
		/* Initialize to first or only result rel */
		estate->es_result_relation_info = resultRelInfos;
549
	}
550 551
	else
	{
B
Bruce Momjian 已提交
552
		/*
B
Bruce Momjian 已提交
553
		 * if no result relation, then set state appropriately
554
		 */
555 556
		estate->es_result_relations = NULL;
		estate->es_num_result_relations = 0;
557 558 559
		estate->es_result_relation_info = NULL;
	}

560 561 562 563 564 565 566
	/*
	 * Detect whether we're doing SELECT INTO.  If so, set the force_oids
	 * flag appropriately so that the plan tree will be initialized with
	 * the correct tuple descriptors.
	 */
	do_select_into = false;

567
	if (operation == CMD_SELECT && parseTree->into != NULL)
568 569 570 571 572 573 574 575 576 577
	{
		do_select_into = true;
		/*
		 * For now, always create OIDs in SELECT INTO; this is for backwards
		 * compatibility with pre-7.3 behavior.  Eventually we might want
		 * to allow the user to choose.
		 */
		estate->es_force_oids = true;
	}

578 579 580
	/*
	 * Have to lock relations selected for update
	 */
581 582
	estate->es_rowMark = NIL;
	if (parseTree->rowMarks != NIL)
583
	{
B
Bruce Momjian 已提交
584
		List	   *l;
585

586
		foreach(l, parseTree->rowMarks)
587
		{
588 589
			Index		rti = lfirsti(l);
			Oid			relid = getrelid(rti, rangeTable);
590 591 592 593
			Relation	relation;
			execRowMark *erm;

			relation = heap_open(relid, RowShareLock);
B
Bruce Momjian 已提交
594
			erm = (execRowMark *) palloc(sizeof(execRowMark));
595
			erm->relation = relation;
596
			erm->rti = rti;
597
			snprintf(erm->resname, sizeof(erm->resname), "ctid%u", rti);
598 599 600
			estate->es_rowMark = lappend(estate->es_rowMark, erm);
		}
	}
601

B
Bruce Momjian 已提交
602
	/*
603
	 * initialize the executor "tuple" table.  We need slots for all the
604 605 606
	 * plan nodes, plus possibly output slots for the junkfilter(s). At
	 * this point we aren't sure if we need junkfilters, so just add slots
	 * for them unconditionally.
607 608
	 */
	{
609
		int			nSlots = ExecCountSlotsNode(plan);
610

611 612 613 614 615
		if (parseTree->resultRelations != NIL)
			nSlots += length(parseTree->resultRelations);
		else
			nSlots += 1;
		estate->es_tupleTable = ExecCreateTupleTable(nSlots);
616
	}
617

618
	/* mark EvalPlanQual not active */
619
	estate->es_topPlan = plan;
620 621
	estate->es_evalPlanQual = NULL;
	estate->es_evTupleNull = NULL;
622
	estate->es_evTuple = NULL;
623 624
	estate->es_useEvalPlan = false;

B
Bruce Momjian 已提交
625
	/*
B
Bruce Momjian 已提交
626 627
	 * initialize the private state information for all the nodes in the
	 * query tree.	This opens files, allocates storage and leaves us
628
	 * ready to start processing tuples.
629
	 */
630
	planstate = ExecInitNode(plan, estate);
631

B
Bruce Momjian 已提交
632
	/*
633
	 * Get the tuple descriptor describing the type of tuples to return.
B
Bruce Momjian 已提交
634
	 * (this is especially important if we are creating a relation with
635
	 * "SELECT INTO")
636
	 */
637
	tupType = ExecGetResultType(planstate);
638

B
Bruce Momjian 已提交
639
	/*
640 641 642 643 644
	 * Initialize the junk filter if needed.  SELECT and INSERT queries need a
	 * filter if there are any junk attrs in the tlist.  INSERT and SELECT
	 * INTO also need a filter if the top plan node is a scan node that's not
	 * doing projection (else we'll be scribbling on the scan tuple!)  UPDATE
	 * and DELETE always need a filter, since there's always a junk 'ctid'
B
Bruce Momjian 已提交
645
	 * attribute present --- no need to look first.
646 647
	 */
	{
648 649 650
		bool		junk_filter_needed = false;
		List	   *tlist;

651
		switch (operation)
652
		{
653 654
			case CMD_SELECT:
			case CMD_INSERT:
655
				foreach(tlist, plan->targetlist)
656
				{
657 658 659 660 661 662 663
					TargetEntry *tle = (TargetEntry *) lfirst(tlist);

					if (tle->resdom->resjunk)
					{
						junk_filter_needed = true;
						break;
					}
664
				}
665 666 667 668 669 670 671 672 673 674 675 676 677
				if (!junk_filter_needed &&
					(operation == CMD_INSERT || do_select_into))
				{
					if (IsA(planstate, SeqScanState) ||
						IsA(planstate, IndexScanState) ||
						IsA(planstate, TidScanState) ||
						IsA(planstate, SubqueryScanState) ||
						IsA(planstate, FunctionScanState))
					{
						if (planstate->ps_ProjInfo == NULL)
							junk_filter_needed = true;
					}
				}
678 679 680 681 682 683 684
				break;
			case CMD_UPDATE:
			case CMD_DELETE:
				junk_filter_needed = true;
				break;
			default:
				break;
685 686
		}

687
		if (junk_filter_needed)
688
		{
689
			/*
B
Bruce Momjian 已提交
690 691 692 693
			 * If there are multiple result relations, each one needs its
			 * own junk filter.  Note this is only possible for
			 * UPDATE/DELETE, so we can't be fooled by some needing a
			 * filter and some not.
694 695 696
			 */
			if (parseTree->resultRelations != NIL)
			{
697 698
				PlanState **appendplans;
				int			as_nplans;
699
				ResultRelInfo *resultRelInfo;
700
				int			i;
701 702 703 704

				/* Top plan had better be an Append here. */
				Assert(IsA(plan, Append));
				Assert(((Append *) plan)->isTarget);
705 706 707 708
				Assert(IsA(planstate, AppendState));
				appendplans = ((AppendState *) planstate)->appendplans;
				as_nplans = ((AppendState *) planstate)->as_nplans;
				Assert(as_nplans == estate->es_num_result_relations);
709
				resultRelInfo = estate->es_result_relations;
710
				for (i = 0; i < as_nplans; i++)
711
				{
712
					PlanState  *subplan = appendplans[i];
713 714
					JunkFilter *j;

715
					j = ExecInitJunkFilter(subplan->plan->targetlist,
716
										   ExecGetResultType(subplan),
717
							  ExecAllocTableSlot(estate->es_tupleTable));
718 719 720
					resultRelInfo->ri_junkFilter = j;
					resultRelInfo++;
				}
B
Bruce Momjian 已提交
721

722 723 724 725 726 727 728 729 730 731
				/*
				 * Set active junkfilter too; at this point ExecInitAppend
				 * has already selected an active result relation...
				 */
				estate->es_junkFilter =
					estate->es_result_relation_info->ri_junkFilter;
			}
			else
			{
				/* Normal case with just one JunkFilter */
732
				JunkFilter *j;
733

734
				j = ExecInitJunkFilter(planstate->plan->targetlist,
735
									   tupType,
736
							  ExecAllocTableSlot(estate->es_tupleTable));
737 738 739
				estate->es_junkFilter = j;
				if (estate->es_result_relation_info)
					estate->es_result_relation_info->ri_junkFilter = j;
740

741 742 743 744
				/* For SELECT, want to return the cleaned tuple type */
				if (operation == CMD_SELECT)
					tupType = j->jf_cleanTupType;
			}
745 746 747 748
		}
		else
			estate->es_junkFilter = NULL;
	}
749

B
Bruce Momjian 已提交
750
	/*
751 752 753
	 * If doing SELECT INTO, initialize the "into" relation.  We must wait
	 * till now so we have the "clean" result tuple type to create the
	 * new table from.
754 755 756
	 */
	intoRelationDesc = (Relation) NULL;

757
	if (do_select_into)
758
	{
759 760 761 762 763
		char	   *intoName;
		Oid			namespaceId;
		AclResult	aclresult;
		Oid			intoRelationId;
		TupleDesc	tupdesc;
764

765 766 767 768 769
		/*
		 * find namespace to create in, check permissions
		 */
		intoName = parseTree->into->relname;
		namespaceId = RangeVarGetCreationNamespace(parseTree->into);
770

771 772 773 774
		aclresult = pg_namespace_aclcheck(namespaceId, GetUserId(),
										  ACL_CREATE);
		if (aclresult != ACLCHECK_OK)
			aclcheck_error(aclresult, get_namespace_name(namespaceId));
775

776 777 778 779
		/*
		 * have to copy tupType to get rid of constraints
		 */
		tupdesc = CreateTupleDescCopy(tupType);
780

781 782 783 784 785 786 787
		intoRelationId = heap_create_with_catalog(intoName,
												  namespaceId,
												  tupdesc,
												  RELKIND_RELATION,
												  false,
												  ONCOMMIT_NOOP,
												  allowSystemTableMods);
788

789
		FreeTupleDesc(tupdesc);
790

791 792 793 794 795
		/*
		 * Advance command counter so that the newly-created
		 * relation's catalog tuples will be visible to heap_open.
		 */
		CommandCounterIncrement();
796

797 798 799 800 801 802 803
		/*
		 * If necessary, create a TOAST table for the into
		 * relation. Note that AlterTableCreateToastTable ends
		 * with CommandCounterIncrement(), so that the TOAST table
		 * will be visible for insertion.
		 */
		AlterTableCreateToastTable(intoRelationId, true);
804

805 806 807 808
		/*
		 * And open the constructed table for writing.
		 */
		intoRelationDesc = heap_open(intoRelationId, AccessExclusiveLock);
809 810 811 812
	}

	estate->es_into_relation_descriptor = intoRelationDesc;

813 814
	queryDesc->tupDesc = tupType;
	queryDesc->planstate = planstate;
815 816
}

817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854
/*
 * Initialize ResultRelInfo data for one result relation
 */
static void
initResultRelInfo(ResultRelInfo *resultRelInfo,
				  Index resultRelationIndex,
				  List *rangeTable,
				  CmdType operation)
{
	Oid			resultRelationOid;
	Relation	resultRelationDesc;

	resultRelationOid = getrelid(resultRelationIndex, rangeTable);
	resultRelationDesc = heap_open(resultRelationOid, RowExclusiveLock);

	switch (resultRelationDesc->rd_rel->relkind)
	{
		case RELKIND_SEQUENCE:
			elog(ERROR, "You can't change sequence relation %s",
				 RelationGetRelationName(resultRelationDesc));
			break;
		case RELKIND_TOASTVALUE:
			elog(ERROR, "You can't change toast relation %s",
				 RelationGetRelationName(resultRelationDesc));
			break;
		case RELKIND_VIEW:
			elog(ERROR, "You can't change view relation %s",
				 RelationGetRelationName(resultRelationDesc));
			break;
	}

	MemSet(resultRelInfo, 0, sizeof(ResultRelInfo));
	resultRelInfo->type = T_ResultRelInfo;
	resultRelInfo->ri_RangeTableIndex = resultRelationIndex;
	resultRelInfo->ri_RelationDesc = resultRelationDesc;
	resultRelInfo->ri_NumIndices = 0;
	resultRelInfo->ri_IndexRelationDescs = NULL;
	resultRelInfo->ri_IndexRelationInfo = NULL;
855 856
	/* make a copy so as not to depend on relcache info not changing... */
	resultRelInfo->ri_TrigDesc = CopyTriggerDesc(resultRelationDesc->trigdesc);
857
	resultRelInfo->ri_TrigFunctions = NULL;
858 859 860 861 862 863
	resultRelInfo->ri_ConstraintExprs = NULL;
	resultRelInfo->ri_junkFilter = NULL;

	/*
	 * If there are indices on the result relation, open them and save
	 * descriptors in the result relation info, so that we can add new
B
Bruce Momjian 已提交
864 865
	 * index entries for the tuples we add/update.	We need not do this
	 * for a DELETE, however, since deletion doesn't affect indexes.
866 867 868 869 870 871
	 */
	if (resultRelationDesc->rd_rel->relhasindex &&
		operation != CMD_DELETE)
		ExecOpenIndices(resultRelInfo);
}

872
/* ----------------------------------------------------------------
873
 *		ExecEndPlan
874
 *
875
 *		Cleans up the query plan -- closes files and frees up storage
876 877 878 879 880 881
 *
 * NOTE: we are no longer very worried about freeing storage per se
 * in this code; FreeExecutorState should be guaranteed to release all
 * memory that needs to be released.  What we are worried about doing
 * is closing relations and dropping buffer pins.  Thus, for example,
 * tuple tables must be cleared or dropped to ensure pins are released.
882 883
 * ----------------------------------------------------------------
 */
884 885
void
ExecEndPlan(PlanState *planstate, EState *estate)
886
{
887 888
	ResultRelInfo *resultRelInfo;
	int			i;
889
	List	   *l;
890

891 892 893 894 895 896
	/*
	 * shut down any PlanQual processing we were doing
	 */
	if (estate->es_evalPlanQual != NULL)
		EndEvalPlanQual(estate);

B
Bruce Momjian 已提交
897
	/*
898
	 * shut down the node-type-specific query processing
899
	 */
900
	ExecEndNode(planstate);
901

B
Bruce Momjian 已提交
902
	/*
B
Bruce Momjian 已提交
903
	 * destroy the executor "tuple" table.
904
	 */
905 906
	ExecDropTupleTable(estate->es_tupleTable, true);
	estate->es_tupleTable = NULL;
907

B
Bruce Momjian 已提交
908
	/*
B
Bruce Momjian 已提交
909
	 * close the result relation(s) if any, but hold locks until xact
910
	 * commit.
911
	 */
912 913
	resultRelInfo = estate->es_result_relations;
	for (i = estate->es_num_result_relations; i > 0; i--)
914
	{
915 916 917 918
		/* Close indices and then the relation itself */
		ExecCloseIndices(resultRelInfo);
		heap_close(resultRelInfo->ri_RelationDesc, NoLock);
		resultRelInfo++;
919 920
	}

B
Bruce Momjian 已提交
921
	/*
922
	 * close the "into" relation if necessary, again keeping lock
923
	 */
924 925
	if (estate->es_into_relation_descriptor != NULL)
		heap_close(estate->es_into_relation_descriptor, NoLock);
926 927 928 929 930 931 932 933 934 935

	/*
	 * close any relations selected FOR UPDATE, again keeping locks
	 */
	foreach(l, estate->es_rowMark)
	{
		execRowMark *erm = lfirst(l);

		heap_close(erm->relation, NoLock);
	}
936 937 938
}

/* ----------------------------------------------------------------
939 940
 *		ExecutePlan
 *
941
 *		processes the query plan to retrieve 'numberTuples' tuples in the
942
 *		direction specified.
943
 *
944
 *		Retrieves all tuples if numberTuples is 0
945
 *
946
 *		result is either a slot containing the last tuple in the case
947
 *		of a SELECT or NULL otherwise.
948
 *
949 950
 * Note: the ctid attribute is a 'junk' attribute that is removed before the
 * user can see it
951 952 953
 * ----------------------------------------------------------------
 */
static TupleTableSlot *
954
ExecutePlan(EState *estate,
955
			PlanState *planstate,
956
			CmdType operation,
957
			long numberTuples,
958
			ScanDirection direction,
959
			DestReceiver *destfunc)
960
{
961 962 963 964 965 966
	JunkFilter			*junkfilter;
	TupleTableSlot		*slot;
	ItemPointer			 tupleid = NULL;
	ItemPointerData		 tuple_ctid;
	long				 current_tuple_count;
	TupleTableSlot		*result;
967

B
Bruce Momjian 已提交
968
	/*
B
Bruce Momjian 已提交
969
	 * initialize local variables
970
	 */
971 972 973 974
	slot = NULL;
	current_tuple_count = 0;
	result = NULL;

B
Bruce Momjian 已提交
975 976
	/*
	 * Set the direction.
977
	 */
978 979
	estate->es_direction = direction;

980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995
	/*
	 * Process BEFORE EACH STATEMENT triggers
	 */
	switch (operation)
	{
		case CMD_UPDATE:
			ExecBSUpdateTriggers(estate, estate->es_result_relation_info);
			break;
		case CMD_DELETE:
			ExecBSDeleteTriggers(estate, estate->es_result_relation_info);
			break;
		case CMD_INSERT:
			ExecBSInsertTriggers(estate, estate->es_result_relation_info);
			break;
		default:
			/* do nothing */
996
			break;
997 998
	}

B
Bruce Momjian 已提交
999
	/*
B
Bruce Momjian 已提交
1000
	 * Loop until we've processed the proper number of tuples from the
1001
	 * plan.
1002 1003 1004 1005
	 */

	for (;;)
	{
1006 1007
		/* Reset the per-output-tuple exprcontext */
		ResetPerTupleExprContext(estate);
B
Bruce Momjian 已提交
1008

B
Bruce Momjian 已提交
1009
		/*
B
Bruce Momjian 已提交
1010
		 * Execute the plan and obtain a tuple
1011
		 */
B
Bruce Momjian 已提交
1012
lnext:	;
1013 1014 1015 1016
		if (estate->es_useEvalPlan)
		{
			slot = EvalPlanQualNext(estate);
			if (TupIsNull(slot))
1017
				slot = ExecProcNode(planstate);
1018 1019
		}
		else
1020
			slot = ExecProcNode(planstate);
1021

B
Bruce Momjian 已提交
1022
		/*
B
Bruce Momjian 已提交
1023 1024
		 * if the tuple is null, then we assume there is nothing more to
		 * process so we just return null...
1025 1026 1027 1028 1029
		 */
		if (TupIsNull(slot))
		{
			result = NULL;
			break;
1030 1031
		}

B
Bruce Momjian 已提交
1032
		/*
B
Bruce Momjian 已提交
1033 1034
		 * if we have a junk filter, then project a new tuple with the
		 * junk removed.
1035
		 *
1036 1037 1038
		 * Store this new "clean" tuple in the junkfilter's resultSlot.
		 * (Formerly, we stored it back over the "dirty" tuple, which is
		 * WRONG because that tuple slot has the wrong descriptor.)
1039
		 *
B
Bruce Momjian 已提交
1040
		 * Also, extract all the junk information we need.
1041 1042 1043
		 */
		if ((junkfilter = estate->es_junkFilter) != (JunkFilter *) NULL)
		{
1044 1045 1046
			Datum		datum;
			HeapTuple	newTuple;
			bool		isNull;
1047

B
Bruce Momjian 已提交
1048
			/*
1049 1050 1051 1052 1053 1054 1055 1056 1057
			 * extract the 'ctid' junk attribute.
			 */
			if (operation == CMD_UPDATE || operation == CMD_DELETE)
			{
				if (!ExecGetJunkAttribute(junkfilter,
										  slot,
										  "ctid",
										  &datum,
										  &isNull))
1058
					elog(ERROR, "ExecutePlan: NO (junk) `ctid' was found!");
1059

1060
				/* shouldn't ever get a null result... */
1061
				if (isNull)
1062
					elog(ERROR, "ExecutePlan: (junk) `ctid' is NULL!");
1063 1064 1065 1066 1067 1068

				tupleid = (ItemPointer) DatumGetPointer(datum);
				tuple_ctid = *tupleid;	/* make sure we don't free the
										 * ctid!! */
				tupleid = &tuple_ctid;
			}
1069
			else if (estate->es_rowMark != NIL)
1070
			{
B
Bruce Momjian 已提交
1071
				List	   *l;
1072

B
Bruce Momjian 已提交
1073 1074
		lmark:	;
				foreach(l, estate->es_rowMark)
1075
				{
1076 1077 1078 1079 1080 1081
					execRowMark *erm = lfirst(l);
					Buffer		buffer;
					HeapTupleData tuple;
					TupleTableSlot *newSlot;
					int			test;

1082 1083 1084 1085 1086
					if (!ExecGetJunkAttribute(junkfilter,
											  slot,
											  erm->resname,
											  &datum,
											  &isNull))
1087 1088
						elog(ERROR, "ExecutePlan: NO (junk) `%s' was found!",
							 erm->resname);
1089

1090
					/* shouldn't ever get a null result... */
1091
					if (isNull)
1092 1093
						elog(ERROR, "ExecutePlan: (junk) `%s' is NULL!",
							 erm->resname);
1094 1095

					tuple.t_self = *((ItemPointer) DatumGetPointer(datum));
1096 1097
					test = heap_mark4update(erm->relation, &tuple, &buffer,
											estate->es_snapshot->curcid);
1098 1099 1100 1101
					ReleaseBuffer(buffer);
					switch (test)
					{
						case HeapTupleSelfUpdated:
1102 1103 1104
							/* treat it as deleted; do not process */
							goto lnext;

1105 1106 1107 1108 1109 1110
						case HeapTupleMayBeUpdated:
							break;

						case HeapTupleUpdated:
							if (XactIsoLevel == XACT_SERIALIZABLE)
								elog(ERROR, "Can't serialize access due to concurrent update");
1111
							if (!(ItemPointerEquals(&(tuple.t_self),
B
Bruce Momjian 已提交
1112
								  (ItemPointer) DatumGetPointer(datum))))
1113
							{
B
Bruce Momjian 已提交
1114
								newSlot = EvalPlanQual(estate, erm->rti, &(tuple.t_self));
1115 1116 1117 1118 1119 1120 1121
								if (!(TupIsNull(newSlot)))
								{
									slot = newSlot;
									estate->es_useEvalPlan = true;
									goto lmark;
								}
							}
B
Bruce Momjian 已提交
1122 1123 1124

							/*
							 * if tuple was deleted or PlanQual failed for
1125
							 * updated tuple - we must not return this
B
Bruce Momjian 已提交
1126
							 * tuple!
1127 1128
							 */
							goto lnext;
1129 1130 1131

						default:
							elog(ERROR, "Unknown status %u from heap_mark4update", test);
B
Bruce Momjian 已提交
1132
							return (NULL);
1133 1134 1135
					}
				}
			}
1136

B
Bruce Momjian 已提交
1137
			/*
1138 1139 1140 1141 1142 1143
			 * Finally create a new "clean" tuple with all junk attributes
			 * removed
			 */
			newTuple = ExecRemoveJunk(junkfilter, slot);

			slot = ExecStoreTuple(newTuple,		/* tuple to store */
1144
								  junkfilter->jf_resultSlot,	/* dest slot */
B
Bruce Momjian 已提交
1145 1146
								  InvalidBuffer,		/* this tuple has no
														 * buffer */
1147
								  true);		/* tuple should be pfreed */
1148
		}
1149

B
Bruce Momjian 已提交
1150
		/*
B
Bruce Momjian 已提交
1151 1152
		 * now that we have a tuple, do the appropriate thing with it..
		 * either return it to the user, add it to a relation someplace,
B
Bruce Momjian 已提交
1153
		 * delete it from a relation, or modify some of its attributes.
1154 1155 1156
		 */
		switch (operation)
		{
1157
			case CMD_SELECT:
B
Bruce Momjian 已提交
1158 1159 1160
				ExecSelect(slot,	/* slot containing tuple */
						   destfunc,	/* destination's tuple-receiver
										 * obj */
1161
						   estate);
1162 1163
				result = slot;
				break;
1164

1165
			case CMD_INSERT:
1166
				ExecInsert(slot, tupleid, estate);
1167 1168
				result = NULL;
				break;
1169

1170 1171 1172 1173
			case CMD_DELETE:
				ExecDelete(slot, tupleid, estate);
				result = NULL;
				break;
1174

1175
			case CMD_UPDATE:
1176
				ExecUpdate(slot, tupleid, estate);
1177 1178
				result = NULL;
				break;
1179

1180
			default:
1181
				elog(LOG, "ExecutePlan: unknown operation in queryDesc");
1182
				result = NULL;
1183
				break;
1184
		}
B
Bruce Momjian 已提交
1185

B
Bruce Momjian 已提交
1186
		/*
1187
		 * check our tuple count.. if we've processed the proper number
1188
		 * then quit, else loop again and process more tuples.  Zero
1189
		 * numberTuples means no limit.
1190
		 */
1191
		current_tuple_count++;
1192
		if (numberTuples && numberTuples == current_tuple_count)
1193
			break;
1194
	}
1195

1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211
	/*
	 * Process AFTER EACH STATEMENT triggers
	 */
	switch (operation)
	{
		case CMD_UPDATE:
			ExecASUpdateTriggers(estate, estate->es_result_relation_info);
			break;
		case CMD_DELETE:
			ExecASDeleteTriggers(estate, estate->es_result_relation_info);
			break;
		case CMD_INSERT:
			ExecASInsertTriggers(estate, estate->es_result_relation_info);
			break;
		default:
			/* do nothing */
1212
			break;
1213 1214
	}

B
Bruce Momjian 已提交
1215
	/*
B
Bruce Momjian 已提交
1216
	 * here, result is either a slot containing a tuple in the case of a
1217
	 * SELECT or NULL otherwise.
1218
	 */
1219
	return result;
1220 1221 1222
}

/* ----------------------------------------------------------------
1223
 *		ExecSelect
1224
 *
1225
 *		SELECTs are easy.. we just pass the tuple to the appropriate
1226
 *		print function.  The only complexity is when we do a
1227
 *		"SELECT INTO", in which case we insert the tuple into
1228 1229
 *		the appropriate relation (note: this is a newly created relation
 *		so we don't need to worry about indices or locks.)
1230 1231 1232
 * ----------------------------------------------------------------
 */
static void
1233 1234 1235
ExecSelect(TupleTableSlot *slot,
		   DestReceiver *destfunc,
		   EState *estate)
1236
{
1237 1238
	HeapTuple	tuple;
	TupleDesc	attrtype;
1239

B
Bruce Momjian 已提交
1240
	/*
B
Bruce Momjian 已提交
1241
	 * get the heap tuple out of the tuple table slot
1242 1243 1244 1245
	 */
	tuple = slot->val;
	attrtype = slot->ttc_tupleDescriptor;

B
Bruce Momjian 已提交
1246
	/*
B
Bruce Momjian 已提交
1247
	 * insert the tuple into the "into relation"
1248 1249 1250
	 */
	if (estate->es_into_relation_descriptor != NULL)
	{
1251 1252
		heap_insert(estate->es_into_relation_descriptor, tuple,
					estate->es_snapshot->curcid);
1253 1254 1255
		IncrAppended();
	}

B
Bruce Momjian 已提交
1256
	/*
B
Bruce Momjian 已提交
1257
	 * send the tuple to the front end (or the screen)
1258
	 */
1259
	(*destfunc->receiveTuple) (tuple, attrtype, destfunc);
1260 1261
	IncrRetrieved();
	(estate->es_processed)++;
1262 1263 1264
}

/* ----------------------------------------------------------------
1265
 *		ExecInsert
1266
 *
1267
 *		INSERTs are trickier.. we have to insert the tuple into
1268 1269
 *		the base relation and insert appropriate tuples into the
 *		index relations.
1270 1271 1272
 * ----------------------------------------------------------------
 */
static void
1273
ExecInsert(TupleTableSlot *slot,
1274
		   ItemPointer tupleid,
1275
		   EState *estate)
1276
{
1277
	HeapTuple	tuple;
1278
	ResultRelInfo *resultRelInfo;
1279 1280 1281
	Relation	resultRelationDesc;
	int			numIndices;
	Oid			newId;
1282

B
Bruce Momjian 已提交
1283
	/*
B
Bruce Momjian 已提交
1284
	 * get the heap tuple out of the tuple table slot
1285 1286 1287
	 */
	tuple = slot->val;

B
Bruce Momjian 已提交
1288
	/*
1289
	 * get information on the (current) result relation
1290
	 */
1291 1292
	resultRelInfo = estate->es_result_relation_info;
	resultRelationDesc = resultRelInfo->ri_RelationDesc;
1293 1294

	/* BEFORE ROW INSERT Triggers */
1295
	if (resultRelInfo->ri_TrigDesc &&
1296
		resultRelInfo->ri_TrigDesc->n_before_row[TRIGGER_EVENT_INSERT] > 0)
1297
	{
1298
		HeapTuple	newtuple;
1299

1300
		newtuple = ExecBRInsertTriggers(estate, resultRelInfo, tuple);
1301 1302 1303 1304 1305 1306

		if (newtuple == NULL)	/* "do nothing" */
			return;

		if (newtuple != tuple)	/* modified by Trigger(s) */
		{
1307 1308 1309
			/*
			 * Insert modified tuple into tuple table slot, replacing the
			 * original.  We assume that it was allocated in per-tuple
B
Bruce Momjian 已提交
1310 1311
			 * memory context, and therefore will go away by itself. The
			 * tuple table slot should not try to clear it.
1312 1313 1314
			 */
			ExecStoreTuple(newtuple, slot, InvalidBuffer, false);
			tuple = newtuple;
1315 1316 1317
		}
	}

B
Bruce Momjian 已提交
1318
	/*
1319
	 * Check the constraints of the tuple
1320 1321
	 */
	if (resultRelationDesc->rd_att->constr)
1322
		ExecConstraints("ExecInsert", resultRelInfo, slot, estate);
1323

B
Bruce Momjian 已提交
1324
	/*
B
Bruce Momjian 已提交
1325
	 * insert the tuple
1326
	 */
1327 1328
	newId = heap_insert(resultRelationDesc, tuple,
						estate->es_snapshot->curcid);
1329

1330
	IncrAppended();
1331 1332
	(estate->es_processed)++;
	estate->es_lastoid = newId;
T
Tom Lane 已提交
1333
	setLastTid(&(tuple->t_self));
1334

B
Bruce Momjian 已提交
1335
	/*
B
Bruce Momjian 已提交
1336
	 * process indices
1337
	 *
B
Bruce Momjian 已提交
1338 1339 1340
	 * Note: heap_insert adds a new tuple to a relation.  As a side effect,
	 * the tupleid of the new tuple is placed in the new tuple's t_ctid
	 * field.
1341
	 */
1342
	numIndices = resultRelInfo->ri_NumIndices;
1343
	if (numIndices > 0)
1344
		ExecInsertIndexTuples(slot, &(tuple->t_self), estate, false);
1345 1346

	/* AFTER ROW INSERT Triggers */
1347
	ExecARInsertTriggers(estate, resultRelInfo, tuple);
1348 1349 1350
}

/* ----------------------------------------------------------------
1351
 *		ExecDelete
1352
 *
1353
 *		DELETE is like UPDATE, we delete the tuple and its
1354
 *		index tuples.
1355 1356 1357
 * ----------------------------------------------------------------
 */
static void
1358
ExecDelete(TupleTableSlot *slot,
1359
		   ItemPointer tupleid,
1360
		   EState *estate)
1361
{
1362
	ResultRelInfo *resultRelInfo;
B
Bruce Momjian 已提交
1363 1364 1365
	Relation	resultRelationDesc;
	ItemPointerData ctid;
	int			result;
1366

B
Bruce Momjian 已提交
1367
	/*
1368
	 * get information on the (current) result relation
1369
	 */
1370 1371
	resultRelInfo = estate->es_result_relation_info;
	resultRelationDesc = resultRelInfo->ri_RelationDesc;
1372 1373

	/* BEFORE ROW DELETE Triggers */
1374
	if (resultRelInfo->ri_TrigDesc &&
1375
	  resultRelInfo->ri_TrigDesc->n_before_row[TRIGGER_EVENT_DELETE] > 0)
1376
	{
1377
		bool		dodelete;
1378

1379 1380
		dodelete = ExecBRDeleteTriggers(estate, resultRelInfo, tupleid,
										estate->es_snapshot->curcid);
1381 1382 1383 1384 1385

		if (!dodelete)			/* "do nothing" */
			return;
	}

V
Vadim B. Mikheev 已提交
1386
	/*
B
Bruce Momjian 已提交
1387
	 * delete the tuple
1388
	 */
1389
ldelete:;
1390 1391 1392
	result = heap_delete(resultRelationDesc, tupleid,
						 &ctid,
						 estate->es_snapshot->curcid);
V
Vadim B. Mikheev 已提交
1393 1394 1395
	switch (result)
	{
		case HeapTupleSelfUpdated:
1396
			/* already deleted by self; nothing to do */
V
Vadim B. Mikheev 已提交
1397 1398 1399 1400 1401 1402
			return;

		case HeapTupleMayBeUpdated:
			break;

		case HeapTupleUpdated:
1403 1404
			if (XactIsoLevel == XACT_SERIALIZABLE)
				elog(ERROR, "Can't serialize access due to concurrent update");
1405 1406
			else if (!(ItemPointerEquals(tupleid, &ctid)))
			{
B
Bruce Momjian 已提交
1407
				TupleTableSlot *epqslot = EvalPlanQual(estate,
B
Bruce Momjian 已提交
1408
							   resultRelInfo->ri_RangeTableIndex, &ctid);
1409

V
Vadim B. Mikheev 已提交
1410
				if (!TupIsNull(epqslot))
1411 1412 1413 1414 1415
				{
					*tupleid = ctid;
					goto ldelete;
				}
			}
1416
			/* tuple already deleted; nothing to do */
V
Vadim B. Mikheev 已提交
1417 1418 1419 1420 1421 1422
			return;

		default:
			elog(ERROR, "Unknown status %u from heap_delete", result);
			return;
	}
1423 1424 1425 1426

	IncrDeleted();
	(estate->es_processed)++;

B
Bruce Momjian 已提交
1427
	/*
B
Bruce Momjian 已提交
1428 1429
	 * Note: Normally one would think that we have to delete index tuples
	 * associated with the heap tuple now..
1430
	 *
B
Bruce Momjian 已提交
1431 1432 1433
	 * ... but in POSTGRES, we have no need to do this because the vacuum
	 * daemon automatically opens an index scan and deletes index tuples
	 * when it finds deleted heap tuples. -cim 9/27/89
1434 1435 1436
	 */

	/* AFTER ROW DELETE Triggers */
1437
	ExecARDeleteTriggers(estate, resultRelInfo, tupleid);
1438 1439 1440
}

/* ----------------------------------------------------------------
1441
 *		ExecUpdate
1442
 *
1443 1444 1445 1446
 *		note: we can't run UPDATE queries with transactions
 *		off because UPDATEs are actually INSERTs and our
 *		scan will mistakenly loop forever, updating the tuple
 *		it just inserted..	This should be fixed but until it
1447 1448
 *		is, we don't want to get stuck in an infinite loop
 *		which corrupts your database..
1449 1450 1451
 * ----------------------------------------------------------------
 */
static void
1452
ExecUpdate(TupleTableSlot *slot,
B
Bruce Momjian 已提交
1453 1454
		   ItemPointer tupleid,
		   EState *estate)
1455
{
B
Bruce Momjian 已提交
1456
	HeapTuple	tuple;
1457
	ResultRelInfo *resultRelInfo;
B
Bruce Momjian 已提交
1458 1459 1460 1461
	Relation	resultRelationDesc;
	ItemPointerData ctid;
	int			result;
	int			numIndices;
1462

B
Bruce Momjian 已提交
1463
	/*
B
Bruce Momjian 已提交
1464
	 * abort the operation if not running transactions
1465 1466 1467
	 */
	if (IsBootstrapProcessingMode())
	{
1468
		elog(WARNING, "ExecUpdate: UPDATE can't run without transactions");
1469 1470 1471
		return;
	}

B
Bruce Momjian 已提交
1472
	/*
B
Bruce Momjian 已提交
1473
	 * get the heap tuple out of the tuple table slot
1474 1475 1476
	 */
	tuple = slot->val;

B
Bruce Momjian 已提交
1477
	/*
1478
	 * get information on the (current) result relation
1479
	 */
1480 1481
	resultRelInfo = estate->es_result_relation_info;
	resultRelationDesc = resultRelInfo->ri_RelationDesc;
1482 1483

	/* BEFORE ROW UPDATE Triggers */
1484
	if (resultRelInfo->ri_TrigDesc &&
1485
	  resultRelInfo->ri_TrigDesc->n_before_row[TRIGGER_EVENT_UPDATE] > 0)
1486
	{
1487
		HeapTuple	newtuple;
1488

1489
		newtuple = ExecBRUpdateTriggers(estate, resultRelInfo,
1490 1491
										tupleid, tuple,
										estate->es_snapshot->curcid);
1492 1493 1494 1495 1496 1497

		if (newtuple == NULL)	/* "do nothing" */
			return;

		if (newtuple != tuple)	/* modified by Trigger(s) */
		{
1498 1499 1500
			/*
			 * Insert modified tuple into tuple table slot, replacing the
			 * original.  We assume that it was allocated in per-tuple
B
Bruce Momjian 已提交
1501 1502
			 * memory context, and therefore will go away by itself. The
			 * tuple table slot should not try to clear it.
1503 1504 1505
			 */
			ExecStoreTuple(newtuple, slot, InvalidBuffer, false);
			tuple = newtuple;
1506 1507 1508
		}
	}

B
Bruce Momjian 已提交
1509
	/*
1510
	 * Check the constraints of the tuple
1511
	 *
1512 1513 1514 1515 1516
	 * If we generate a new candidate tuple after EvalPlanQual testing, we
	 * must loop back here and recheck constraints.  (We don't need to
	 * redo triggers, however.	If there are any BEFORE triggers then
	 * trigger.c will have done mark4update to lock the correct tuple, so
	 * there's no need to do them again.)
1517
	 */
1518
lreplace:;
1519
	if (resultRelationDesc->rd_att->constr)
1520
		ExecConstraints("ExecUpdate", resultRelInfo, slot, estate);
1521

V
Vadim B. Mikheev 已提交
1522
	/*
B
Bruce Momjian 已提交
1523
	 * replace the heap tuple
1524
	 */
1525 1526 1527
	result = heap_update(resultRelationDesc, tupleid, tuple,
						 &ctid,
						 estate->es_snapshot->curcid);
V
Vadim B. Mikheev 已提交
1528 1529 1530
	switch (result)
	{
		case HeapTupleSelfUpdated:
1531
			/* already deleted by self; nothing to do */
V
Vadim B. Mikheev 已提交
1532 1533 1534 1535 1536 1537
			return;

		case HeapTupleMayBeUpdated:
			break;

		case HeapTupleUpdated:
1538 1539
			if (XactIsoLevel == XACT_SERIALIZABLE)
				elog(ERROR, "Can't serialize access due to concurrent update");
1540 1541
			else if (!(ItemPointerEquals(tupleid, &ctid)))
			{
B
Bruce Momjian 已提交
1542
				TupleTableSlot *epqslot = EvalPlanQual(estate,
B
Bruce Momjian 已提交
1543
							   resultRelInfo->ri_RangeTableIndex, &ctid);
1544

V
Vadim B. Mikheev 已提交
1545
				if (!TupIsNull(epqslot))
1546 1547
				{
					*tupleid = ctid;
V
Vadim B. Mikheev 已提交
1548
					tuple = ExecRemoveJunk(estate->es_junkFilter, epqslot);
1549
					slot = ExecStoreTuple(tuple,
1550
									estate->es_junkFilter->jf_resultSlot,
1551
										  InvalidBuffer, true);
1552 1553 1554
					goto lreplace;
				}
			}
1555
			/* tuple already deleted; nothing to do */
V
Vadim B. Mikheev 已提交
1556 1557 1558
			return;

		default:
1559
			elog(ERROR, "Unknown status %u from heap_update", result);
V
Vadim B. Mikheev 已提交
1560
			return;
1561 1562 1563 1564 1565
	}

	IncrReplaced();
	(estate->es_processed)++;

B
Bruce Momjian 已提交
1566
	/*
B
Bruce Momjian 已提交
1567
	 * Note: instead of having to update the old index tuples associated
B
Bruce Momjian 已提交
1568
	 * with the heap tuple, all we do is form and insert new index tuples.
1569
	 * This is because UPDATEs are actually DELETEs and INSERTs and index
B
Bruce Momjian 已提交
1570 1571
	 * tuple deletion is done automagically by the vacuum daemon. All we
	 * do is insert new index tuples.  -cim 9/27/89
1572 1573
	 */

B
Bruce Momjian 已提交
1574
	/*
B
Bruce Momjian 已提交
1575
	 * process indices
1576
	 *
1577
	 * heap_update updates a tuple in the base relation by invalidating it
1578
	 * and then inserting a new tuple to the relation.	As a side effect,
B
Bruce Momjian 已提交
1579 1580 1581
	 * the tupleid of the new tuple is placed in the new tuple's t_ctid
	 * field.  So we now insert index tuples using the new tupleid stored
	 * there.
1582 1583
	 */

1584
	numIndices = resultRelInfo->ri_NumIndices;
1585
	if (numIndices > 0)
1586
		ExecInsertIndexTuples(slot, &(tuple->t_self), estate, false);
1587 1588

	/* AFTER ROW UPDATE Triggers */
1589
	ExecARUpdateTriggers(estate, resultRelInfo, tupleid, tuple);
1590
}
V
Vadim B. Mikheev 已提交
1591

1592
static char *
1593 1594
ExecRelCheck(ResultRelInfo *resultRelInfo,
			 TupleTableSlot *slot, EState *estate)
V
Vadim B. Mikheev 已提交
1595
{
1596
	Relation	rel = resultRelInfo->ri_RelationDesc;
1597 1598
	int			ncheck = rel->rd_att->constr->num_check;
	ConstrCheck *check = rel->rd_att->constr->check;
1599
	ExprContext *econtext;
1600
	MemoryContext oldContext;
1601 1602
	List	   *qual;
	int			i;
1603

1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616
	/*
	 * If first time through for this result relation, build expression
	 * nodetrees for rel's constraint expressions.  Keep them in the
	 * per-query memory context so they'll survive throughout the query.
	 */
	if (resultRelInfo->ri_ConstraintExprs == NULL)
	{
		oldContext = MemoryContextSwitchTo(estate->es_query_cxt);
		resultRelInfo->ri_ConstraintExprs =
			(List **) palloc(ncheck * sizeof(List *));
		for (i = 0; i < ncheck; i++)
		{
			qual = (List *) stringToNode(check[i].ccbin);
1617
			resultRelInfo->ri_ConstraintExprs[i] = (List *)
1618
				ExecPrepareExpr((Expr *) qual, estate);
1619 1620 1621 1622
		}
		MemoryContextSwitchTo(oldContext);
	}

1623
	/*
B
Bruce Momjian 已提交
1624 1625
	 * We will use the EState's per-tuple context for evaluating
	 * constraint expressions (creating it if it's not already there).
1626
	 */
1627
	econtext = GetPerTupleExprContext(estate);
1628

1629 1630 1631 1632
	/* Arrange for econtext's scan tuple to be the tuple under test */
	econtext->ecxt_scantuple = slot;

	/* And evaluate the constraints */
1633 1634
	for (i = 0; i < ncheck; i++)
	{
1635
		qual = resultRelInfo->ri_ConstraintExprs[i];
1636

1637 1638
		/*
		 * NOTE: SQL92 specifies that a NULL result from a constraint
1639 1640
		 * expression is not to be treated as a failure.  Therefore, tell
		 * ExecQual to return TRUE for NULL.
1641
		 */
1642
		if (!ExecQual(qual, econtext, true))
1643
			return check[i].ccname;
1644 1645
	}

1646
	/* NULL result means no error */
1647
	return (char *) NULL;
V
Vadim B. Mikheev 已提交
1648 1649
}

1650
void
1651
ExecConstraints(const char *caller, ResultRelInfo *resultRelInfo,
1652
				TupleTableSlot *slot, EState *estate)
V
Vadim B. Mikheev 已提交
1653
{
1654
	Relation	rel = resultRelInfo->ri_RelationDesc;
1655 1656 1657 1658
	HeapTuple	tuple = slot->val;
	TupleConstr *constr = rel->rd_att->constr;

	Assert(constr);
1659

1660
	if (constr->has_not_null)
V
Vadim B. Mikheev 已提交
1661
	{
1662
		int			natts = rel->rd_att->natts;
1663
		int			attrChk;
1664

1665
		for (attrChk = 1; attrChk <= natts; attrChk++)
1666
		{
B
Bruce Momjian 已提交
1667
			if (rel->rd_att->attrs[attrChk - 1]->attnotnull &&
1668
				heap_attisnull(tuple, attrChk))
1669
				elog(ERROR, "%s: Fail to add null value in not null attribute %s",
B
Bruce Momjian 已提交
1670
					 caller, NameStr(rel->rd_att->attrs[attrChk - 1]->attname));
1671 1672 1673
		}
	}

1674
	if (constr->num_check > 0)
1675
	{
1676
		char	   *failed;
1677

1678
		if ((failed = ExecRelCheck(resultRelInfo, slot, estate)) != NULL)
B
Bruce Momjian 已提交
1679 1680
			elog(ERROR, "%s: rejected due to CHECK constraint \"%s\" on \"%s\"",
				 caller, failed, RelationGetRelationName(rel));
1681
	}
V
Vadim B. Mikheev 已提交
1682
}
1683

1684 1685 1686 1687 1688 1689
/*
 * Check a modified tuple to see if we want to process its updated version
 * under READ COMMITTED rules.
 *
 * See backend/executor/README for some info about how this works.
 */
B
Bruce Momjian 已提交
1690
TupleTableSlot *
1691 1692
EvalPlanQual(EState *estate, Index rti, ItemPointer tid)
{
1693 1694
	evalPlanQual *epq;
	EState	   *epqstate;
B
Bruce Momjian 已提交
1695 1696
	Relation	relation;
	HeapTupleData tuple;
1697 1698
	HeapTuple	copyTuple = NULL;
	bool		endNode;
1699 1700 1701

	Assert(rti != 0);

1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734
	/*
	 * find relation containing target tuple
	 */
	if (estate->es_result_relation_info != NULL &&
		estate->es_result_relation_info->ri_RangeTableIndex == rti)
		relation = estate->es_result_relation_info->ri_RelationDesc;
	else
	{
		List	   *l;

		relation = NULL;
		foreach(l, estate->es_rowMark)
		{
			if (((execRowMark *) lfirst(l))->rti == rti)
			{
				relation = ((execRowMark *) lfirst(l))->relation;
				break;
			}
		}
		if (relation == NULL)
			elog(ERROR, "EvalPlanQual: can't find RTE %d", (int) rti);
	}

	/*
	 * fetch tid tuple
	 *
	 * Loop here to deal with updated or busy tuples
	 */
	tuple.t_self = *tid;
	for (;;)
	{
		Buffer		buffer;

1735
		if (heap_fetch(relation, SnapshotDirty, &tuple, &buffer, false, NULL))
1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786
		{
			TransactionId xwait = SnapshotDirty->xmax;

			if (TransactionIdIsValid(SnapshotDirty->xmin))
				elog(ERROR, "EvalPlanQual: t_xmin is uncommitted ?!");

			/*
			 * If tuple is being updated by other transaction then we have
			 * to wait for its commit/abort.
			 */
			if (TransactionIdIsValid(xwait))
			{
				ReleaseBuffer(buffer);
				XactLockTableWait(xwait);
				continue;
			}

			/*
			 * We got tuple - now copy it for use by recheck query.
			 */
			copyTuple = heap_copytuple(&tuple);
			ReleaseBuffer(buffer);
			break;
		}

		/*
		 * Oops! Invalid tuple. Have to check is it updated or deleted.
		 * Note that it's possible to get invalid SnapshotDirty->tid if
		 * tuple updated by this transaction. Have we to check this ?
		 */
		if (ItemPointerIsValid(&(SnapshotDirty->tid)) &&
			!(ItemPointerEquals(&(tuple.t_self), &(SnapshotDirty->tid))))
		{
			/* updated, so look at the updated copy */
			tuple.t_self = SnapshotDirty->tid;
			continue;
		}

		/*
		 * Deleted or updated by this transaction; forget it.
		 */
		return NULL;
	}

	/*
	 * For UPDATE/DELETE we have to return tid of actual row we're
	 * executing PQ for.
	 */
	*tid = tuple.t_self;

	/*
1787
	 * Need to run a recheck subquery.	Find or create a PQ stack entry.
1788
	 */
1789
	epq = estate->es_evalPlanQual;
1790 1791
	endNode = true;

1792 1793
	if (epq != NULL && epq->rti == 0)
	{
1794
		/* Top PQ stack entry is idle, so re-use it */
1795
		Assert(!(estate->es_useEvalPlan) && epq->next == NULL);
1796 1797 1798 1799 1800 1801
		epq->rti = rti;
		endNode = false;
	}

	/*
	 * If this is request for another RTE - Ra, - then we have to check
B
Bruce Momjian 已提交
1802 1803 1804
	 * wasn't PlanQual requested for Ra already and if so then Ra' row was
	 * updated again and we have to re-start old execution for Ra and
	 * forget all what we done after Ra was suspended. Cool? -:))
1805
	 */
B
Bruce Momjian 已提交
1806
	if (epq != NULL && epq->rti != rti &&
1807
		epq->estate->es_evTuple[rti - 1] != NULL)
1808 1809 1810
	{
		do
		{
1811 1812
			evalPlanQual *oldepq;

1813
			/* stop execution */
1814 1815 1816 1817
			EvalPlanQualStop(epq);
			/* pop previous PlanQual from the stack */
			oldepq = epq->next;
			Assert(oldepq && oldepq->rti != 0);
1818 1819 1820
			/* push current PQ to freePQ stack */
			oldepq->free = epq;
			epq = oldepq;
1821
			estate->es_evalPlanQual = epq;
1822 1823 1824
		} while (epq->rti != rti);
	}

B
Bruce Momjian 已提交
1825
	/*
1826 1827 1828 1829 1830 1831
	 * If we are requested for another RTE then we have to suspend
	 * execution of current PlanQual and start execution for new one.
	 */
	if (epq == NULL || epq->rti != rti)
	{
		/* try to reuse plan used previously */
B
Bruce Momjian 已提交
1832
		evalPlanQual *newepq = (epq != NULL) ? epq->free : NULL;
1833

1834
		if (newepq == NULL)		/* first call or freePQ stack is empty */
1835
		{
1836
			newepq = (evalPlanQual *) palloc0(sizeof(evalPlanQual));
1837
			newepq->free = NULL;
1838 1839
			newepq->estate = NULL;
			newepq->planstate = NULL;
1840 1841
		}
		else
1842
		{
1843 1844 1845
			/* recycle previously used PlanQual */
			Assert(newepq->estate == NULL);
			epq->free = NULL;
1846
		}
1847
		/* push current PQ to the stack */
1848
		newepq->next = epq;
1849
		epq = newepq;
1850
		estate->es_evalPlanQual = epq;
1851 1852 1853 1854
		epq->rti = rti;
		endNode = false;
	}

1855
	Assert(epq->rti == rti);
1856 1857

	/*
1858 1859
	 * Ok - we're requested for the same RTE.  Unfortunately we still have
	 * to end and restart execution of the plan, because ExecReScan
1860
	 * wouldn't ensure that upper plan nodes would reset themselves.  We
1861 1862 1863
	 * could make that work if insertion of the target tuple were
	 * integrated with the Param mechanism somehow, so that the upper plan
	 * nodes know that their children's outputs have changed.
1864 1865 1866 1867 1868
	 *
	 * Note that the stack of free evalPlanQual nodes is quite useless at
	 * the moment, since it only saves us from pallocing/releasing the
	 * evalPlanQual nodes themselves.  But it will be useful once we
	 * implement ReScan instead of end/restart for re-using PlanQual nodes.
1869 1870
	 */
	if (endNode)
1871
	{
1872
		/* stop execution */
1873
		EvalPlanQualStop(epq);
1874
	}
1875

1876 1877 1878 1879 1880 1881 1882 1883 1884 1885
	/*
	 * Initialize new recheck query.
	 *
	 * Note: if we were re-using PlanQual plans via ExecReScan, we'd need
	 * to instead copy down changeable state from the top plan (including
	 * es_result_relation_info, es_junkFilter) and reset locally changeable
	 * state in the epq (including es_param_exec_vals, es_evTupleNull).
	 */
	EvalPlanQualStart(epq, estate, epq->next);

1886
	/*
1887 1888
	 * free old RTE' tuple, if any, and store target tuple where
	 * relation's scan node will see it
1889
	 */
1890
	epqstate = epq->estate;
1891 1892 1893
	if (epqstate->es_evTuple[rti - 1] != NULL)
		heap_freetuple(epqstate->es_evTuple[rti - 1]);
	epqstate->es_evTuple[rti - 1] = copyTuple;
1894

1895
	return EvalPlanQualNext(estate);
1896 1897
}

B
Bruce Momjian 已提交
1898
static TupleTableSlot *
1899 1900
EvalPlanQualNext(EState *estate)
{
1901 1902
	evalPlanQual *epq = estate->es_evalPlanQual;
	MemoryContext oldcontext;
B
Bruce Momjian 已提交
1903
	TupleTableSlot *slot;
1904 1905 1906 1907

	Assert(epq->rti != 0);

lpqnext:;
1908
	oldcontext = MemoryContextSwitchTo(epq->estate->es_query_cxt);
1909
	slot = ExecProcNode(epq->planstate);
1910
	MemoryContextSwitchTo(oldcontext);
1911 1912 1913 1914 1915 1916

	/*
	 * No more tuples for this PQ. Continue previous one.
	 */
	if (TupIsNull(slot))
	{
1917 1918
		evalPlanQual *oldepq;

1919
		/* stop execution */
1920
		EvalPlanQualStop(epq);
1921
		/* pop old PQ from the stack */
1922 1923
		oldepq = epq->next;
		if (oldepq == NULL)
1924
		{
1925 1926 1927 1928 1929
			/* this is the first (oldest) PQ - mark as free */
			epq->rti = 0;
			estate->es_useEvalPlan = false;
			/* and continue Query execution */
			return (NULL);
1930 1931 1932 1933 1934
		}
		Assert(oldepq->rti != 0);
		/* push current PQ to freePQ stack */
		oldepq->free = epq;
		epq = oldepq;
1935
		estate->es_evalPlanQual = epq;
1936 1937 1938 1939 1940
		goto lpqnext;
	}

	return (slot);
}
1941 1942 1943 1944

static void
EndEvalPlanQual(EState *estate)
{
1945
	evalPlanQual *epq = estate->es_evalPlanQual;
1946

1947 1948
	if (epq->rti == 0)			/* plans already shutdowned */
	{
1949
		Assert(epq->next == NULL);
1950
		return;
1951
	}
1952 1953 1954

	for (;;)
	{
1955 1956
		evalPlanQual *oldepq;

1957
		/* stop execution */
1958
		EvalPlanQualStop(epq);
1959
		/* pop old PQ from the stack */
1960 1961
		oldepq = epq->next;
		if (oldepq == NULL)
1962
		{
1963 1964 1965
			/* this is the first (oldest) PQ - mark as free */
			epq->rti = 0;
			estate->es_useEvalPlan = false;
1966 1967 1968 1969 1970 1971
			break;
		}
		Assert(oldepq->rti != 0);
		/* push current PQ to freePQ stack */
		oldepq->free = epq;
		epq = oldepq;
1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014
		estate->es_evalPlanQual = epq;
	}
}

/*
 * Start execution of one level of PlanQual.
 *
 * This is a cut-down version of ExecutorStart(): we copy some state from
 * the top-level estate rather than initializing it fresh.
 */
static void
EvalPlanQualStart(evalPlanQual *epq, EState *estate, evalPlanQual *priorepq)
{
	EState	   *epqstate;
	int			rtsize;
	MemoryContext oldcontext;

	rtsize = length(estate->es_range_table);

	epq->estate = epqstate = CreateExecutorState();

	oldcontext = MemoryContextSwitchTo(epqstate->es_query_cxt);

	/*
	 * The epqstates share the top query's copy of unchanging state such
	 * as the snapshot, rangetable, result-rel info, and external Param info.
	 * They need their own copies of local state, including a tuple table,
	 * es_param_exec_vals, etc.
	 */
	epqstate->es_direction = ForwardScanDirection;
	epqstate->es_snapshot = estate->es_snapshot;
	epqstate->es_range_table = estate->es_range_table;
	epqstate->es_result_relations = estate->es_result_relations;
	epqstate->es_num_result_relations = estate->es_num_result_relations;
	epqstate->es_result_relation_info = estate->es_result_relation_info;
	epqstate->es_junkFilter = estate->es_junkFilter;
	epqstate->es_into_relation_descriptor = estate->es_into_relation_descriptor;
	epqstate->es_param_list_info = estate->es_param_list_info;
	if (estate->es_topPlan->nParamExec > 0)
		epqstate->es_param_exec_vals = (ParamExecData *)
			palloc0(estate->es_topPlan->nParamExec * sizeof(ParamExecData));
	epqstate->es_rowMark = estate->es_rowMark;
	epqstate->es_instrument = estate->es_instrument;
2015
	epqstate->es_force_oids = estate->es_force_oids;
2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063
	epqstate->es_topPlan = estate->es_topPlan;
	/*
	 * Each epqstate must have its own es_evTupleNull state, but
	 * all the stack entries share es_evTuple state.  This allows
	 * sub-rechecks to inherit the value being examined by an
	 * outer recheck.
	 */
	epqstate->es_evTupleNull = (bool *) palloc0(rtsize * sizeof(bool));
	if (priorepq == NULL)
		/* first PQ stack entry */
		epqstate->es_evTuple = (HeapTuple *)
			palloc0(rtsize * sizeof(HeapTuple));
	else
		/* later stack entries share the same storage */
		epqstate->es_evTuple = priorepq->estate->es_evTuple;

	epqstate->es_tupleTable =
		ExecCreateTupleTable(estate->es_tupleTable->size);

	epq->planstate = ExecInitNode(estate->es_topPlan, epqstate);

	MemoryContextSwitchTo(oldcontext);
}

/*
 * End execution of one level of PlanQual.
 *
 * This is a cut-down version of ExecutorEnd(); basically we want to do most
 * of the normal cleanup, but *not* close result relations (which we are
 * just sharing from the outer query).
 */
static void
EvalPlanQualStop(evalPlanQual *epq)
{
	EState	   *epqstate = epq->estate;
	MemoryContext oldcontext;

	oldcontext = MemoryContextSwitchTo(epqstate->es_query_cxt);

	ExecEndNode(epq->planstate);

	ExecDropTupleTable(epqstate->es_tupleTable, true);
	epqstate->es_tupleTable = NULL;

	if (epqstate->es_evTuple[epq->rti - 1] != NULL)
	{
		heap_freetuple(epqstate->es_evTuple[epq->rti - 1]);
		epqstate->es_evTuple[epq->rti - 1] = NULL;
2064
	}
2065 2066 2067 2068 2069 2070 2071

	MemoryContextSwitchTo(oldcontext);

	FreeExecutorState(epqstate);

	epq->estate = NULL;
	epq->planstate = NULL;
2072
}