execMain.c 47.7 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 15 16 17 18 19 20 21 22 23
 *	The old ExecutorMain() has been replaced by ExecutorStart(),
 *	ExecutorRun() and ExecutorEnd()
 *
 *	These three procedures are the external interfaces to the executor.
 *	In each case, the query descriptor and the execution state is required
 *	 as arguments
 *
 *	ExecutorStart() must be called at the beginning of any execution of any
 *	query plan and ExecutorEnd() should always be called at the end of
 *	execution of a plan.
 *
 *	ExecutorRun accepts 'feature' and 'count' arguments that specify whether
 *	the plan is to be executed forwards, backwards, and for how many tuples.
24
 *
25
 * Portions Copyright (c) 1996-2001, PostgreSQL Global Development Group
B
Add:  
Bruce Momjian 已提交
26
 * Portions Copyright (c) 1994, Regents of the University of California
27 28 29
 *
 *
 * IDENTIFICATION
30
 *	  $Header: /cvsroot/pgsql/src/backend/executor/execMain.c,v 1.138 2001/01/29 00:39:18 tgl Exp $
31 32 33
 *
 *-------------------------------------------------------------------------
 */
34 35
#include "postgres.h"

36 37
#include "access/heapam.h"
#include "catalog/heap.h"
38
#include "commands/command.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

47 48

/* decls for local routines only used within this module */
49
static TupleDesc InitPlan(CmdType operation,
B
Bruce Momjian 已提交
50 51 52
		 Query *parseTree,
		 Plan *plan,
		 EState *estate);
53 54 55 56
static void initResultRelInfo(ResultRelInfo *resultRelInfo,
							  Index resultRelationIndex,
							  List *rangeTable,
							  CmdType operation);
57
static void EndPlan(Plan *plan, EState *estate);
58
static TupleTableSlot *ExecutePlan(EState *estate, Plan *plan,
59 60 61 62
								   CmdType operation,
								   long numberTuples,
								   ScanDirection direction,
								   DestReceiver *destfunc);
63
static void ExecRetrieve(TupleTableSlot *slot,
64
			 DestReceiver *destfunc,
B
Bruce Momjian 已提交
65
			 EState *estate);
66
static void ExecAppend(TupleTableSlot *slot, ItemPointer tupleid,
B
Bruce Momjian 已提交
67
		   EState *estate);
68
static void ExecDelete(TupleTableSlot *slot, ItemPointer tupleid,
B
Bruce Momjian 已提交
69
		   EState *estate);
70
static void ExecReplace(TupleTableSlot *slot, ItemPointer tupleid,
B
Bruce Momjian 已提交
71
			EState *estate);
72
static TupleTableSlot *EvalPlanQualNext(EState *estate);
73
static void EndEvalPlanQual(EState *estate);
74
static void ExecCheckQueryPerms(CmdType operation, Query *parseTree,
75 76 77 78 79
								Plan *plan);
static void ExecCheckPlanPerms(Plan *plan, List *rangeTable,
							   CmdType operation);
static void ExecCheckRTPerms(List *rangeTable, CmdType operation);
static void ExecCheckRTEPerms(RangeTblEntry *rte, CmdType operation);
80

81 82
/* end of local decls */

83

84
/* ----------------------------------------------------------------
85 86 87 88 89
 *		ExecutorStart
 *
 *		This routine must be called at the beginning of any execution of any
 *		query plan
 *
90
 *		returns a TupleDesc which describes the attributes of the tuples to
91
 *		be returned by the query.
92
 *
93 94 95
 * NB: the CurrentMemoryContext when this is called must be the context
 * to be used as the per-query context for the query plan.  ExecutorRun()
 * and ExecutorEnd() must be called in this same memory context.
96 97 98
 * ----------------------------------------------------------------
 */
TupleDesc
99
ExecutorStart(QueryDesc *queryDesc, EState *estate)
100
{
101
	TupleDesc	result;
102 103 104

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

V
Vadim B. Mikheev 已提交
106 107
	if (queryDesc->plantree->nParamExec > 0)
	{
108 109
		estate->es_param_exec_vals = (ParamExecData *)
			palloc(queryDesc->plantree->nParamExec * sizeof(ParamExecData));
110 111
		MemSet(estate->es_param_exec_vals, 0,
			   queryDesc->plantree->nParamExec * sizeof(ParamExecData));
V
Vadim B. Mikheev 已提交
112
	}
113

114 115 116
	/*
	 * Make our own private copy of the current queries snapshot data
	 */
117
	if (QuerySnapshot == NULL)
J
Jan Wieck 已提交
118
		estate->es_snapshot = NULL;
119
	else
120
	{
B
Bruce Momjian 已提交
121
		estate->es_snapshot = (Snapshot) palloc(sizeof(SnapshotData));
122 123 124 125
		memcpy(estate->es_snapshot, QuerySnapshot, sizeof(SnapshotData));
		if (estate->es_snapshot->xcnt > 0)
		{
			estate->es_snapshot->xip = (TransactionId *)
B
Bruce Momjian 已提交
126
				palloc(estate->es_snapshot->xcnt * sizeof(TransactionId));
127
			memcpy(estate->es_snapshot->xip, QuerySnapshot->xip,
B
Bruce Momjian 已提交
128
				   estate->es_snapshot->xcnt * sizeof(TransactionId));
129
		}
130
	}
131

132 133 134
	/*
	 * Initialize the plan
	 */
135 136 137 138 139 140
	result = InitPlan(queryDesc->operation,
					  queryDesc->parsetree,
					  queryDesc->plantree,
					  estate);

	return result;
141 142 143
}

/* ----------------------------------------------------------------
144 145 146 147 148 149 150
 *		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.
151
 *
152 153 154 155 156 157
 *		the different features supported are:
 *			 EXEC_RUN:	retrieve all tuples in the forward direction
 *			 EXEC_FOR:	retrieve 'count' number of tuples in the forward dir
 *			 EXEC_BACK: retrieve 'count' number of tuples in the backward dir
 *			 EXEC_RETONE: return one tuple but don't 'retrieve' it
 *						   used in postquel function processing
158
 *
159 160
 *		Note: count = 0 is interpreted as "no limit".
 *
161 162
 * ----------------------------------------------------------------
 */
163
TupleTableSlot *
164
ExecutorRun(QueryDesc *queryDesc, EState *estate, int feature, long count)
165
{
B
Bruce Momjian 已提交
166 167
	CmdType		operation;
	Plan	   *plan;
168
	TupleTableSlot *result;
B
Bruce Momjian 已提交
169 170
	CommandDest dest;
	DestReceiver *destfunc;
171

B
Bruce Momjian 已提交
172
	/*
B
Bruce Momjian 已提交
173
	 * sanity checks
174
	 */
175 176
	Assert(queryDesc != NULL);

B
Bruce Momjian 已提交
177
	/*
B
Bruce Momjian 已提交
178 179
	 * extract information from the query descriptor and the query
	 * feature.
180
	 */
181 182 183
	operation = queryDesc->operation;
	plan = queryDesc->plantree;
	dest = queryDesc->dest;
184
	destfunc = DestToFunction(dest);
185 186 187
	estate->es_processed = 0;
	estate->es_lastoid = InvalidOid;

B
Bruce Momjian 已提交
188
	/*
B
Bruce Momjian 已提交
189 190 191 192
	 * FIXME: the dest setup function ought to be handed the tuple desc
	 * for the tuples to be output, but I'm not quite sure how to get that
	 * info at this point.	For now, passing NULL is OK because no
	 * existing dest setup function actually uses the pointer.
193 194 195
	 */
	(*destfunc->setup) (destfunc, (TupleDesc) NULL);

196 197
	switch (feature)
	{
198 199 200 201
		case EXEC_RUN:
			result = ExecutePlan(estate,
								 plan,
								 operation,
202
								 count,
203
								 ForwardScanDirection,
204
								 destfunc);
205
			break;
206

207 208 209 210 211 212
		case EXEC_FOR:
			result = ExecutePlan(estate,
								 plan,
								 operation,
								 count,
								 ForwardScanDirection,
213
								 destfunc);
214
			break;
215

B
Bruce Momjian 已提交
216
			/*
B
Bruce Momjian 已提交
217
			 * retrieve next n "backward" tuples
218 219 220 221 222 223 224
			 */
		case EXEC_BACK:
			result = ExecutePlan(estate,
								 plan,
								 operation,
								 count,
								 BackwardScanDirection,
225
								 destfunc);
226
			break;
227

B
Bruce Momjian 已提交
228
			/*
B
Bruce Momjian 已提交
229 230
			 * return one tuple but don't "retrieve" it. (this is used by
			 * the rule manager..) -cim 9/14/89
231 232 233 234 235 236 237
			 */
		case EXEC_RETONE:
			result = ExecutePlan(estate,
								 plan,
								 operation,
								 ONE_TUPLE,
								 ForwardScanDirection,
238
								 destfunc);
239
			break;
240

241 242
		default:
			elog(DEBUG, "ExecutorRun: Unknown feature %d", feature);
243
			result = NULL;
244
			break;
245 246
	}

247 248
	(*destfunc->cleanup) (destfunc);

249
	return result;
250 251 252
}

