execMain.c 53.1 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.209 2003/05/08 18:16:36 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, bool explainOnly);
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
			CmdType operation,
			long numberTuples,
			ScanDirection direction,
75
			DestReceiver *dest);
76
static void ExecSelect(TupleTableSlot *slot,
77
		   DestReceiver *dest,
B
Bruce Momjian 已提交
78
		   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 109
 * If explainOnly is true, we are not actually intending to run the plan,
 * only to set up for EXPLAIN; so skip unwanted side-effects.
 *
110 111
 * NB: the CurrentMemoryContext when this is called will become the parent
 * of the per-query context used for this Executor invocation.
112 113
 * ----------------------------------------------------------------
 */
114
void
115
ExecutorStart(QueryDesc *queryDesc, bool explainOnly)
116
{
117
	EState	   *estate;
118
	MemoryContext oldcontext;
119

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

124 125 126 127 128 129 130
	/*
	 * If the transaction is read-only, we need to check if any writes
	 * are planned to non-temporary tables.
	 */
	if (!explainOnly)
		ExecCheckXactReadOnly(queryDesc->parsetree, queryDesc->operation);

131
	/*
132
	 * Build EState, switch into per-query memory context for startup.
133 134 135 136
	 */
	estate = CreateExecutorState();
	queryDesc->estate = estate;

137 138 139 140 141
	oldcontext = MemoryContextSwitchTo(estate->es_query_cxt);

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

V
Vadim B. Mikheev 已提交
144
	if (queryDesc->plantree->nParamExec > 0)
145
		estate->es_param_exec_vals = (ParamExecData *)
146
			palloc0(queryDesc->plantree->nParamExec * sizeof(ParamExecData));
147

148 149
	estate->es_instrument = queryDesc->doInstrument;

150
	/*
151 152
	 * Make our own private copy of the current query snapshot data.
	 *
B
Bruce Momjian 已提交
153 154 155
	 * 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.
156
	 */
157
	estate->es_snapshot = CopyQuerySnapshot();
158

159
	/*
160
	 * Initialize the plan state tree
161
	 */
162
	InitPlan(queryDesc, explainOnly);
163 164

	MemoryContextSwitchTo(oldcontext);
165 166 167
}

/* ----------------------------------------------------------------
168 169 170 171 172 173 174
 *		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.
175
 *
176 177 178
 *		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.
179
 *
180
 *		Note: count = 0 is interpreted as no portal limit, i.e., run to
181
 *		completion.
182
 *
183 184
 * ----------------------------------------------------------------
 */
185
TupleTableSlot *
186
ExecutorRun(QueryDesc *queryDesc,
187
			ScanDirection direction, long count)
188
{
189
	EState	   *estate;
190
	CmdType		operation;
191
	DestReceiver *dest;
192
	TupleTableSlot *result;
193 194 195 196 197 198 199 200
	MemoryContext oldcontext;

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

	estate = queryDesc->estate;

	Assert(estate != NULL);
201

B
Bruce Momjian 已提交
202
	/*
203
	 * Switch into per-query memory context
204
	 */
205
	oldcontext = MemoryContextSwitchTo(estate->es_query_cxt);
206

B
Bruce Momjian 已提交
207
	/*
B
Bruce Momjian 已提交
208 209
	 * extract information from the query descriptor and the query
	 * feature.
210
	 */
211 212 213
	operation = queryDesc->operation;
	dest = queryDesc->dest;

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

220
	(*dest->startup) (dest, operation, queryDesc->tupDesc);
221

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

235 236 237
	/*
	 * shutdown receiver
	 */
238
	(*dest->shutdown) (dest);
239

240 241
	MemoryContextSwitchTo(oldcontext);

242
	return result;
243 244 245
}

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

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

261 262
	estate = queryDesc->estate;

263
	Assert(estate != NULL);
264

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

	ExecEndPlan(queryDesc->planstate, estate);
271

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

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

	/* Reset queryDesc fields that no longer point to anything */
	queryDesc->tupDesc = NULL;
	queryDesc->estate = NULL;
	queryDesc->planstate = NULL;
287
}
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
/* ----------------------------------------------------------------
 *		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);
}

325

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

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

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

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

B
Bruce Momjian 已提交
354
	/*
355 356 357 358 359 360 361 362 363 364 365 366
	 * 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 已提交
367
	 */
368
	if (rte->rtekind != RTE_RELATION)
369 370
		return;

