PostgreSQL Source Code  git master
genam.c
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * genam.c
4  * general index access method routines
5  *
6  * Portions Copyright (c) 1996-2024, PostgreSQL Global Development Group
7  * Portions Copyright (c) 1994, Regents of the University of California
8  *
9  *
10  * IDENTIFICATION
11  * src/backend/access/index/genam.c
12  *
13  * NOTES
14  * many of the old access method routines have been turned into
15  * macros and moved to genam.h -cim 4/30/91
16  *
17  *-------------------------------------------------------------------------
18  */
19 
20 #include "postgres.h"
21 
22 #include "access/genam.h"
23 #include "access/relscan.h"
24 #include "access/tableam.h"
25 #include "access/transam.h"
26 #include "catalog/index.h"
27 #include "lib/stringinfo.h"
28 #include "miscadmin.h"
29 #include "storage/bufmgr.h"
30 #include "storage/procarray.h"
31 #include "utils/acl.h"
32 #include "utils/lsyscache.h"
33 #include "utils/rel.h"
34 #include "utils/rls.h"
35 #include "utils/ruleutils.h"
36 #include "utils/snapmgr.h"
37 
38 
39 /* ----------------------------------------------------------------
40  * general access method routines
41  *
42  * All indexed access methods use an identical scan structure.
43  * We don't know how the various AMs do locking, however, so we don't
44  * do anything about that here.
45  *
46  * The intent is that an AM implementor will define a beginscan routine
47  * that calls RelationGetIndexScan, to fill in the scan, and then does
48  * whatever kind of locking he wants.
49  *
50  * At the end of a scan, the AM's endscan routine undoes the locking,
51  * but does *not* call IndexScanEnd --- the higher-level index_endscan
52  * routine does that. (We can't do it in the AM because index_endscan
53  * still needs to touch the IndexScanDesc after calling the AM.)
54  *
55  * Because of this, the AM does not have a choice whether to call
56  * RelationGetIndexScan or not; its beginscan routine must return an
57  * object made by RelationGetIndexScan. This is kinda ugly but not
58  * worth cleaning up now.
59  * ----------------------------------------------------------------
60  */
61 
62 /* ----------------
63  * RelationGetIndexScan -- Create and fill an IndexScanDesc.
64  *
65  * This routine creates an index scan structure and sets up initial
66  * contents for it.
67  *
68  * Parameters:
69  * indexRelation -- index relation for scan.
70  * nkeys -- count of scan keys (index qual conditions).
71  * norderbys -- count of index order-by operators.
72  *
73  * Returns:
74  * An initialized IndexScanDesc.
75  * ----------------
76  */
78 RelationGetIndexScan(Relation indexRelation, int nkeys, int norderbys)
79 {
80  IndexScanDesc scan;
81 
82  scan = (IndexScanDesc) palloc(sizeof(IndexScanDescData));
83 
84  scan->heapRelation = NULL; /* may be set later */
85  scan->xs_heapfetch = NULL;
86  scan->indexRelation = indexRelation;
87  scan->xs_snapshot = InvalidSnapshot; /* caller must initialize this */
88  scan->numberOfKeys = nkeys;
89  scan->numberOfOrderBys = norderbys;
90 
91  /*
92  * We allocate key workspace here, but it won't get filled until amrescan.
93  */
94  if (nkeys > 0)
95  scan->keyData = (ScanKey) palloc(sizeof(ScanKeyData) * nkeys);
96  else
97  scan->keyData = NULL;
98  if (norderbys > 0)
99  scan->orderByData = (ScanKey) palloc(sizeof(ScanKeyData) * norderbys);
100  else
101  scan->orderByData = NULL;
102 
103  scan->xs_want_itup = false; /* may be set later */
104 
105  /*
106  * During recovery we ignore killed tuples and don't bother to kill them
107  * either. We do this because the xmin on the primary node could easily be
108  * later than the xmin on the standby node, so that what the primary
109  * thinks is killed is supposed to be visible on standby. So for correct
110  * MVCC for queries during recovery we must ignore these hints and check
111  * all tuples. Do *not* set ignore_killed_tuples to true when running in a
112  * transaction that was started during recovery. xactStartedInRecovery
113  * should not be altered by index AMs.
114  */
115  scan->kill_prior_tuple = false;
118 
119  scan->opaque = NULL;
120 
121  scan->xs_itup = NULL;
122  scan->xs_itupdesc = NULL;
123  scan->xs_hitup = NULL;
124  scan->xs_hitupdesc = NULL;
125 
126  return scan;
127 }
128 
129 /* ----------------
130  * IndexScanEnd -- End an index scan.
131  *
132  * This routine just releases the storage acquired by
133  * RelationGetIndexScan(). Any AM-level resources are
134  * assumed to already have been released by the AM's
135  * endscan routine.
136  *
137  * Returns:
138  * None.
139  * ----------------
140  */
141 void
143 {
144  if (scan->keyData != NULL)
145  pfree(scan->keyData);
146  if (scan->orderByData != NULL)
147  pfree(scan->orderByData);
148 
149  pfree(scan);
150 }
151 
152 /*
153  * BuildIndexValueDescription
154  *
155  * Construct a string describing the contents of an index entry, in the
156  * form "(key_name, ...)=(key_value, ...)". This is currently used
157  * for building unique-constraint and exclusion-constraint error messages,
158  * so only key columns of the index are checked and printed.
159  *
160  * Note that if the user does not have permissions to view all of the
161  * columns involved then a NULL is returned. Returning a partial key seems
162  * unlikely to be useful and we have no way to know which of the columns the
163  * user provided (unlike in ExecBuildSlotValueDescription).
164  *
165  * The passed-in values/nulls arrays are the "raw" input to the index AM,
166  * e.g. results of FormIndexDatum --- this is not necessarily what is stored
167  * in the index, but it's what the user perceives to be stored.
168  *
169  * Note: if you change anything here, check whether
170  * ExecBuildSlotPartitionKeyDescription() in execMain.c needs a similar
171  * change.
172  */
173 char *
175  const Datum *values, const bool *isnull)
176 {
178  Form_pg_index idxrec;
179  int indnkeyatts;
180  int i;
181  int keyno;
182  Oid indexrelid = RelationGetRelid(indexRelation);
183  Oid indrelid;
184  AclResult aclresult;
185 
186  indnkeyatts = IndexRelationGetNumberOfKeyAttributes(indexRelation);
187 
188  /*
189  * Check permissions- if the user does not have access to view all of the
190  * key columns then return NULL to avoid leaking data.
191  *
192  * First check if RLS is enabled for the relation. If so, return NULL to
193  * avoid leaking data.
194  *
195  * Next we need to check table-level SELECT access and then, if there is
196  * no access there, check column-level permissions.
197  */
198  idxrec = indexRelation->rd_index;
199  indrelid = idxrec->indrelid;
200  Assert(indexrelid == idxrec->indexrelid);
201 
202  /* RLS check- if RLS is enabled then we don't return anything. */
203  if (check_enable_rls(indrelid, InvalidOid, true) == RLS_ENABLED)
204  return NULL;
205 
206  /* Table-level SELECT is enough, if the user has it */
207  aclresult = pg_class_aclcheck(indrelid, GetUserId(), ACL_SELECT);
208  if (aclresult != ACLCHECK_OK)
209  {
210  /*
211  * No table-level access, so step through the columns in the index and
212  * make sure the user has SELECT rights on all of them.
213  */
214  for (keyno = 0; keyno < indnkeyatts; keyno++)
215  {
216  AttrNumber attnum = idxrec->indkey.values[keyno];
217 
218  /*
219  * Note that if attnum == InvalidAttrNumber, then this is an index
220  * based on an expression and we return no detail rather than try
221  * to figure out what column(s) the expression includes and if the
222  * user has SELECT rights on them.
223  */
224  if (attnum == InvalidAttrNumber ||
227  {
228  /* No access, so clean up and return */
229  return NULL;
230  }
231  }
232  }
233 
235  appendStringInfo(&buf, "(%s)=(",
236  pg_get_indexdef_columns(indexrelid, true));
237 
238  for (i = 0; i < indnkeyatts; i++)
239  {
240  char *val;
241 
242  if (isnull[i])
243  val = "null";
244  else
245  {
246  Oid foutoid;
247  bool typisvarlena;
248 
249  /*
250  * The provided data is not necessarily of the type stored in the
251  * index; rather it is of the index opclass's input type. So look
252  * at rd_opcintype not the index tupdesc.
253  *
254  * Note: this is a bit shaky for opclasses that have pseudotype
255  * input types such as ANYARRAY or RECORD. Currently, the
256  * typoutput functions associated with the pseudotypes will work
257  * okay, but we might have to try harder in future.
258  */
259  getTypeOutputInfo(indexRelation->rd_opcintype[i],
260  &foutoid, &typisvarlena);
261  val = OidOutputFunctionCall(foutoid, values[i]);
262  }
263 
264  if (i > 0)
265  appendStringInfoString(&buf, ", ");
267  }
268 
269  appendStringInfoChar(&buf, ')');
270 
271  return buf.data;
272 }
273 
274 /*
275  * Get the snapshotConflictHorizon from the table entries pointed to by the
276  * index tuples being deleted using an AM-generic approach.
277  *
278  * This is a table_index_delete_tuples() shim used by index AMs that only need
279  * to consult the tableam to get a snapshotConflictHorizon value, and only
280  * expect to delete index tuples that are already known deletable (typically
281  * due to having LP_DEAD bits set). When a snapshotConflictHorizon value
282  * isn't needed in index AM's deletion WAL record, it is safe for it to skip
283  * calling here entirely.
284  *
285  * We assume that caller index AM uses the standard IndexTuple representation,
286  * with table TIDs stored in the t_tid field. We also expect (and assert)
287  * that the line pointers on page for 'itemnos' offsets are already marked
288  * LP_DEAD.
289  */
292  Relation hrel,
293  Buffer ibuf,
294  OffsetNumber *itemnos,
295  int nitems)
296 {
297  TM_IndexDeleteOp delstate;
298  TransactionId snapshotConflictHorizon = InvalidTransactionId;
299  Page ipage = BufferGetPage(ibuf);
300  IndexTuple itup;
301 
302  Assert(nitems > 0);
303 
304  delstate.irel = irel;
305  delstate.iblknum = BufferGetBlockNumber(ibuf);
306  delstate.bottomup = false;
307  delstate.bottomupfreespace = 0;
308  delstate.ndeltids = 0;
309  delstate.deltids = palloc(nitems * sizeof(TM_IndexDelete));
310  delstate.status = palloc(nitems * sizeof(TM_IndexStatus));
311 
312  /* identify what the index tuples about to be deleted point to */
313  for (int i = 0; i < nitems; i++)
314  {
315  OffsetNumber offnum = itemnos[i];
316  ItemId iitemid;
317 
318  iitemid = PageGetItemId(ipage, offnum);
319  itup = (IndexTuple) PageGetItem(ipage, iitemid);
320 
321  Assert(ItemIdIsDead(iitemid));
322 
323  ItemPointerCopy(&itup->t_tid, &delstate.deltids[i].tid);
324  delstate.deltids[i].id = delstate.ndeltids;
325  delstate.status[i].idxoffnum = offnum;
326  delstate.status[i].knowndeletable = true; /* LP_DEAD-marked */
327  delstate.status[i].promising = false; /* unused */
328  delstate.status[i].freespace = 0; /* unused */
329 
330  delstate.ndeltids++;
331  }
332 
333  /* determine the actual xid horizon */
334  snapshotConflictHorizon = table_index_delete_tuples(hrel, &delstate);
335 
336  /* assert tableam agrees that all items are deletable */
337  Assert(delstate.ndeltids == nitems);
338 
339  pfree(delstate.deltids);
340  pfree(delstate.status);
341 
342  return snapshotConflictHorizon;
343 }
344 
345 
346 /* ----------------------------------------------------------------
347  * heap-or-index-scan access to system catalogs
348  *
349  * These functions support system catalog accesses that normally use
350  * an index but need to be capable of being switched to heap scans
351  * if the system indexes are unavailable.
352  *
353  * The specified scan keys must be compatible with the named index.
354  * Generally this means that they must constrain either all columns
355  * of the index, or the first K columns of an N-column index.
356  *
357  * These routines could work with non-system tables, actually,
358  * but they're only useful when there is a known index to use with
359  * the given scan keys; so in practice they're only good for
360  * predetermined types of scans of system catalogs.
361  * ----------------------------------------------------------------
362  */
363 
364 /*
365  * systable_beginscan --- set up for heap-or-index scan
366  *
367  * rel: catalog to scan, already opened and suitably locked
368  * indexId: OID of index to conditionally use
369  * indexOK: if false, forces a heap scan (see notes below)
370  * snapshot: time qual to use (NULL for a recent catalog snapshot)
371  * nkeys, key: scan keys
372  *
373  * The attribute numbers in the scan key should be set for the heap case.
374  * If we choose to index, we reset them to 1..n to reference the index
375  * columns. Note this means there must be one scankey qualification per
376  * index column! This is checked by the Asserts in the normal, index-using
377  * case, but won't be checked if the heapscan path is taken.
378  *
379  * The routine checks the normal cases for whether an indexscan is safe,
380  * but caller can make additional checks and pass indexOK=false if needed.
381  * In standard case indexOK can simply be constant TRUE.
382  */
385  Oid indexId,
386  bool indexOK,
387  Snapshot snapshot,
388  int nkeys, ScanKey key)
389 {
390  SysScanDesc sysscan;
391  Relation irel;
392 
393  if (indexOK &&
395  !ReindexIsProcessingIndex(indexId))
396  irel = index_open(indexId, AccessShareLock);
397  else
398  irel = NULL;
399 
400  sysscan = (SysScanDesc) palloc(sizeof(SysScanDescData));
401 
402  sysscan->heap_rel = heapRelation;
403  sysscan->irel = irel;
404  sysscan->slot = table_slot_create(heapRelation, NULL);
405 
406  if (snapshot == NULL)
407  {
408  Oid relid = RelationGetRelid(heapRelation);
409 
410  snapshot = RegisterSnapshot(GetCatalogSnapshot(relid));
411  sysscan->snapshot = snapshot;
412  }
413  else
414  {
415  /* Caller is responsible for any snapshot. */
416  sysscan->snapshot = NULL;
417  }
418 
419  if (irel)
420  {
421  int i;
422 
423  /* Change attribute numbers to be index column numbers. */
424  for (i = 0; i < nkeys; i++)
425  {
426  int j;
427 
428  for (j = 0; j < IndexRelationGetNumberOfAttributes(irel); j++)
429  {
430  if (key[i].sk_attno == irel->rd_index->indkey.values[j])
431  {
432  key[i].sk_attno = j + 1;
433  break;
434  }
435  }
437  elog(ERROR, "column is not in index");
438  }
439 
440  sysscan->iscan = index_beginscan(heapRelation, irel,
441  snapshot, nkeys, 0);
442  index_rescan(sysscan->iscan, key, nkeys, NULL, 0);
443  sysscan->scan = NULL;
444  }
445  else
446  {
447  /*
448  * We disallow synchronized scans when forced to use a heapscan on a
449  * catalog. In most cases the desired rows are near the front, so
450  * that the unpredictable start point of a syncscan is a serious
451  * disadvantage; and there are no compensating advantages, because
452  * it's unlikely that such scans will occur in parallel.
453  */
454  sysscan->scan = table_beginscan_strat(heapRelation, snapshot,
455  nkeys, key,
456  true, false);
457  sysscan->iscan = NULL;
458  }
459 
460  /*
461  * If CheckXidAlive is set then set a flag to indicate that system table
462  * scan is in-progress. See detailed comments in xact.c where these
463  * variables are declared.
464  */
466  bsysscan = true;
467 
468  return sysscan;
469 }
470 
471 /*
472  * HandleConcurrentAbort - Handle concurrent abort of the CheckXidAlive.
473  *
474  * Error out, if CheckXidAlive is aborted. We can't directly use
475  * TransactionIdDidAbort as after crash such transaction might not have been
476  * marked as aborted. See detailed comments in xact.c where the variable
477  * is declared.
478  */
479 static inline void
481 {
485  ereport(ERROR,
486  (errcode(ERRCODE_TRANSACTION_ROLLBACK),
487  errmsg("transaction aborted during system catalog scan")));
488 }
489 
490 /*
491  * systable_getnext --- get next tuple in a heap-or-index scan
492  *
493  * Returns NULL if no more tuples available.
494  *
495  * Note that returned tuple is a reference to data in a disk buffer;
496  * it must not be modified, and should be presumed inaccessible after
497  * next getnext() or endscan() call.
498  *
499  * XXX: It'd probably make sense to offer a slot based interface, at least
500  * optionally.
501  */
502 HeapTuple
504 {
505  HeapTuple htup = NULL;
506 
507  if (sysscan->irel)
508  {
509  if (index_getnext_slot(sysscan->iscan, ForwardScanDirection, sysscan->slot))
510  {
511  bool shouldFree;
512 
513  htup = ExecFetchSlotHeapTuple(sysscan->slot, false, &shouldFree);
514  Assert(!shouldFree);
515 
516  /*
517  * We currently don't need to support lossy index operators for
518  * any system catalog scan. It could be done here, using the scan
519  * keys to drive the operator calls, if we arranged to save the
520  * heap attnums during systable_beginscan(); this is practical
521  * because we still wouldn't need to support indexes on
522  * expressions.
523  */
524  if (sysscan->iscan->xs_recheck)
525  elog(ERROR, "system catalog scans with lossy index conditions are not implemented");
526  }
527  }
528  else
529  {
530  if (table_scan_getnextslot(sysscan->scan, ForwardScanDirection, sysscan->slot))
531  {
532  bool shouldFree;
533 
534  htup = ExecFetchSlotHeapTuple(sysscan->slot, false, &shouldFree);
535  Assert(!shouldFree);
536  }
537  }
538 
539  /*
540  * Handle the concurrent abort while fetching the catalog tuple during
541  * logical streaming of a transaction.
542  */
544 
545  return htup;
546 }
547 
548 /*
549  * systable_recheck_tuple --- recheck visibility of most-recently-fetched tuple
550  *
551  * In particular, determine if this tuple would be visible to a catalog scan
552  * that started now. We don't handle the case of a non-MVCC scan snapshot,
553  * because no caller needs that yet.
554  *
555  * This is useful to test whether an object was deleted while we waited to
556  * acquire lock on it.
557  *
558  * Note: we don't actually *need* the tuple to be passed in, but it's a
559  * good crosscheck that the caller is interested in the right tuple.
560  */
561 bool
563 {
564  Snapshot freshsnap;
565  bool result;
566 
567  Assert(tup == ExecFetchSlotHeapTuple(sysscan->slot, false, NULL));
568 
569  /*
570  * Trust that table_tuple_satisfies_snapshot() and its subsidiaries
571  * (commonly LockBuffer() and HeapTupleSatisfiesMVCC()) do not themselves
572  * acquire snapshots, so we need not register the snapshot. Those
573  * facilities are too low-level to have any business scanning tables.
574  */
575  freshsnap = GetCatalogSnapshot(RelationGetRelid(sysscan->heap_rel));
576 
577  result = table_tuple_satisfies_snapshot(sysscan->heap_rel,
578  sysscan->slot,
579  freshsnap);
580 
581  /*
582  * Handle the concurrent abort while fetching the catalog tuple during
583  * logical streaming of a transaction.
584  */
586 
587  return result;
588 }
589 
590 /*
591  * systable_endscan --- close scan, release resources
592  *
593  * Note that it's still up to the caller to close the heap relation.
594  */
595 void
597 {
598  if (sysscan->slot)
599  {
601  sysscan->slot = NULL;
602  }
603 
604  if (sysscan->irel)
605  {
606  index_endscan(sysscan->iscan);
607  index_close(sysscan->irel, AccessShareLock);
608  }
609  else
610  table_endscan(sysscan->scan);
611 
612  if (sysscan->snapshot)
613  UnregisterSnapshot(sysscan->snapshot);
614 
615  /*
616  * Reset the bsysscan flag at the end of the systable scan. See detailed
617  * comments in xact.c where these variables are declared.
618  */
620  bsysscan = false;
621 
622  pfree(sysscan);
623 }
624 
625 
626 /*
627  * systable_beginscan_ordered --- set up for ordered catalog scan
628  *
629  * These routines have essentially the same API as systable_beginscan etc,
630  * except that they guarantee to return multiple matching tuples in
631  * index order. Also, for largely historical reasons, the index to use
632  * is opened and locked by the caller, not here.
633  *
634  * Currently we do not support non-index-based scans here. (In principle
635  * we could do a heapscan and sort, but the uses are in places that
636  * probably don't need to still work with corrupted catalog indexes.)
637  * For the moment, therefore, these functions are merely the thinest of
638  * wrappers around index_beginscan/index_getnext_slot. The main reason for
639  * their existence is to centralize possible future support of lossy operators
640  * in catalog scans.
641  */
644  Relation indexRelation,
645  Snapshot snapshot,
646  int nkeys, ScanKey key)
647 {
648  SysScanDesc sysscan;
649  int i;
650 
651  /* REINDEX can probably be a hard error here ... */
652  if (ReindexIsProcessingIndex(RelationGetRelid(indexRelation)))
653  ereport(ERROR,
654  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
655  errmsg("cannot access index \"%s\" while it is being reindexed",
656  RelationGetRelationName(indexRelation))));
657  /* ... but we only throw a warning about violating IgnoreSystemIndexes */
659  elog(WARNING, "using index \"%s\" despite IgnoreSystemIndexes",
660  RelationGetRelationName(indexRelation));
661 
662  sysscan = (SysScanDesc) palloc(sizeof(SysScanDescData));
663 
664  sysscan->heap_rel = heapRelation;
665  sysscan->irel = indexRelation;
666  sysscan->slot = table_slot_create(heapRelation, NULL);
667 
668  if (snapshot == NULL)
669  {
670  Oid relid = RelationGetRelid(heapRelation);
671 
672  snapshot = RegisterSnapshot(GetCatalogSnapshot(relid));
673  sysscan->snapshot = snapshot;
674  }
675  else
676  {
677  /* Caller is responsible for any snapshot. */
678  sysscan->snapshot = NULL;
679  }
680 
681  /* Change attribute numbers to be index column numbers. */
682  for (i = 0; i < nkeys; i++)
683  {
684  int j;
685 
686  for (j = 0; j < IndexRelationGetNumberOfAttributes(indexRelation); j++)
687  {
688  if (key[i].sk_attno == indexRelation->rd_index->indkey.values[j])
689  {
690  key[i].sk_attno = j + 1;
691  break;
692  }
693  }
694  if (j == IndexRelationGetNumberOfAttributes(indexRelation))
695  elog(ERROR, "column is not in index");
696  }
697 
698  sysscan->iscan = index_beginscan(heapRelation, indexRelation,
699  snapshot, nkeys, 0);
700  index_rescan(sysscan->iscan, key, nkeys, NULL, 0);
701  sysscan->scan = NULL;
702 
703  return sysscan;
704 }
705 
706 /*
707  * systable_getnext_ordered --- get next tuple in an ordered catalog scan
708  */
709 HeapTuple
711 {
712  HeapTuple htup = NULL;
713 
714  Assert(sysscan->irel);
715  if (index_getnext_slot(sysscan->iscan, direction, sysscan->slot))
716  htup = ExecFetchSlotHeapTuple(sysscan->slot, false, NULL);
717 
718  /* See notes in systable_getnext */
719  if (htup && sysscan->iscan->xs_recheck)
720  elog(ERROR, "system catalog scans with lossy index conditions are not implemented");
721 
722  /*
723  * Handle the concurrent abort while fetching the catalog tuple during
724  * logical streaming of a transaction.
725  */
727 
728  return htup;
729 }
730 
731 /*
732  * systable_endscan_ordered --- close scan, release resources
733  */
734 void
736 {
737  if (sysscan->slot)
738  {
740  sysscan->slot = NULL;
741  }
742 
743  Assert(sysscan->irel);
744  index_endscan(sysscan->iscan);
745  if (sysscan->snapshot)
746  UnregisterSnapshot(sysscan->snapshot);
747  pfree(sysscan);
748 }
AclResult
Definition: acl.h:182
@ ACLCHECK_OK
Definition: acl.h:183
AclResult pg_attribute_aclcheck(Oid table_oid, AttrNumber attnum, Oid roleid, AclMode mode)
Definition: aclchk.c:3908
AclResult pg_class_aclcheck(Oid table_oid, Oid roleid, AclMode mode)
Definition: aclchk.c:4079
int16 AttrNumber
Definition: attnum.h:21
#define InvalidAttrNumber
Definition: attnum.h:23
static Datum values[MAXATTR]
Definition: bootstrap.c:152
int Buffer
Definition: buf.h:23
BlockNumber BufferGetBlockNumber(Buffer buffer)
Definition: bufmgr.c:3377
static Page BufferGetPage(Buffer buffer)
Definition: bufmgr.h:350
Pointer Page
Definition: bufpage.h:78
static Item PageGetItem(Page page, ItemId itemId)
Definition: bufpage.h:351
static ItemId PageGetItemId(Page page, OffsetNumber offsetNumber)
Definition: bufpage.h:240
uint32 TransactionId
Definition: c.h:639
int errcode(int sqlerrcode)
Definition: elog.c:859
int errmsg(const char *fmt,...)
Definition: elog.c:1072
#define WARNING
Definition: elog.h:36
#define ERROR
Definition: elog.h:39
#define elog(elevel,...)
Definition: elog.h:224
#define ereport(elevel,...)
Definition: elog.h:149
void ExecDropSingleTupleTableSlot(TupleTableSlot *slot)
Definition: execTuples.c:1253
HeapTuple ExecFetchSlotHeapTuple(TupleTableSlot *slot, bool materialize, bool *shouldFree)
Definition: execTuples.c:1643
char * OidOutputFunctionCall(Oid functionId, Datum val)
Definition: fmgr.c:1763
void systable_endscan(SysScanDesc sysscan)
Definition: genam.c:596
bool systable_recheck_tuple(SysScanDesc sysscan, HeapTuple tup)
Definition: genam.c:562
void IndexScanEnd(IndexScanDesc scan)
Definition: genam.c:142
TransactionId index_compute_xid_horizon_for_tuples(Relation irel, Relation hrel, Buffer ibuf, OffsetNumber *itemnos, int nitems)
Definition: genam.c:291
static void HandleConcurrentAbort()
Definition: genam.c:480
SysScanDesc systable_beginscan_ordered(Relation heapRelation, Relation indexRelation, Snapshot snapshot, int nkeys, ScanKey key)
Definition: genam.c:643
HeapTuple systable_getnext(SysScanDesc sysscan)
Definition: genam.c:503
void systable_endscan_ordered(SysScanDesc sysscan)
Definition: genam.c:735
HeapTuple systable_getnext_ordered(SysScanDesc sysscan, ScanDirection direction)
Definition: genam.c:710
char * BuildIndexValueDescription(Relation indexRelation, const Datum *values, const bool *isnull)
Definition: genam.c:174
SysScanDesc systable_beginscan(Relation heapRelation, Oid indexId, bool indexOK, Snapshot snapshot, int nkeys, ScanKey key)
Definition: genam.c:384
IndexScanDesc RelationGetIndexScan(Relation indexRelation, int nkeys, int norderbys)
Definition: genam.c:78
struct SysScanDescData * SysScanDesc
Definition: genam.h:91
struct IndexScanDescData * IndexScanDesc
Definition: genam.h:90
#define nitems(x)
Definition: indent.h:31
bool ReindexIsProcessingIndex(Oid indexOid)
Definition: index.c:4069
bool index_getnext_slot(IndexScanDesc scan, ScanDirection direction, TupleTableSlot *slot)
Definition: indexam.c:676
void index_close(Relation relation, LOCKMODE lockmode)
Definition: indexam.c:177
IndexScanDesc index_beginscan(Relation heapRelation, Relation indexRelation, Snapshot snapshot, int nkeys, int norderbys)
Definition: indexam.c:257
void index_endscan(IndexScanDesc scan)
Definition: indexam.c:379
Relation index_open(Oid relationId, LOCKMODE lockmode)
Definition: indexam.c:133
void index_rescan(IndexScanDesc scan, ScanKey keys, int nkeys, ScanKey orderbys, int norderbys)
Definition: indexam.c:353
long val
Definition: informix.c:664
int j
Definition: isn.c:74
int i
Definition: isn.c:73
#define ItemIdIsDead(itemId)
Definition: itemid.h:113
static void ItemPointerCopy(const ItemPointerData *fromPointer, ItemPointerData *toPointer)
Definition: itemptr.h:172
IndexTupleData * IndexTuple
Definition: itup.h:53
Assert(fmt[strlen(fmt) - 1] !='\n')
#define AccessShareLock
Definition: lockdefs.h:36
void getTypeOutputInfo(Oid type, Oid *typOutput, bool *typIsVarlena)
Definition: lsyscache.c:2863
void pfree(void *pointer)
Definition: mcxt.c:1508
void * palloc(Size size)
Definition: mcxt.c:1304
Oid GetUserId(void)
Definition: miscinit.c:514
bool IgnoreSystemIndexes
Definition: miscinit.c:80
uint16 OffsetNumber
Definition: off.h:24
#define ACL_SELECT
Definition: parsenodes.h:77
int16 attnum
Definition: pg_attribute.h:74
FormData_pg_index * Form_pg_index
Definition: pg_index.h:70
static char * buf
Definition: pg_test_fsync.c:73
uintptr_t Datum
Definition: postgres.h:64
#define InvalidOid
Definition: postgres_ext.h:36
unsigned int Oid
Definition: postgres_ext.h:31
bool TransactionIdIsInProgress(TransactionId xid)
Definition: procarray.c:1390
#define RelationGetRelid(relation)
Definition: rel.h:505
#define RelationGetRelationName(relation)
Definition: rel.h:539
#define IndexRelationGetNumberOfAttributes(relation)
Definition: rel.h:517
#define IndexRelationGetNumberOfKeyAttributes(relation)
Definition: rel.h:524
int check_enable_rls(Oid relid, Oid checkAsUser, bool noError)
Definition: rls.c:52
@ RLS_ENABLED
Definition: rls.h:45
char * pg_get_indexdef_columns(Oid indexrelid, bool pretty)
Definition: ruleutils.c:1204
ScanDirection
Definition: sdir.h:25
@ ForwardScanDirection
Definition: sdir.h:28
ScanKeyData * ScanKey
Definition: skey.h:75
Snapshot GetCatalogSnapshot(Oid relid)
Definition: snapmgr.c:352
void UnregisterSnapshot(Snapshot snapshot)
Definition: snapmgr.c:836
Snapshot RegisterSnapshot(Snapshot snapshot)
Definition: snapmgr.c:794
#define InvalidSnapshot
Definition: snapshot.h:123
void appendStringInfo(StringInfo str, const char *fmt,...)
Definition: stringinfo.c:97
void appendStringInfoString(StringInfo str, const char *s)
Definition: stringinfo.c:182
void appendStringInfoChar(StringInfo str, char ch)
Definition: stringinfo.c:194
void initStringInfo(StringInfo str)
Definition: stringinfo.c:59
struct ScanKeyData * keyData
Definition: relscan.h:122
struct ScanKeyData * orderByData
Definition: relscan.h:123
HeapTuple xs_hitup
Definition: relscan.h:144
bool ignore_killed_tuples
Definition: relscan.h:129
IndexFetchTableData * xs_heapfetch
Definition: relscan.h:150
int numberOfOrderBys
Definition: relscan.h:121
bool xactStartedInRecovery
Definition: relscan.h:130
IndexTuple xs_itup
Definition: relscan.h:142
bool kill_prior_tuple
Definition: relscan.h:128
struct TupleDescData * xs_hitupdesc
Definition: relscan.h:145
struct TupleDescData * xs_itupdesc
Definition: relscan.h:143
Relation indexRelation
Definition: relscan.h:118
struct SnapshotData * xs_snapshot
Definition: relscan.h:119
Relation heapRelation
Definition: relscan.h:117
ItemPointerData t_tid
Definition: itup.h:37
Oid * rd_opcintype
Definition: rel.h:208
Form_pg_index rd_index
Definition: rel.h:192
Relation irel
Definition: relscan.h:184
Relation heap_rel
Definition: relscan.h:183
struct SnapshotData * snapshot
Definition: relscan.h:187
struct IndexScanDescData * iscan
Definition: relscan.h:186
struct TupleTableSlot * slot
Definition: relscan.h:188
struct TableScanDescData * scan
Definition: relscan.h:185
TM_IndexStatus * status
Definition: tableam.h:247
int bottomupfreespace
Definition: tableam.h:242
Relation irel
Definition: tableam.h:239
TM_IndexDelete * deltids
Definition: tableam.h:246
BlockNumber iblknum
Definition: tableam.h:240
ItemPointerData tid
Definition: tableam.h:205
bool knowndeletable
Definition: tableam.h:212
bool promising
Definition: tableam.h:215
int16 freespace
Definition: tableam.h:216
OffsetNumber idxoffnum
Definition: tableam.h:211
TupleTableSlot * table_slot_create(Relation relation, List **reglist)
Definition: tableam.c:91
static void table_endscan(TableScanDesc scan)
Definition: tableam.h:1009
static TableScanDesc table_beginscan_strat(Relation rel, Snapshot snapshot, int nkeys, struct ScanKeyData *key, bool allow_strat, bool allow_sync)
Definition: tableam.h:925
static bool table_scan_getnextslot(TableScanDesc sscan, ScanDirection direction, TupleTableSlot *slot)
Definition: tableam.h:1045
static bool table_tuple_satisfies_snapshot(Relation rel, TupleTableSlot *slot, Snapshot snapshot)
Definition: tableam.h:1325
static TransactionId table_index_delete_tuples(Relation rel, TM_IndexDeleteOp *delstate)
Definition: tableam.h:1346
bool TransactionIdDidCommit(TransactionId transactionId)
Definition: transam.c:126
#define InvalidTransactionId
Definition: transam.h:31
#define TransactionIdIsValid(xid)
Definition: transam.h:41
bool TransactionStartedDuringRecovery(void)
Definition: xact.c:1028
bool bsysscan
Definition: xact.c:98
TransactionId CheckXidAlive
Definition: xact.c:97