/* ----------------------------------------------------------------
253 254
 *		ExecutorEnd
 *
255
 *		This routine must be called at the end of execution of any
256
 *		query plan
257 258 259
 * ----------------------------------------------------------------
 */
void
260
ExecutorEnd(QueryDesc *queryDesc, EState *estate)
261
{
262 263
	/* sanity checks */
	Assert(queryDesc != NULL);
264

265
	EndPlan(queryDesc->plantree, estate);
266

267
	if (estate->es_snapshot != NULL)
B
Bruce Momjian 已提交
268 269 270 271
	{
		if (estate->es_snapshot->xcnt > 0)
			pfree(estate->es_snapshot->xip);
		pfree(estate->es_snapshot);
272
		estate->es_snapshot = NULL;
273 274
	}

275
	if (estate->es_param_exec_vals != NULL)
B
Bruce Momjian 已提交
276 277 278
	{
		pfree(estate->es_param_exec_vals);
		estate->es_param_exec_vals = NULL;
279
	}
280 281
}

282 283 284 285 286 287 288

/*
 * ExecCheckQueryPerms
 *		Check access permissions for all relations referenced in a query.
 */
static void
ExecCheckQueryPerms(CmdType operation, Query *parseTree, Plan *plan)
289
{
290 291 292
	/*
	 * Check RTEs in the query's primary rangetable.
	 */
293
	ExecCheckRTPerms(parseTree->rtable, operation);
294

295 296 297
	/*
	 * Search for subplans and APPEND nodes to check their rangetables.
	 */
298
	ExecCheckPlanPerms(plan, parseTree->rtable, operation);
299 300 301 302 303 304 305 306
}

/*
 * ExecCheckPlanPerms
 *		Recursively scan the plan tree to check access permissions in
 *		subplans.
 */
static void
307
ExecCheckPlanPerms(Plan *plan, List *rangeTable, CmdType operation)
308 309 310 311 312 313 314 315 316 317
{
	List	   *subp;

	if (plan == NULL)
		return;

	/* Check subplans, which we assume are plain SELECT queries */

	foreach(subp, plan->initPlan)
	{
318
		SubPlan    *subplan = (SubPlan *) lfirst(subp);
319

320 321
		ExecCheckRTPerms(subplan->rtable, CMD_SELECT);
		ExecCheckPlanPerms(subplan->plan, subplan->rtable, CMD_SELECT);
322 323 324
	}
	foreach(subp, plan->subPlan)
	{
325
		SubPlan    *subplan = (SubPlan *) lfirst(subp);
M
Marc G. Fournier 已提交
326

327 328
		ExecCheckRTPerms(subplan->rtable, CMD_SELECT);
		ExecCheckPlanPerms(subplan->plan, subplan->rtable, CMD_SELECT);
329 330 331 332
	}

	/* Check lower plan nodes */

333 334
	ExecCheckPlanPerms(plan->lefttree, rangeTable, operation);
	ExecCheckPlanPerms(plan->righttree, rangeTable, operation);
335 336 337 338 339

	/* Do node-type-specific checks */

	switch (nodeTag(plan))
	{
340 341 342 343 344 345 346 347 348 349 350
		case T_SubqueryScan:
			{
				SubqueryScan   *scan = (SubqueryScan *) plan;
				RangeTblEntry *rte;

				/* Recursively check the subquery */
				rte = rt_fetch(scan->scan.scanrelid, rangeTable);
				Assert(rte->subquery != NULL);
				ExecCheckQueryPerms(operation, rte->subquery, scan->subplan);
				break;
			}
351
		case T_Append:
352
			{
353 354
				Append	   *app = (Append *) plan;
				List	   *appendplans;
355

356
				foreach(appendplans, app->appendplans)
357
				{
358 359 360
					ExecCheckPlanPerms((Plan *) lfirst(appendplans),
									   rangeTable,
									   operation);
361
				}
362
				break;
363 364 365
			}

		default:
366
			break;
367
	}
368
}
369

370 371 372 373 374
/*
 * ExecCheckRTPerms
 *		Check access permissions for all relations listed in a range table.
 */
static void
375
ExecCheckRTPerms(List *rangeTable, CmdType operation)
376 377 378 379
{
	List	   *lp;

	foreach(lp, rangeTable)
380
	{
381 382
		RangeTblEntry *rte = lfirst(lp);

383
		ExecCheckRTEPerms(rte, operation);
384 385 386 387 388 389 390 391
	}
}

/*
 * ExecCheckRTEPerms
 *		Check access permissions for a single RTE.
 */
static void
392
ExecCheckRTEPerms(RangeTblEntry *rte, CmdType operation)
393 394
{
	char	   *relName;
395
	Oid			userid;
396 397
	int32		aclcheck_result;

398 399 400 401 402
	/*
	 * If it's a subquery RTE, ignore it --- it will be checked when
	 * ExecCheckPlanPerms finds the SubqueryScan node for it.
	 */
	if (rte->subquery)
403 404 405 406 407
		return;

	relName = rte->relname;

	/*
408 409
	 * userid to check as: current user unless we have a setuid indication.
	 *
410
	 * Note: GetUserId() is presently fast enough that there's no harm
411
	 * in calling it separately for each RTE.  If that stops being true,
412
	 * we could call it once in ExecCheckQueryPerms and pass the userid
413 414
	 * down from there.  But for now, no need for the extra clutter.
	 */
415
	userid = rte->checkAsUser ? rte->checkAsUser : GetUserId();
416

417
#define CHECK(MODE)		pg_aclcheck(relName, userid, MODE)
418

419
	if (rte->checkForRead)
420
	{
421 422 423 424 425 426 427 428 429 430 431 432 433
		aclcheck_result = CHECK(ACL_RD);
		if (aclcheck_result != ACLCHECK_OK)
			elog(ERROR, "%s: %s",
				 relName, aclcheck_error_strings[aclcheck_result]);
	}

	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.
		 */
434 435 436 437 438 439 440 441
		switch (operation)
		{
			case CMD_INSERT:
				/* Accept either APPEND or WRITE access for this */
				aclcheck_result = CHECK(ACL_AP);
				if (aclcheck_result != ACLCHECK_OK)
					aclcheck_result = CHECK(ACL_WR);
				break;
442
			case CMD_SELECT:
443 444 445 446 447 448 449
			case CMD_DELETE:
			case CMD_UPDATE:
				aclcheck_result = CHECK(ACL_WR);
				break;
			default:
				elog(ERROR, "ExecCheckRTEPerms: bogus operation %d",
					 operation);
450
				aclcheck_result = ACLCHECK_OK;	/* keep compiler quiet */
451 452
				break;
		}
453 454 455
		if (aclcheck_result != ACLCHECK_OK)
			elog(ERROR, "%s: %s",
				 relName, aclcheck_error_strings[aclcheck_result]);
456
	}
457 458
}

459

460 461 462 463 464 465 466
/* ===============================================================
 * ===============================================================
						 static routines follow
 * ===============================================================
 * ===============================================================
 */

467 468 469
typedef struct execRowMark
{
	Relation	relation;
470
	Index		rti;
471
	char		resname[32];
472
} execRowMark;
473

474 475
typedef struct evalPlanQual
{
B
Bruce Momjian 已提交
476 477 478 479
	Plan	   *plan;
	Index		rti;
	EState		estate;
	struct evalPlanQual *free;
480
} evalPlanQual;
481

482
/* ----------------------------------------------------------------
483 484 485 486
 *		InitPlan
 *
 *		Initializes the query plan: open files, allocate storage
 *		and start up the rule manager
487 488
 * ----------------------------------------------------------------
 */