371
	relOid = rte->relid;
372 373

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

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

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

	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.
		 */
400 401 402
		switch (operation)
		{
			case CMD_INSERT:
403
				aclcheck_result = CHECK(ACL_INSERT);
404
				break;
405
			case CMD_SELECT:
406
			case CMD_UPDATE:
407 408 409 410
				aclcheck_result = CHECK(ACL_UPDATE);
				break;
			case CMD_DELETE:
				aclcheck_result = CHECK(ACL_DELETE);
411 412 413 414
				break;
			default:
				elog(ERROR, "ExecCheckRTEPerms: bogus operation %d",
					 operation);
415
				aclcheck_result = ACLCHECK_OK;	/* keep compiler quiet */
416 417
				break;
		}
418
		if (aclcheck_result != ACLCHECK_OK)
419
			aclcheck_error(aclcheck_result, get_rel_name(relOid));
420
	}
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
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;

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

			goto fail;
		}
	}

	return;

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


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

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

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

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

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

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

516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532
			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 已提交
533 534
			 * Single result relation identified by
			 * parseTree->resultRelation
535 536 537 538 539 540 541 542
			 */
			numResultRelations = 1;
			resultRelInfos = (ResultRelInfo *) palloc(sizeof(ResultRelInfo));
			initResultRelInfo(resultRelInfos,
							  parseTree->resultRelation,
							  rangeTable,
							  operation);
		}
543

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

559 560 561 562 563 564 565
	/*
	 * 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;

566
	if (operation == CMD_SELECT && parseTree->into != NULL)
567 568 569 570 571 572 573 574 575 576
	{
		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;
	}

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

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

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

B
Bruce Momjian 已提交
601
	/*
602
	 * initialize the executor "tuple" table.  We need slots for all the
603 604 605
	 * 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.
606 607
	 */
	{
608
		int			nSlots = ExecCountSlotsNode(plan);
609

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

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

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

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

B
Bruce Momjian 已提交
638
	/*
639 640 641 642 643
	 * 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 已提交
644
	 * attribute present --- no need to look first.
645 646
	 */
	{
647 648 649
		bool		junk_filter_needed = false;
		List	   *tlist;

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

					if (tle->resdom->resjunk)
					{
						junk_filter_needed = true;
						break;
					}
663
				}
664 665 666 667 668 669 670 671 672 673 674 675 676
				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;
					}
				}
677 678 679 680 681 682 683
				break;
			case CMD_UPDATE:
			case CMD_DELETE:
				junk_filter_needed = true;
				break;
			default:
				break;
684 685
		}

686
		if (junk_filter_needed)