489
static TupleDesc
490
InitPlan(CmdType operation, Query *parseTree, Plan *plan, EState *estate)
491
{
B
Bruce Momjian 已提交
492 493 494
	List	   *rangeTable;
	Relation	intoRelationDesc;
	TupleDesc	tupType;
495

496 497 498 499 500
	/*
	 * Do permissions checks.
	 */
	ExecCheckQueryPerms(operation, parseTree, plan);

B
Bruce Momjian 已提交
501
	/*
B
Bruce Momjian 已提交
502
	 * get information from query descriptor
503
	 */
504
	rangeTable = parseTree->rtable;
505

B
Bruce Momjian 已提交
506
	/*
B
Bruce Momjian 已提交
507
	 * initialize the node's execution state
508
	 */
509 510
	estate->es_range_table = rangeTable;

B
Bruce Momjian 已提交
511
	/*
512
	 * if there is a result relation, initialize result relation stuff
513
	 */
514
	if (parseTree->resultRelation != 0 && operation != CMD_SELECT)
515
	{
516 517 518
		List	   *resultRelations = parseTree->resultRelations;
		int			numResultRelations;
		ResultRelInfo *resultRelInfos;
B
Bruce Momjian 已提交
519

520 521 522 523 524 525 526
		if (resultRelations != NIL)
		{
			/*
			 * Multiple result relations (due to inheritance)
			 * parseTree->resultRelations identifies them all
			 */
			ResultRelInfo *resultRelInfo;
527

528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553
			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
		{
			/*
			 * Single result relation identified by parseTree->resultRelation
			 */
			numResultRelations = 1;
			resultRelInfos = (ResultRelInfo *) palloc(sizeof(ResultRelInfo));
			initResultRelInfo(resultRelInfos,
							  parseTree->resultRelation,
							  rangeTable,
							  operation);
		}
554

555 556 557 558
		estate->es_result_relations = resultRelInfos;
		estate->es_num_result_relations = numResultRelations;
		/* Initialize to first or only result rel */
		estate->es_result_relation_info = resultRelInfos;
559
	}
560 561
	else
	{
B
Bruce Momjian 已提交
562
		/*
B
Bruce Momjian 已提交
563
		 * if no result relation, then set state appropriately
564
		 */
565 566
		estate->es_result_relations = NULL;
		estate->es_num_result_relations = 0;
567 568 569
		estate->es_result_relation_info = NULL;
	}

570 571 572
	/*
	 * Have to lock relations selected for update
	 */
573 574
	estate->es_rowMark = NIL;
	if (parseTree->rowMarks != NIL)
575
	{
B
Bruce Momjian 已提交
576
		List	   *l;
577

578
		foreach(l, parseTree->rowMarks)
579
		{
580 581
			Index		rti = lfirsti(l);
			Oid			relid = getrelid(rti, rangeTable);
582 583 584 585
			Relation	relation;
			execRowMark *erm;

			relation = heap_open(relid, RowShareLock);
B
Bruce Momjian 已提交
586
			erm = (execRowMark *) palloc(sizeof(execRowMark));
587
			erm->relation = relation;
588 589
			erm->rti = rti;
			sprintf(erm->resname, "ctid%u", rti);
590 591 592
			estate->es_rowMark = lappend(estate->es_rowMark, erm);
		}
	}
593

B
Bruce Momjian 已提交
594
	/*
B
Bruce Momjian 已提交
595
	 * initialize the executor "tuple" table.
596 597
	 */
	{
598 599
		int			nSlots = ExecCountSlotsNode(plan);
		TupleTable	tupleTable = ExecCreateTupleTable(nSlots + 10);		/* why add ten? - jolly */
600

601 602
		estate->es_tupleTable = tupleTable;
	}
603

B
Bruce Momjian 已提交
604
	/*
B
Bruce Momjian 已提交
605 606
	 * initialize the private state information for all the nodes in the
	 * query tree.	This opens files, allocates storage and leaves us
607
	 * ready to start processing tuples.
608 609 610
	 */
	ExecInitNode(plan, estate, NULL);

B
Bruce Momjian 已提交
611
	/*
612
	 * Get the tuple descriptor describing the type of tuples to return.
B
Bruce Momjian 已提交
613 614
	 * (this is especially important if we are creating a relation with
	 * "retrieve into")
615 616 617
	 */
	tupType = ExecGetTupType(plan);		/* tuple descriptor */

B
Bruce Momjian 已提交
618
	/*
619 620 621 622
	 * Initialize the junk filter if needed. SELECT and INSERT queries need
	 * a filter if there are any junk attrs in the tlist.  UPDATE and
	 * DELETE always need one, since there's always a junk 'ctid' attribute
	 * present --- no need to look first.
623 624
	 */
	{
625 626 627
		bool		junk_filter_needed = false;
		List	   *tlist;

628
		switch (operation)
629
		{
630 631
			case CMD_SELECT:
			case CMD_INSERT:
632
				foreach(tlist, plan->targetlist)
633
				{
634 635 636 637 638 639 640
					TargetEntry *tle = (TargetEntry *) lfirst(tlist);

					if (tle->resdom->resjunk)
					{
						junk_filter_needed = true;
						break;
					}
641
				}
642 643 644 645 646 647 648
				break;
			case CMD_UPDATE:
			case CMD_DELETE:
				junk_filter_needed = true;
				break;
			default:
				break;
649 650
		}

651
		if (junk_filter_needed)
652
		{
653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 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.
			 */
			if (parseTree->resultRelations != NIL)
			{
				List	   *subplans;
				ResultRelInfo *resultRelInfo;

				/* Top plan had better be an Append here. */
				Assert(IsA(plan, Append));
				Assert(((Append *) plan)->isTarget);
				subplans = ((Append *) plan)->appendplans;
				Assert(length(subplans) == estate->es_num_result_relations);
				resultRelInfo = estate->es_result_relations;
				while (subplans != NIL)
				{
					Plan	   *subplan = (Plan *) lfirst(subplans);
					JunkFilter *j;

					j = ExecInitJunkFilter(subplan->targetlist,
										   ExecGetTupType(subplan));
					resultRelInfo->ri_junkFilter = j;
					resultRelInfo++;
					subplans = lnext(subplans);
				}
				/*
				 * 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 */
				JunkFilter *j = ExecInitJunkFilter(plan->targetlist,
												   tupType);
693

694 695 696
				estate->es_junkFilter = j;
				if (estate->es_result_relation_info)
					estate->es_result_relation_info->ri_junkFilter = j;
697

698 699 700 701
				/* For SELECT, want to return the cleaned tuple type */
				if (operation == CMD_SELECT)
					tupType = j->jf_cleanTupType;
			}
702 703 704 705
		}
		else
			estate->es_junkFilter = NULL;
	}
706

B
Bruce Momjian 已提交
707
	/*
B
Bruce Momjian 已提交
708
	 * initialize the "into" relation
709 710 711 712 713
	 */
	intoRelationDesc = (Relation) NULL;

	if (operation == CMD_SELECT)
	{
714 715 716
		char	   *intoName;
		Oid			intoRelationId;
		TupleDesc	tupdesc;
717 718 719 720 721 722 723 724 725

		if (!parseTree->isPortal)
		{

			/*
			 * a select into table
			 */
			if (parseTree->into != NULL)
			{
B
Bruce Momjian 已提交
726

B
Bruce Momjian 已提交
727
				/*
B
Bruce Momjian 已提交
728
				 * create the "into" relation
729 730 731 732 733 734 735 736
				 */
				intoName = parseTree->into;

				/*
				 * have to copy tupType to get rid of constraints
				 */
				tupdesc = CreateTupleDescCopy(tupType);

737 738 739 740 741 742
				intoRelationId =
					heap_create_with_catalog(intoName,
											 tupdesc,
											 RELKIND_RELATION,
											 parseTree->isTemp,
											 allowSystemTableMods);
743

744 745
				FreeTupleDesc(tupdesc);

B
Bruce Momjian 已提交
746
				/*
747 748
				 * Advance command counter so that the newly-created
				 * relation's catalog tuples will be visible to heap_open.
749
				 */
750
				CommandCounterIncrement();
751

752
				/*
T
Tom Lane 已提交
753 754 755 756
				 * 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.
757 758 759
				 */
				AlterTableCreateToastTable(intoName, true);

760 761
				intoRelationDesc = heap_open(intoRelationId,
											 AccessExclusiveLock);
762 763 764 765 766 767
			}
		}
	}

	estate->es_into_relation_descriptor = intoRelationDesc;

768 769 770 771 772
	estate->es_origPlan = plan;
	estate->es_evalPlanQual = NULL;
	estate->es_evTuple = NULL;
	estate->es_useEvalPlan = false;

773
	return tupType;
774 775
}

776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828
/*
 * 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;
	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
	 * index entries for the tuples we add/update.	We need not do
	 * this for a DELETE, however, since deletion doesn't affect
	 * indexes.
	 */
	if (resultRelationDesc->rd_rel->relhasindex &&
		operation != CMD_DELETE)
		ExecOpenIndices(resultRelInfo);
}