687
		{
688
			/*
B
Bruce Momjian 已提交
689 690 691 692
			 * 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.
693 694 695
			 */
			if (parseTree->resultRelations != NIL)
			{
696 697
				PlanState **appendplans;
				int			as_nplans;
698
				ResultRelInfo *resultRelInfo;
699
				int			i;
700 701 702 703

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

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

721 722 723 724 725 726 727 728 729 730
				/*
				 * 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 */
731
				JunkFilter *j;
732

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

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

B
Bruce Momjian 已提交
749
	/*
750 751 752
	 * 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.
753 754
	 *
	 * If EXPLAIN, skip creating the "into" relation.
755 756 757
	 */
	intoRelationDesc = (Relation) NULL;

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

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

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

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

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

790
		FreeTupleDesc(tupdesc);
791

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

798 799 800 801 802 803 804
		/*
		 * 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);
805

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

	estate->es_into_relation_descriptor = intoRelationDesc;

814 815
	queryDesc->tupDesc = tupType;
	queryDesc->planstate = planstate;
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 855
/*
 * 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;
856 857
	/* make a copy so as not to depend on relcache info not changing... */
	resultRelInfo->ri_TrigDesc = CopyTriggerDesc(resultRelationDesc->trigdesc);
858
	resultRelInfo->ri_TrigFunctions = NULL;
859 860 861 862 863 864
	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 已提交
865 866
	 * index entries for the tuples we add/update.	We need not do this
	 * for a DELETE, however, since deletion doesn't affect indexes.
867 868 869 870 871 872
	 */
	if (resultRelationDesc->rd_rel->relhasindex &&
		operation != CMD_DELETE)
		ExecOpenIndices(resultRelInfo);
}

873
/* ----------------------------------------------------------------
874
 *		ExecEndPlan
875
 *
876
 *		Cleans up the query plan -- closes files and frees up storage
877 878 879 880 881 882
 *
 * 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.
883 884
 * ----------------------------------------------------------------
 */
885 886
void
ExecEndPlan(PlanState *planstate, EState *estate)
887
{
888 889
	ResultRelInfo *resultRelInfo;
	int			i;
890
	List	   *l;
891

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

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

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

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

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

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

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

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

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

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

981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996
	/*
	 * 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 */
997
			break;
998 999
	}

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

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

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

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

B
Bruce Momjian 已提交
1033
		/*
B
Bruce Momjian 已提交
1034 1035
		 * if we have a junk filter, then project a new tuple with the
		 * junk removed.
1036
		 *
1037 1038 1039
		 * 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.)
1040
		 *
B
Bruce Momjian 已提交
1041
		 * Also, extract all the junk information we need.
1042 1043 1044
		 */
		if ((junkfilter = estate->es_junkFilter) != (JunkFilter *) NULL)
		{
1045 1046 1047
			Datum		datum;
			HeapTuple	newTuple;
			bool		isNull;
1048

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

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

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

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

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

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

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

1106 1107 1108 1109 1110 1111
						case HeapTupleMayBeUpdated:
							break;

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

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

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

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

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

B
Bruce Momjian 已提交
1151
		/*
B
Bruce Momjian 已提交
1152 1153
		 * 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 已提交
1154
		 * delete it from a relation, or modify some of its attributes.
1155 1156 1157
		 */
		switch (operation)
		{
1158
			case CMD_SELECT:
B
Bruce Momjian 已提交
1159
				ExecSelect(slot,	/* slot containing tuple */
1160
						   dest,	/* 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
ExecSelect(TupleTableSlot *slot,
1234
		   DestReceiver *dest,
1235
		   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
	 *
	 * XXX this probably ought to be replaced by a separate destination
1250 1251 1252
	 */
	if (estate->es_into_relation_descriptor != NULL)
	{
1253 1254
		heap_insert(estate->es_into_relation_descriptor, tuple,
					estate->es_snapshot->curcid);
1255 1256 1257
		IncrAppended();
	}

B
Bruce Momjian 已提交
1258
	/*
1259
	 * send the tuple to the destination
1260
	 */
1261
	(*dest->receiveTuple) (tuple, attrtype, dest);
1262 1263
	IncrRetrieved();
	(estate->es_processed)++;
1264 1265 1266
}

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

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

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

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

1302
		newtuple = ExecBRInsertTriggers(estate, resultRelInfo, tuple);
1303 1304 1305 1306 1307 1308

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

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

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

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

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

B
Bruce Momjian 已提交
1337
	/*
B
Bruce Momjian 已提交
1338
	 * process indices
1339
	 *
B
Bruce Momjian 已提交
1340 1341 1342
	 * 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.
1343
	 */
1344
	numIndices = resultRelInfo->ri_NumIndices;
1345
	if (numIndices > 0)
1346
		ExecInsertIndexTuples(slot, &(tuple->t_self), estate, false);
1347 1348

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

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

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

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

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

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

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

		case HeapTupleMayBeUpdated:
			break;

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

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

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

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

B
Bruce Momjian 已提交
1429
	/*
B
Bruce Momjian 已提交
1430 1431
	 * Note: Normally one would think that we have to delete index tuples
	 * associated with the heap tuple now..
1432
	 *
B
Bruce Momjian 已提交
1433 1434 1435
	 * ... 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
1436 1437 1438
	 */

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

/* ----------------------------------------------------------------
1443
 *		ExecUpdate
1444
 *
1445 1446 1447 1448
 *		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
1449 1450
 *		is, we don't want to get stuck in an infinite loop
 *		which corrupts your database..
1451 1452 1453
 * ----------------------------------------------------------------
 */
static void
1454
ExecUpdate(TupleTableSlot *slot,
B
Bruce Momjian 已提交
1455 1456
		   ItemPointer tupleid,
		   EState *estate)
1457
{
B
Bruce Momjian 已提交
1458
	HeapTuple	tuple;
1459
	ResultRelInfo *resultRelInfo;
B
Bruce Momjian 已提交
1460 1461 1462 1463
	Relation	resultRelationDesc;
	ItemPointerData ctid;
	int			result;
	int			numIndices;
1464

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

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

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

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

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

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

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

B
Bruce Momjian 已提交
1511
	/*
1512
	 * Check the constraints of the tuple
1513
	 *
1514 1515 1516 1517 1518
	 * 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.)
1519
	 */
1520
lreplace:;
1521
	if (resultRelationDesc->rd_att->constr)
1522
		ExecConstraints("ExecUpdate", resultRelInfo, slot, estate);
1523

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

		case HeapTupleMayBeUpdated:
			break;

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

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

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

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

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

B
Bruce Momjian 已提交
1576
	/*
B
Bruce Momjian 已提交
1577
	 * process indices
1578
	 *
1579
	 * heap_update updates a tuple in the base relation by invalidating it
1580
	 * and then inserting a new tuple to the relation.	As a side effect,
B
Bruce Momjian 已提交
1581 1582 1583
	 * 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.
1584 1585
	 */

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

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

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

1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618
	/*
	 * 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);
1619
			resultRelInfo->ri_ConstraintExprs[i] = (List *)
1620
				ExecPrepareExpr((Expr *) qual, estate);
1621 1622 1623 1624
		}
		MemoryContextSwitchTo(oldContext);
	}

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

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

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

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

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

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

	Assert(constr);
1661

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

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

1676
	if (constr->num_check > 0)
1677
	{
1678
		char	   *failed;
1679

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

1686 1687 1688 1689 1690 1691
/*
 * 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 已提交
1692
TupleTableSlot *
1693 1694
EvalPlanQual(EState *estate, Index rti, ItemPointer tid)
{
1695 1696
	evalPlanQual *epq;
	EState	   *epqstate;
B
Bruce Momjian 已提交
1697 1698
	Relation	relation;
	HeapTupleData tuple;
1699 1700
	HeapTuple	copyTuple = NULL;
	bool		endNode;
1701 1702 1703

	Assert(rti != 0);

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 1735 1736
	/*
	 * 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;

1737
		if (heap_fetch(relation, SnapshotDirty, &tuple, &buffer, false, NULL))
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 1787 1788
		{
			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;

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

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

	/*
	 * If this is request for another RTE - Ra, - then we have to check
B
Bruce Momjian 已提交
1804 1805 1806
	 * 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? -:))
1807
	 */
B
Bruce Momjian 已提交
1808
	if (epq != NULL && epq->rti != rti &&
1809
		epq->estate->es_evTuple[rti - 1] != NULL)
1810 1811 1812
	{
		do
		{
1813 1814
			evalPlanQual *oldepq;

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

B
Bruce Momjian 已提交
1827
	/*
1828 1829 1830 1831 1832 1833
	 * 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 已提交
1834
		evalPlanQual *newepq = (epq != NULL) ? epq->free : NULL;
1835

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

1857
	Assert(epq->rti == rti);
1858 1859

	/*
1860 1861
	 * Ok - we're requested for the same RTE.  Unfortunately we still have
	 * to end and restart execution of the plan, because ExecReScan
1862
	 * wouldn't ensure that upper plan nodes would reset themselves.  We
1863 1864 1865
	 * 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.
1866 1867 1868 1869 1870
	 *
	 * 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.
1871 1872
	 */
	if (endNode)
1873
	{
1874
		/* stop execution */
1875
		EvalPlanQualStop(epq);
1876
	}
1877

1878 1879 1880 1881 1882 1883 1884 1885 1886 1887
	/*
	 * 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);

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

1897
	return EvalPlanQualNext(estate);
1898 1899
}

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

	Assert(epq->rti != 0);

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

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

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

	return (slot);
}
1943 1944 1945 1946

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

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

	for (;;)
	{
1957 1958
		evalPlanQual *oldepq;

1959
		/* stop execution */
1960
		EvalPlanQualStop(epq);
1961
		/* pop old PQ from the stack */
1962 1963
		oldepq = epq->next;
		if (oldepq == NULL)
1964
		{
1965 1966 1967
			/* this is the first (oldest) PQ - mark as free */
			epq->rti = 0;
			estate->es_useEvalPlan = false;
1968 1969 1970 1971 1972 1973
			break;
		}
		Assert(oldepq->rti != 0);
		/* push current PQ to freePQ stack */
		oldepq->free = epq;
		epq = oldepq;
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 2015 2016
		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;
2017
	epqstate->es_force_oids = estate->es_force_oids;
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 2064 2065
	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;
2066
	}
2067 2068 2069 2070 2071 2072 2073

	MemoryContextSwitchTo(oldcontext);

	FreeExecutorState(epqstate);

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