829
/* ----------------------------------------------------------------
830 831 832
 *		EndPlan
 *
 *		Cleans up the query plan -- closes files and free up storages
833 834 835
 * ----------------------------------------------------------------
 */
static void
836
EndPlan(Plan *plan, EState *estate)
837
{
838 839
	ResultRelInfo *resultRelInfo;
	int			i;
840
	List	   *l;
841

842 843 844 845 846 847
	/*
	 * shut down any PlanQual processing we were doing
	 */
	if (estate->es_evalPlanQual != NULL)
		EndEvalPlanQual(estate);

B
Bruce Momjian 已提交
848
	/*
849
	 * shut down the node-type-specific query processing
850 851 852
	 */
	ExecEndNode(plan, plan);

B
Bruce Momjian 已提交
853
	/*
B
Bruce Momjian 已提交
854
	 * destroy the executor "tuple" table.
855
	 */
856 857
	ExecDropTupleTable(estate->es_tupleTable, true);
	estate->es_tupleTable = NULL;
858

B
Bruce Momjian 已提交
859
	/*
860
	 * close the result relation(s) if any, but hold locks
861
	 * until xact commit.  Also clean up junkfilters if present.
862
	 */
863 864
	resultRelInfo = estate->es_result_relations;
	for (i = estate->es_num_result_relations; i > 0; i--)
865
	{
866 867 868
		/* Close indices and then the relation itself */
		ExecCloseIndices(resultRelInfo);
		heap_close(resultRelInfo->ri_RelationDesc, NoLock);
869 870 871
		/* Delete the junkfilter if any */
		if (resultRelInfo->ri_junkFilter != NULL)
			ExecFreeJunkFilter(resultRelInfo->ri_junkFilter);
872
		resultRelInfo++;
873 874
	}

B
Bruce Momjian 已提交
875
	/*
876
	 * close the "into" relation if necessary, again keeping lock
877
	 */
878 879
	if (estate->es_into_relation_descriptor != NULL)
		heap_close(estate->es_into_relation_descriptor, NoLock);
880

881 882 883 884 885 886 887 888 889 890
	/*
	 * There might be a junkfilter without a result relation.
	 */
	if (estate->es_num_result_relations == 0 &&
		estate->es_junkFilter != NULL)
	{
		ExecFreeJunkFilter(estate->es_junkFilter);
		estate->es_junkFilter = NULL;
	}

891 892 893 894 895 896 897 898 899
	/*
	 * close any relations selected FOR UPDATE, again keeping locks
	 */
	foreach(l, estate->es_rowMark)
	{
		execRowMark *erm = lfirst(l);

		heap_close(erm->relation, NoLock);
	}
900 901 902
}

/* ----------------------------------------------------------------
903 904
 *		ExecutePlan
 *
905
 *		processes the query plan to retrieve 'numberTuples' tuples in the
906 907 908
 *		direction specified.
 *		Retrieves all tuples if tupleCount is 0
 *
909
 *		result is either a slot containing the last tuple in the case
910
 *		of a RETRIEVE or NULL otherwise.
911
 *
912 913
 * Note: the ctid attribute is a 'junk' attribute that is removed before the
 * user can see it
914 915 916
 * ----------------------------------------------------------------
 */
static TupleTableSlot *
917 918
ExecutePlan(EState *estate,
			Plan *plan,
919
			CmdType operation,
920
			long numberTuples,
921
			ScanDirection direction,
922
			DestReceiver *destfunc)
923
{
924
	JunkFilter *junkfilter;
925
	TupleTableSlot *slot;
926
	ItemPointer tupleid = NULL;
927
	ItemPointerData tuple_ctid;
928
	long		current_tuple_count;
929 930
	TupleTableSlot *result;

B
Bruce Momjian 已提交
931
	/*
B
Bruce Momjian 已提交
932
	 * initialize local variables
933
	 */
934 935 936 937
	slot = NULL;
	current_tuple_count = 0;
	result = NULL;

B
Bruce Momjian 已提交
938 939
	/*
	 * Set the direction.
940
	 */
941 942
	estate->es_direction = direction;

B
Bruce Momjian 已提交
943
	/*
B
Bruce Momjian 已提交
944
	 * Loop until we've processed the proper number of tuples from the
945
	 * plan.
946 947 948 949
	 */

	for (;;)
	{
950 951
		/* Reset the per-output-tuple exprcontext */
		ResetPerTupleExprContext(estate);
B
Bruce Momjian 已提交
952

B
Bruce Momjian 已提交
953
		/*
B
Bruce Momjian 已提交
954
		 * Execute the plan and obtain a tuple
955 956
		 */
		/* at the top level, the parent of a plan (2nd arg) is itself */
B
Bruce Momjian 已提交
957
lnext:	;
958 959 960 961 962 963 964 965
		if (estate->es_useEvalPlan)
		{
			slot = EvalPlanQualNext(estate);
			if (TupIsNull(slot))
				slot = ExecProcNode(plan, plan);
		}
		else
			slot = ExecProcNode(plan, plan);
966

B
Bruce Momjian 已提交
967
		/*
B
Bruce Momjian 已提交
968 969
		 * if the tuple is null, then we assume there is nothing more to
		 * process so we just return null...
970 971 972 973 974
		 */
		if (TupIsNull(slot))
		{
			result = NULL;
			break;
975 976
		}

B
Bruce Momjian 已提交
977
		/*
B
Bruce Momjian 已提交
978 979
		 * if we have a junk filter, then project a new tuple with the
		 * junk removed.
980
		 *
B
Bruce Momjian 已提交
981
		 * Store this new "clean" tuple in the place of the original tuple.
982
		 *
B
Bruce Momjian 已提交
983
		 * Also, extract all the junk information we need.
984 985 986
		 */
		if ((junkfilter = estate->es_junkFilter) != (JunkFilter *) NULL)
		{
987 988 989
			Datum		datum;
			HeapTuple	newTuple;
			bool		isNull;
990

B
Bruce Momjian 已提交
991
			/*
992 993 994 995 996 997 998 999 1000
			 * extract the 'ctid' junk attribute.
			 */
			if (operation == CMD_UPDATE || operation == CMD_DELETE)
			{
				if (!ExecGetJunkAttribute(junkfilter,
										  slot,
										  "ctid",
										  &datum,
										  &isNull))
1001
					elog(ERROR, "ExecutePlan: NO (junk) `ctid' was found!");
1002

1003
				/* shouldn't ever get a null result... */
1004
				if (isNull)
1005
					elog(ERROR, "ExecutePlan: (junk) `ctid' is NULL!");
1006 1007 1008 1009 1010 1011

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

B
Bruce Momjian 已提交
1016 1017
		lmark:	;
				foreach(l, estate->es_rowMark)
1018
				{
1019 1020 1021 1022 1023 1024
					execRowMark *erm = lfirst(l);
					Buffer		buffer;
					HeapTupleData tuple;
					TupleTableSlot *newSlot;
					int			test;

1025 1026 1027 1028 1029
					if (!ExecGetJunkAttribute(junkfilter,
											  slot,
											  erm->resname,
											  &datum,
											  &isNull))
1030 1031
						elog(ERROR, "ExecutePlan: NO (junk) `%s' was found!",
							 erm->resname);
1032

1033 1034 1035 1036 1037
					/*
					 * Unlike the UPDATE/DELETE case, a null result is
					 * possible here, when the referenced table is on the
					 * nullable side of an outer join.  Ignore nulls.
					 */
1038
					if (isNull)
1039
						continue;
1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052

					tuple.t_self = *((ItemPointer) DatumGetPointer(datum));
					test = heap_mark4update(erm->relation, &tuple, &buffer);
					ReleaseBuffer(buffer);
					switch (test)
					{
						case HeapTupleSelfUpdated:
						case HeapTupleMayBeUpdated:
							break;

						case HeapTupleUpdated:
							if (XactIsoLevel == XACT_SERIALIZABLE)
								elog(ERROR, "Can't serialize access due to concurrent update");
1053
							if (!(ItemPointerEquals(&(tuple.t_self),
B
Bruce Momjian 已提交
1054
								  (ItemPointer) DatumGetPointer(datum))))
1055
							{
B
Bruce Momjian 已提交
1056
								newSlot = EvalPlanQual(estate, erm->rti, &(tuple.t_self));
1057 1058 1059 1060 1061 1062 1063
								if (!(TupIsNull(newSlot)))
								{
									slot = newSlot;
									estate->es_useEvalPlan = true;
									goto lmark;
								}
							}
B
Bruce Momjian 已提交
1064 1065 1066 1067 1068

							/*
							 * if tuple was deleted or PlanQual failed for
							 * updated tuple - we have not return this
							 * tuple!
1069 1070
							 */
							goto lnext;
1071 1072 1073

						default:
							elog(ERROR, "Unknown status %u from heap_mark4update", test);
B
Bruce Momjian 已提交
1074
							return (NULL);
1075 1076 1077
					}
				}
			}
1078

B
Bruce Momjian 已提交
1079
			/*
1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091
			 * Finally create a new "clean" tuple with all junk attributes
			 * removed
			 */
			newTuple = ExecRemoveJunk(junkfilter, slot);

			slot = ExecStoreTuple(newTuple,		/* tuple to store */
								  slot, /* destination slot */
								  InvalidBuffer,		/* this tuple has no
														 * buffer */
								  true);		/* tuple should be pfreed */
		}						/* if (junkfilter... */

B
Bruce Momjian 已提交
1092
		/*
B
Bruce Momjian 已提交
1093 1094
		 * 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 已提交
1095
		 * delete it from a relation, or modify some of its attributes.
1096 1097 1098 1099
		 */

		switch (operation)
		{
1100 1101
			case CMD_SELECT:
				ExecRetrieve(slot,		/* slot containing tuple */
B
Bruce Momjian 已提交
1102 1103
							 destfunc,	/* destination's tuple-receiver
										 * obj */
1104 1105 1106
							 estate);	/* */
				result = slot;
				break;
1107

1108 1109 1110 1111
			case CMD_INSERT:
				ExecAppend(slot, tupleid, estate);
				result = NULL;
				break;
1112

1113 1114 1115 1116
			case CMD_DELETE:
				ExecDelete(slot, tupleid, estate);
				result = NULL;
				break;
1117

1118
			case CMD_UPDATE:
1119
				ExecReplace(slot, tupleid, estate);
1120 1121
				result = NULL;
				break;
1122

1123 1124
			default:
				elog(DEBUG, "ExecutePlan: unknown operation in queryDesc");
1125
				result = NULL;
1126
				break;
1127
		}
B
Bruce Momjian 已提交
1128

B
Bruce Momjian 已提交
1129
		/*
1130 1131
		 * check our tuple count.. if we've processed the proper number
		 * then quit, else loop again and process more tuples..
1132
		 */
1133
		current_tuple_count++;
1134 1135
		if (numberTuples == current_tuple_count)
			break;
1136
	}
1137

B
Bruce Momjian 已提交
1138
	/*
B
Bruce Momjian 已提交
1139 1140
	 * here, result is either a slot containing a tuple in the case of a
	 * RETRIEVE or NULL otherwise.
1141
	 */
1142
	return result;
1143 1144 1145
}

/* ----------------------------------------------------------------
1146
 *		ExecRetrieve
1147
 *
1148 1149 1150 1151 1152
 *		RETRIEVEs are easy.. we just pass the tuple to the appropriate
 *		print function.  The only complexity is when we do a
 *		"retrieve into", in which case we insert the tuple into
 *		the appropriate relation (note: this is a newly created relation
 *		so we don't need to worry about indices or locks.)
1153 1154 1155
 * ----------------------------------------------------------------
 */
static void
1156
ExecRetrieve(TupleTableSlot *slot,
1157
			 DestReceiver *destfunc,
1158
			 EState *estate)
1159
{
1160 1161
	HeapTuple	tuple;
	TupleDesc	attrtype;
1162

B
Bruce Momjian 已提交
1163
	/*
B
Bruce Momjian 已提交
1164
	 * get the heap tuple out of the tuple table slot
1165 1166 1167 1168
	 */
	tuple = slot->val;
	attrtype = slot->ttc_tupleDescriptor;

B
Bruce Momjian 已提交
1169
	/*
B
Bruce Momjian 已提交
1170
	 * insert the tuple into the "into relation"
1171 1172 1173 1174 1175 1176 1177
	 */
	if (estate->es_into_relation_descriptor != NULL)
	{
		heap_insert(estate->es_into_relation_descriptor, tuple);
		IncrAppended();
	}

B
Bruce Momjian 已提交
1178
	/*
B
Bruce Momjian 已提交
1179
	 * send the tuple to the front end (or the screen)
1180
	 */
1181
	(*destfunc->receiveTuple) (tuple, attrtype, destfunc);
1182 1183
	IncrRetrieved();
	(estate->es_processed)++;
1184 1185 1186
}

/* ----------------------------------------------------------------
1187
 *		ExecAppend
1188
 *
1189 1190 1191
 *		APPENDs are trickier.. we have to insert the tuple into
 *		the base relation and insert appropriate tuples into the
 *		index relations.
1192 1193 1194 1195
 * ----------------------------------------------------------------
 */

static void
1196
ExecAppend(TupleTableSlot *slot,
1197
		   ItemPointer tupleid,
1198
		   EState *estate)
1199
{
1200
	HeapTuple	tuple;
1201
	ResultRelInfo *resultRelInfo;
1202 1203 1204
	Relation	resultRelationDesc;
	int			numIndices;
	Oid			newId;
1205

B
Bruce Momjian 已提交
1206
	/*
B
Bruce Momjian 已提交
1207
	 * get the heap tuple out of the tuple table slot
1208 1209 1210
	 */
	tuple = slot->val;

B
Bruce Momjian 已提交
1211
	/*
1212
	 * get information on the (current) result relation
1213
	 */
1214 1215
	resultRelInfo = estate->es_result_relation_info;
	resultRelationDesc = resultRelInfo->ri_RelationDesc;
1216 1217 1218

	/* BEFORE ROW INSERT Triggers */
	if (resultRelationDesc->trigdesc &&
1219
		resultRelationDesc->trigdesc->n_before_row[TRIGGER_EVENT_INSERT] > 0)
1220
	{
1221
		HeapTuple	newtuple;
1222

1223
		newtuple = ExecBRInsertTriggers(estate, resultRelationDesc, tuple);
1224 1225 1226 1227 1228 1229

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

		if (newtuple != tuple)	/* modified by Trigger(s) */
		{
1230 1231 1232 1233 1234 1235 1236 1237
			/*
			 * Insert modified tuple into tuple table slot, replacing the
			 * original.  We assume that it was allocated in per-tuple
			 * memory context, and therefore will go away by itself.
			 * The tuple table slot should not try to clear it.
			 */
			ExecStoreTuple(newtuple, slot, InvalidBuffer, false);
			tuple = newtuple;
1238 1239 1240
		}
	}

B
Bruce Momjian 已提交
1241
	/*
1242
	 * Check the constraints of the tuple
1243 1244
	 */
	if (resultRelationDesc->rd_att->constr)
1245
		ExecConstraints("ExecAppend", resultRelInfo, slot, estate);
1246

B
Bruce Momjian 已提交
1247
	/*
B
Bruce Momjian 已提交
1248
	 * insert the tuple
1249
	 */
1250 1251
	newId = heap_insert(resultRelationDesc, tuple);

1252
	IncrAppended();
1253 1254
	(estate->es_processed)++;
	estate->es_lastoid = newId;
1255

B
Bruce Momjian 已提交
1256
	/*
B
Bruce Momjian 已提交
1257
	 * process indices
1258
	 *
B
Bruce Momjian 已提交
1259 1260 1261
	 * 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.
1262
	 */
1263
	numIndices = resultRelInfo->ri_NumIndices;
1264
	if (numIndices > 0)
1265
		ExecInsertIndexTuples(slot, &(tuple->t_self), estate, false);
1266 1267

	/* AFTER ROW INSERT Triggers */
1268
	if (resultRelationDesc->trigdesc)
1269
		ExecARInsertTriggers(estate, resultRelationDesc, tuple);
1270 1271 1272
}

/* ----------------------------------------------------------------
1273
 *		ExecDelete
1274
 *
1275 1276
 *		DELETE is like append, we delete the tuple and its
 *		index tuples.
1277 1278 1279
 * ----------------------------------------------------------------
 */
static void
1280
ExecDelete(TupleTableSlot *slot,
1281
		   ItemPointer tupleid,
1282
		   EState *estate)
1283
{
1284
	ResultRelInfo *resultRelInfo;
B
Bruce Momjian 已提交
1285 1286 1287
	Relation	resultRelationDesc;
	ItemPointerData ctid;
	int			result;
1288

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

	/* BEFORE ROW DELETE Triggers */
	if (resultRelationDesc->trigdesc &&
1297
		resultRelationDesc->trigdesc->n_before_row[TRIGGER_EVENT_DELETE] > 0)
1298
	{
1299
		bool		dodelete;
1300

V
Vadim B. Mikheev 已提交
1301
		dodelete = ExecBRDeleteTriggers(estate, tupleid);
1302 1303 1304 1305 1306

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

V
Vadim B. Mikheev 已提交
1307
	/*
B
Bruce Momjian 已提交
1308
	 * delete the tuple
1309
	 */
1310
ldelete:;
V
Vadim B. Mikheev 已提交
1311 1312 1313 1314 1315 1316 1317 1318 1319 1320
	result = heap_delete(resultRelationDesc, tupleid, &ctid);
	switch (result)
	{
		case HeapTupleSelfUpdated:
			return;

		case HeapTupleMayBeUpdated:
			break;

		case HeapTupleUpdated:
1321 1322
			if (XactIsoLevel == XACT_SERIALIZABLE)
				elog(ERROR, "Can't serialize access due to concurrent update");
1323 1324
			else if (!(ItemPointerEquals(tupleid, &ctid)))
			{
B
Bruce Momjian 已提交
1325
				TupleTableSlot *epqslot = EvalPlanQual(estate,
1326
						  resultRelInfo->ri_RangeTableIndex, &ctid);
1327

V
Vadim B. Mikheev 已提交
1328
				if (!TupIsNull(epqslot))
1329 1330 1331 1332 1333
				{
					*tupleid = ctid;
					goto ldelete;
				}
			}
V
Vadim B. Mikheev 已提交
1334 1335 1336 1337 1338 1339
			return;

		default:
			elog(ERROR, "Unknown status %u from heap_delete", result);
			return;
	}
1340 1341 1342 1343

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

B
Bruce Momjian 已提交
1344
	/*
B
Bruce Momjian 已提交
1345 1346
	 * Note: Normally one would think that we have to delete index tuples
	 * associated with the heap tuple now..
1347
	 *
B
Bruce Momjian 已提交
1348 1349 1350
	 * ... 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
1351 1352 1353
	 */

	/* AFTER ROW DELETE Triggers */
1354
	if (resultRelationDesc->trigdesc)
V
Vadim B. Mikheev 已提交
1355
		ExecARDeleteTriggers(estate, tupleid);
1356 1357 1358
}

/* ----------------------------------------------------------------
1359
 *		ExecReplace
1360
 *
1361 1362 1363 1364 1365 1366
 *		note: we can't run replace queries with transactions
 *		off because replaces are actually appends and our
 *		scan will mistakenly loop forever, replacing the tuple
 *		it just appended..	This should be fixed but until it
 *		is, we don't want to get stuck in an infinite loop
 *		which corrupts your database..
1367 1368 1369
 * ----------------------------------------------------------------
 */
static void
1370
ExecReplace(TupleTableSlot *slot,
1371
			ItemPointer tupleid,
1372
			EState *estate)
1373
{
B
Bruce Momjian 已提交
1374
	HeapTuple	tuple;
1375
	ResultRelInfo *resultRelInfo;
B
Bruce Momjian 已提交
1376 1377 1378 1379
	Relation	resultRelationDesc;
	ItemPointerData ctid;
	int			result;
	int			numIndices;
1380

B
Bruce Momjian 已提交
1381
	/*
B
Bruce Momjian 已提交
1382
	 * abort the operation if not running transactions
1383 1384 1385
	 */
	if (IsBootstrapProcessingMode())
	{
1386
		elog(NOTICE, "ExecReplace: replace can't run without transactions");
1387 1388 1389
		return;
	}

B
Bruce Momjian 已提交
1390
	/*
B
Bruce Momjian 已提交
1391
	 * get the heap tuple out of the tuple table slot
1392 1393 1394
	 */
	tuple = slot->val;

B
Bruce Momjian 已提交
1395
	/*
1396
	 * get information on the (current) result relation
1397
	 */
1398 1399
	resultRelInfo = estate->es_result_relation_info;
	resultRelationDesc = resultRelInfo->ri_RelationDesc;
1400 1401 1402

	/* BEFORE ROW UPDATE Triggers */
	if (resultRelationDesc->trigdesc &&
1403
		resultRelationDesc->trigdesc->n_before_row[TRIGGER_EVENT_UPDATE] > 0)
1404
	{
1405
		HeapTuple	newtuple;
1406

V
Vadim B. Mikheev 已提交
1407
		newtuple = ExecBRUpdateTriggers(estate, tupleid, tuple);
1408 1409 1410 1411 1412 1413

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

		if (newtuple != tuple)	/* modified by Trigger(s) */
		{
1414 1415 1416 1417 1418 1419 1420 1421
			/*
			 * Insert modified tuple into tuple table slot, replacing the
			 * original.  We assume that it was allocated in per-tuple
			 * memory context, and therefore will go away by itself.
			 * The tuple table slot should not try to clear it.
			 */
			ExecStoreTuple(newtuple, slot, InvalidBuffer, false);
			tuple = newtuple;
1422 1423 1424
		}
	}

B
Bruce Momjian 已提交
1425
	/*
1426
	 * Check the constraints of the tuple
1427 1428
	 */
	if (resultRelationDesc->rd_att->constr)
1429
		ExecConstraints("ExecReplace", resultRelInfo, slot, estate);
1430

V
Vadim B. Mikheev 已提交
1431
	/*
B
Bruce Momjian 已提交
1432
	 * replace the heap tuple
1433
	 */
1434
lreplace:;
1435
	result = heap_update(resultRelationDesc, tupleid, tuple, &ctid);
V
Vadim B. Mikheev 已提交
1436 1437 1438 1439 1440 1441 1442 1443 1444
	switch (result)
	{
		case HeapTupleSelfUpdated:
			return;

		case HeapTupleMayBeUpdated:
			break;

		case HeapTupleUpdated:
1445 1446
			if (XactIsoLevel == XACT_SERIALIZABLE)
				elog(ERROR, "Can't serialize access due to concurrent update");
1447 1448
			else if (!(ItemPointerEquals(tupleid, &ctid)))
			{
B
Bruce Momjian 已提交
1449
				TupleTableSlot *epqslot = EvalPlanQual(estate,
1450
						  resultRelInfo->ri_RangeTableIndex, &ctid);
1451

V
Vadim B. Mikheev 已提交
1452
				if (!TupIsNull(epqslot))
1453 1454
				{
					*tupleid = ctid;
V
Vadim B. Mikheev 已提交
1455 1456
					tuple = ExecRemoveJunk(estate->es_junkFilter, epqslot);
					slot = ExecStoreTuple(tuple, slot, InvalidBuffer, true);
1457 1458 1459
					goto lreplace;
				}
			}
V
Vadim B. Mikheev 已提交
1460 1461 1462
			return;

		default:
1463
			elog(ERROR, "Unknown status %u from heap_update", result);
V
Vadim B. Mikheev 已提交
1464
			return;
1465 1466 1467 1468 1469
	}

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

B
Bruce Momjian 已提交
1470
	/*
B
Bruce Momjian 已提交
1471 1472
	 * Note: instead of having to update the old index tuples associated
	 * with the heap tuple, all we do is form and insert new index
1473 1474 1475
	 * tuples.  This is because replaces are actually deletes and inserts
	 * and index tuple deletion is done automagically by the vacuum
	 * daemon. All we do is insert new index tuples.  -cim 9/27/89
1476 1477
	 */

B
Bruce Momjian 已提交
1478
	/*
B
Bruce Momjian 已提交
1479
	 * process indices
1480
	 *
1481
	 * heap_update updates a tuple in the base relation by invalidating it
B
Bruce Momjian 已提交
1482 1483 1484 1485
	 * and then appending a new tuple to the relation.	As a side effect,
	 * 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.
1486 1487
	 */

1488
	numIndices = resultRelInfo->ri_NumIndices;
1489
	if (numIndices > 0)
1490
		ExecInsertIndexTuples(slot, &(tuple->t_self), estate, true);
1491 1492

	/* AFTER ROW UPDATE Triggers */
1493
	if (resultRelationDesc->trigdesc)
V
Vadim B. Mikheev 已提交
1494
		ExecARUpdateTriggers(estate, tupleid, tuple);
1495
}
V
Vadim B. Mikheev 已提交
1496

1497
static char *
1498 1499
ExecRelCheck(ResultRelInfo *resultRelInfo,
			 TupleTableSlot *slot, EState *estate)
V
Vadim B. Mikheev 已提交
1500
{
1501
	Relation	rel = resultRelInfo->ri_RelationDesc;
1502 1503
	int			ncheck = rel->rd_att->constr->num_check;
	ConstrCheck *check = rel->rd_att->constr->check;
1504
	ExprContext *econtext;
1505
	MemoryContext oldContext;
1506 1507
	List	   *qual;
	int			i;
1508

1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526
	/*
	 * 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);
			resultRelInfo->ri_ConstraintExprs[i] = qual;
		}
		MemoryContextSwitchTo(oldContext);
	}

1527
	/*
1528
	 * We will use the EState's per-tuple context for evaluating constraint
1529
	 * expressions (creating it if it's not already there).
1530
	 */
1531
	econtext = GetPerTupleExprContext(estate);
1532

1533 1534 1535 1536
	/* Arrange for econtext's scan tuple to be the tuple under test */
	econtext->ecxt_scantuple = slot;

	/* And evaluate the constraints */
1537 1538
	for (i = 0; i < ncheck; i++)
	{
1539
		qual = resultRelInfo->ri_ConstraintExprs[i];
1540

1541 1542
		/*
		 * NOTE: SQL92 specifies that a NULL result from a constraint
1543 1544
		 * expression is not to be treated as a failure.  Therefore, tell
		 * ExecQual to return TRUE for NULL.
1545
		 */
1546
		if (!ExecQual(qual, econtext, true))
1547
			return check[i].ccname;
1548 1549
	}

1550
	/* NULL result means no error */
1551
	return (char *) NULL;
V
Vadim B. Mikheev 已提交
1552 1553
}

1554
void
1555
ExecConstraints(char *caller, ResultRelInfo *resultRelInfo,
1556
				TupleTableSlot *slot, EState *estate)
V
Vadim B. Mikheev 已提交
1557
{
1558
	Relation	rel = resultRelInfo->ri_RelationDesc;
1559 1560 1561 1562
	HeapTuple	tuple = slot->val;
	TupleConstr *constr = rel->rd_att->constr;

	Assert(constr);
1563

1564
	if (constr->has_not_null)
V
Vadim B. Mikheev 已提交
1565
	{
1566
		int			natts = rel->rd_att->natts;
1567
		int			attrChk;
1568

1569
		for (attrChk = 1; attrChk <= natts; attrChk++)
1570
		{
1571 1572
			if (rel->rd_att->attrs[attrChk-1]->attnotnull &&
				heap_attisnull(tuple, attrChk))
1573
				elog(ERROR, "%s: Fail to add null value in not null attribute %s",
1574
					 caller, NameStr(rel->rd_att->attrs[attrChk-1]->attname));
1575 1576 1577
		}
	}

1578
	if (constr->num_check > 0)
1579
	{
1580
		char	   *failed;
1581

1582
		if ((failed = ExecRelCheck(resultRelInfo, slot, estate)) != NULL)
1583 1584
			elog(ERROR, "%s: rejected due to CHECK constraint %s",
				 caller, failed);
1585
	}
V
Vadim B. Mikheev 已提交
1586
}
1587

B
Bruce Momjian 已提交
1588
TupleTableSlot *
1589 1590
EvalPlanQual(EState *estate, Index rti, ItemPointer tid)
{
B
Bruce Momjian 已提交
1591 1592 1593 1594 1595 1596 1597
	evalPlanQual *epq = (evalPlanQual *) estate->es_evalPlanQual;
	evalPlanQual *oldepq;
	EState	   *epqstate = NULL;
	Relation	relation;
	Buffer		buffer;
	HeapTupleData tuple;
	bool		endNode = true;
1598 1599 1600 1601 1602

	Assert(rti != 0);

	if (epq != NULL && epq->rti == 0)
	{
B
Bruce Momjian 已提交
1603 1604
		Assert(!(estate->es_useEvalPlan) &&
			   epq->estate.es_evalPlanQual == NULL);
1605 1606 1607 1608 1609 1610
		epq->rti = rti;
		endNode = false;
	}

	/*
	 * If this is request for another RTE - Ra, - then we have to check
B
Bruce Momjian 已提交
1611 1612 1613
	 * 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? -:))
1614
	 */
B
Bruce Momjian 已提交
1615
	if (epq != NULL && epq->rti != rti &&
1616 1617 1618 1619 1620 1621
		epq->estate.es_evTuple[rti - 1] != NULL)
	{
		do
		{
			/* pop previous PlanQual from the stack */
			epqstate = &(epq->estate);
B
Bruce Momjian 已提交
1622
			oldepq = (evalPlanQual *) epqstate->es_evalPlanQual;
1623 1624 1625
			Assert(oldepq->rti != 0);
			/* stop execution */
			ExecEndNode(epq->plan, epq->plan);
1626
			epqstate->es_tupleTable->next = 0;
1627
			heap_freetuple(epqstate->es_evTuple[epq->rti - 1]);
1628 1629 1630 1631 1632 1633 1634 1635
			epqstate->es_evTuple[epq->rti - 1] = NULL;
			/* push current PQ to freePQ stack */
			oldepq->free = epq;
			epq = oldepq;
		} while (epq->rti != rti);
		estate->es_evalPlanQual = (Pointer) epq;
	}

B
Bruce Momjian 已提交
1636
	/*
1637 1638 1639 1640 1641 1642
	 * 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 已提交
1643
		evalPlanQual *newepq = (epq != NULL) ? epq->free : NULL;
1644

1645
		if (newepq == NULL)		/* first call or freePQ stack is empty */
1646
		{
B
Bruce Momjian 已提交
1647
			newepq = (evalPlanQual *) palloc(sizeof(evalPlanQual));
1648 1649 1650
			/* Init EState */
			epqstate = &(newepq->estate);
			memset(epqstate, 0, sizeof(EState));
B
Bruce Momjian 已提交
1651
			epqstate->type = T_EState;
1652 1653 1654 1655 1656 1657
			epqstate->es_direction = ForwardScanDirection;
			epqstate->es_snapshot = estate->es_snapshot;
			epqstate->es_range_table = estate->es_range_table;
			epqstate->es_param_list_info = estate->es_param_list_info;
			if (estate->es_origPlan->nParamExec > 0)
				epqstate->es_param_exec_vals = (ParamExecData *)
B
Bruce Momjian 已提交
1658 1659 1660
					palloc(estate->es_origPlan->nParamExec *
						   sizeof(ParamExecData));
			epqstate->es_tupleTable =
1661 1662 1663 1664
				ExecCreateTupleTable(estate->es_tupleTable->size);
			/* ... rest */
			newepq->plan = copyObject(estate->es_origPlan);
			newepq->free = NULL;
B
Bruce Momjian 已提交
1665
			epqstate->es_evTupleNull = (bool *)
1666 1667
				palloc(length(estate->es_range_table) * sizeof(bool));
			if (epq == NULL)	/* first call */
1668
			{
B
Bruce Momjian 已提交
1669
				epqstate->es_evTuple = (HeapTuple *)
1670
					palloc(length(estate->es_range_table) * sizeof(HeapTuple));
B
Bruce Momjian 已提交
1671 1672
				memset(epqstate->es_evTuple, 0,
					 length(estate->es_range_table) * sizeof(HeapTuple));
1673 1674 1675 1676 1677 1678 1679 1680
			}
			else
				epqstate->es_evTuple = epq->estate.es_evTuple;
		}
		else
			epqstate = &(newepq->estate);
		/* push current PQ to the stack */
		epqstate->es_evalPlanQual = (Pointer) epq;
1681 1682
		epq = newepq;
		estate->es_evalPlanQual = (Pointer) epq;
1683 1684 1685 1686 1687 1688 1689
		epq->rti = rti;
		endNode = false;
	}

	epqstate = &(epq->estate);

	/*
B
Bruce Momjian 已提交
1690 1691
	 * Ok - we're requested for the same RTE (-:)). I'm not sure about
	 * ability to use ExecReScan instead of ExecInitNode, so...
1692 1693
	 */
	if (endNode)
1694
	{
1695
		ExecEndNode(epq->plan, epq->plan);
1696
		epqstate->es_tupleTable->next = 0;
1697
	}
1698 1699 1700 1701

	/* free old RTE' tuple */
	if (epqstate->es_evTuple[epq->rti - 1] != NULL)
	{
1702
		heap_freetuple(epqstate->es_evTuple[epq->rti - 1]);
1703 1704 1705 1706
		epqstate->es_evTuple[epq->rti - 1] = NULL;
	}

	/* ** fetch tid tuple ** */
B
Bruce Momjian 已提交
1707
	if (estate->es_result_relation_info != NULL &&
1708 1709 1710 1711
		estate->es_result_relation_info->ri_RangeTableIndex == rti)
		relation = estate->es_result_relation_info->ri_RelationDesc;
	else
	{
B
Bruce Momjian 已提交
1712
		List	   *l;
1713

B
Bruce Momjian 已提交
1714
		foreach(l, estate->es_rowMark)
1715
		{
B
Bruce Momjian 已提交
1716
			if (((execRowMark *) lfirst(l))->rti == rti)
1717 1718
				break;
		}
B
Bruce Momjian 已提交
1719
		relation = ((execRowMark *) lfirst(l))->relation;
1720 1721
	}
	tuple.t_self = *tid;
B
Bruce Momjian 已提交
1722
	for (;;)
1723 1724 1725 1726 1727 1728 1729
	{
		heap_fetch(relation, SnapshotDirty, &tuple, &buffer);
		if (tuple.t_data != NULL)
		{
			TransactionId xwait = SnapshotDirty->xmax;

			if (TransactionIdIsValid(SnapshotDirty->xmin))
1730 1731 1732 1733 1734
			{
				elog(NOTICE, "EvalPlanQual: t_xmin is uncommitted ?!");
				Assert(!TransactionIdIsValid(SnapshotDirty->xmin));
				elog(ERROR, "Aborting this transaction");
			}
B
Bruce Momjian 已提交
1735

1736
			/*
B
Bruce Momjian 已提交
1737 1738
			 * If tuple is being updated by other transaction then we have
			 * to wait for its commit/abort.
1739 1740 1741 1742 1743 1744 1745
			 */
			if (TransactionIdIsValid(xwait))
			{
				ReleaseBuffer(buffer);
				XactLockTableWait(xwait);
				continue;
			}
B
Bruce Momjian 已提交
1746

1747 1748 1749
			/*
			 * Nice! We got tuple - now copy it.
			 */
1750
			if (epqstate->es_evTuple[epq->rti - 1] != NULL)
1751
				heap_freetuple(epqstate->es_evTuple[epq->rti - 1]);
1752 1753 1754 1755
			epqstate->es_evTuple[epq->rti - 1] = heap_copytuple(&tuple);
			ReleaseBuffer(buffer);
			break;
		}
B
Bruce Momjian 已提交
1756

1757 1758
		/*
		 * Ops! Invalid tuple. Have to check is it updated or deleted.
B
Bruce Momjian 已提交
1759 1760
		 * Note that it's possible to get invalid SnapshotDirty->tid if
		 * tuple updated by this transaction. Have we to check this ?
1761
		 */
B
Bruce Momjian 已提交
1762
		if (ItemPointerIsValid(&(SnapshotDirty->tid)) &&
1763 1764 1765 1766 1767
			!(ItemPointerEquals(&(tuple.t_self), &(SnapshotDirty->tid))))
		{
			tuple.t_self = SnapshotDirty->tid;	/* updated ... */
			continue;
		}
B
Bruce Momjian 已提交
1768

1769
		/*
B
Bruce Momjian 已提交
1770 1771
		 * Deleted or updated by this transaction. Do not (re-)start
		 * execution of this PQ. Continue previous PQ.
1772
		 */
B
Bruce Momjian 已提交
1773
		oldepq = (evalPlanQual *) epqstate->es_evalPlanQual;
1774 1775 1776 1777 1778 1779 1780 1781 1782 1783
		if (oldepq != NULL)
		{
			Assert(oldepq->rti != 0);
			/* push current PQ to freePQ stack */
			oldepq->free = epq;
			epq = oldepq;
			epqstate = &(epq->estate);
			estate->es_evalPlanQual = (Pointer) epq;
		}
		else
1784 1785 1786 1787
		{
			epq->rti = 0;		/* this is the first (oldest) */
			estate->es_useEvalPlan = false;		/* PQ - mark as free and	  */
			return (NULL);		/* continue Query execution   */
1788 1789 1790 1791
		}
	}

	if (estate->es_origPlan->nParamExec > 0)
B
Bruce Momjian 已提交
1792 1793 1794 1795
		memset(epqstate->es_param_exec_vals, 0,
			   estate->es_origPlan->nParamExec * sizeof(ParamExecData));
	memset(epqstate->es_evTupleNull, false,
		   length(estate->es_range_table) * sizeof(bool));
1796
	Assert(epqstate->es_tupleTable->next == 0);
1797 1798 1799
	ExecInitNode(epq->plan, epqstate, NULL);

	/*
B
Bruce Momjian 已提交
1800 1801
	 * For UPDATE/DELETE we have to return tid of actual row we're
	 * executing PQ for.
1802 1803 1804
	 */
	*tid = tuple.t_self;

1805
	return EvalPlanQualNext(estate);
1806 1807
}

B
Bruce Momjian 已提交
1808
static TupleTableSlot *
1809 1810
EvalPlanQualNext(EState *estate)
{
B
Bruce Momjian 已提交
1811 1812 1813 1814
	evalPlanQual *epq = (evalPlanQual *) estate->es_evalPlanQual;
	EState	   *epqstate = &(epq->estate);
	evalPlanQual *oldepq;
	TupleTableSlot *slot;
1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826

	Assert(epq->rti != 0);

lpqnext:;
	slot = ExecProcNode(epq->plan, epq->plan);

	/*
	 * No more tuples for this PQ. Continue previous one.
	 */
	if (TupIsNull(slot))
	{
		ExecEndNode(epq->plan, epq->plan);
1827
		epqstate->es_tupleTable->next = 0;
1828
		heap_freetuple(epqstate->es_evTuple[epq->rti - 1]);
1829 1830
		epqstate->es_evTuple[epq->rti - 1] = NULL;
		/* pop old PQ from the stack */
B
Bruce Momjian 已提交
1831 1832
		oldepq = (evalPlanQual *) epqstate->es_evalPlanQual;
		if (oldepq == (evalPlanQual *) NULL)
1833
		{
1834 1835 1836
			epq->rti = 0;		/* this is the first (oldest) */
			estate->es_useEvalPlan = false;		/* PQ - mark as free and	  */
			return (NULL);		/* continue Query execution   */
1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848
		}
		Assert(oldepq->rti != 0);
		/* push current PQ to freePQ stack */
		oldepq->free = epq;
		epq = oldepq;
		epqstate = &(epq->estate);
		estate->es_evalPlanQual = (Pointer) epq;
		goto lpqnext;
	}

	return (slot);
}
1849 1850 1851 1852 1853 1854 1855 1856

static void
EndEvalPlanQual(EState *estate)
{
	evalPlanQual *epq = (evalPlanQual *) estate->es_evalPlanQual;
	EState	   *epqstate = &(epq->estate);
	evalPlanQual *oldepq;

1857 1858 1859
	if (epq->rti == 0)			/* plans already shutdowned */
	{
		Assert(epq->estate.es_evalPlanQual == NULL);
1860
		return;
1861
	}
1862 1863 1864 1865

	for (;;)
	{
		ExecEndNode(epq->plan, epq->plan);
1866
		epqstate->es_tupleTable->next = 0;
1867 1868 1869 1870 1871
		if (epqstate->es_evTuple[epq->rti - 1] != NULL)
		{
			heap_freetuple(epqstate->es_evTuple[epq->rti - 1]);
			epqstate->es_evTuple[epq->rti - 1] = NULL;
		}
1872 1873 1874 1875
		/* pop old PQ from the stack */
		oldepq = (evalPlanQual *) epqstate->es_evalPlanQual;
		if (oldepq == (evalPlanQual *) NULL)
		{
1876 1877
			epq->rti = 0;		/* this is the first (oldest) */
			estate->es_useEvalPlan = false;		/* PQ - mark as free */
1878 1879 1880 1881 1882 1883 1884 1885 1886 1887
			break;
		}
		Assert(oldepq->rti != 0);
		/* push current PQ to freePQ stack */
		oldepq->free = epq;
		epq = oldepq;
		epqstate = &(epq->estate);
		estate->es_evalPlanQual = (Pointer) epq;
	}
}