PostgreSQL Source Code git master
Loading...
Searching...
No Matches
gistget.c
Go to the documentation of this file.
1/*-------------------------------------------------------------------------
2 *
3 * gistget.c
4 * fetch tuples from a GiST scan.
5 *
6 *
7 * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
8 * Portions Copyright (c) 1994, Regents of the University of California
9 *
10 * IDENTIFICATION
11 * src/backend/access/gist/gistget.c
12 *
13 *-------------------------------------------------------------------------
14 */
15#include "postgres.h"
16
17#include "access/genam.h"
18#include "access/gist_private.h"
19#include "access/relscan.h"
21#include "lib/pairingheap.h"
22#include "miscadmin.h"
23#include "pgstat.h"
24#include "storage/predicate.h"
25#include "utils/float.h"
26#include "utils/memutils.h"
27#include "utils/rel.h"
28
29/*
30 * gistkillitems() -- set LP_DEAD state for items an indexscan caller has
31 * told us were killed.
32 *
33 * We re-read page here, so it's important to check page LSN. If the page
34 * has been modified since the last read (as determined by LSN), we cannot
35 * flag any entries because it is possible that the old entry was vacuumed
36 * away and the TID was re-used by a completely different heap tuple.
37 */
38static void
40{
42 Buffer buffer;
43 Page page;
44 OffsetNumber offnum;
45 ItemId iid;
46 int i;
47 bool killedsomething = false;
48
49 Assert(so->curBlkno != InvalidBlockNumber);
50 Assert(XLogRecPtrIsValid(so->curPageLSN));
51 Assert(so->killedItems != NULL);
52
53 buffer = ReadBuffer(scan->indexRelation, so->curBlkno);
54 if (!BufferIsValid(buffer))
55 return;
56
57 LockBuffer(buffer, GIST_SHARE);
58 gistcheckpage(scan->indexRelation, buffer);
59 page = BufferGetPage(buffer);
60
61 /*
62 * If page LSN differs it means that the page was modified since the last
63 * read. killedItems could be not valid so LP_DEAD hints applying is not
64 * safe.
65 */
66 if (BufferGetLSNAtomic(buffer) != so->curPageLSN)
67 goto unlock;
68
70
71 /*
72 * Mark all killedItems as dead. We need no additional recheck, because,
73 * if page was modified, curPageLSN must have changed.
74 */
75 for (i = 0; i < so->numKilled; i++)
76 {
77 if (!killedsomething)
78 {
79 /*
80 * Use the hint bit infrastructure to check if we can update the
81 * page while just holding a share lock. If we are not allowed,
82 * there's no point continuing.
83 */
84 if (!BufferBeginSetHintBits(buffer))
85 goto unlock;
86 }
87
88 offnum = so->killedItems[i];
89 iid = PageGetItemId(page, offnum);
91 killedsomething = true;
92 }
93
95 {
97 BufferFinishSetHintBits(buffer, true, true);
98 }
99
100unlock:
101 UnlockReleaseBuffer(buffer);
102
103 /*
104 * Always reset the scan state, so we don't look for same items on other
105 * pages.
106 */
107 so->numKilled = 0;
108}
109
110/*
111 * gistindex_keytest() -- does this index tuple satisfy the scan key(s)?
112 *
113 * The index tuple might represent either a heap tuple or a lower index page,
114 * depending on whether the containing page is a leaf page or not.
115 *
116 * On success return for a heap tuple, *recheck_p is set to indicate whether
117 * the quals need to be rechecked. We recheck if any of the consistent()
118 * functions request it. recheck is not interesting when examining a non-leaf
119 * entry, since we must visit the lower index page if there's any doubt.
120 * Similarly, *recheck_distances_p is set to indicate whether the distances
121 * need to be rechecked, and it is also ignored for non-leaf entries.
122 *
123 * If we are doing an ordered scan, so->distances[] is filled with distance
124 * data from the distance() functions before returning success.
125 *
126 * We must decompress the key in the IndexTuple before passing it to the
127 * sk_funcs (which actually are the opclass Consistent or Distance methods).
128 *
129 * Note that this function is always invoked in a short-lived memory context,
130 * so we don't need to worry about cleaning up allocated memory, either here
131 * or in the implementation of any Consistent or Distance methods.
132 */
133static bool
135 IndexTuple tuple,
136 Page page,
137 OffsetNumber offset,
138 bool *recheck_p,
140{
142 GISTSTATE *giststate = so->giststate;
143 ScanKey key = scan->keyData;
144 int keySize = scan->numberOfKeys;
146 Relation r = scan->indexRelation;
147
148 *recheck_p = false;
149 *recheck_distances_p = false;
150
151 /*
152 * If it's a leftover invalid tuple from pre-9.1, treat it as a match with
153 * minimum possible distances. This means we'll always follow it to the
154 * referenced page.
155 */
156 if (GistTupleIsInvalid(tuple))
157 {
158 int i;
159
160 if (GistPageIsLeaf(page)) /* shouldn't happen */
161 elog(ERROR, "invalid GiST tuple found on leaf page");
162 for (i = 0; i < scan->numberOfOrderBys; i++)
163 {
164 so->distances[i].value = -get_float8_infinity();
165 so->distances[i].isnull = false;
166 }
167 return true;
168 }
169
170 /* Check whether it matches according to the Consistent functions */
171 while (keySize > 0)
172 {
173 Datum datum;
174 bool isNull;
175
176 datum = index_getattr(tuple,
177 key->sk_attno,
178 giststate->leafTupdesc,
179 &isNull);
180
181 if (key->sk_flags & SK_ISNULL)
182 {
183 /*
184 * On non-leaf page we can't conclude that child hasn't NULL
185 * values because of assumption in GiST: union (VAL, NULL) is VAL.
186 * But if on non-leaf page key IS NULL, then all children are
187 * NULL.
188 */
189 if (key->sk_flags & SK_SEARCHNULL)
190 {
191 if (GistPageIsLeaf(page) && !isNull)
192 return false;
193 }
194 else
195 {
196 Assert(key->sk_flags & SK_SEARCHNOTNULL);
197 if (isNull)
198 return false;
199 }
200 }
201 else if (isNull)
202 {
203 return false;
204 }
205 else
206 {
207 Datum test;
208 bool recheck;
210
211 gistdentryinit(giststate, key->sk_attno - 1, &de,
212 datum, r, page, offset,
213 false, isNull);
214
215 /*
216 * Call the Consistent function to evaluate the test. The
217 * arguments are the index datum (as a GISTENTRY*), the comparison
218 * datum, the comparison operator's strategy number and subtype
219 * from pg_amop, and the recheck flag.
220 *
221 * (Presently there's no need to pass the subtype since it'll
222 * always be zero, but might as well pass it for possible future
223 * use.)
224 *
225 * We initialize the recheck flag to true (the safest assumption)
226 * in case the Consistent function forgets to set it.
227 */
228 recheck = true;
229
230 test = FunctionCall5Coll(&key->sk_func,
231 key->sk_collation,
233 key->sk_argument,
234 UInt16GetDatum(key->sk_strategy),
235 ObjectIdGetDatum(key->sk_subtype),
236 PointerGetDatum(&recheck));
237
238 if (!DatumGetBool(test))
239 return false;
240 *recheck_p |= recheck;
241 }
242
243 key++;
244 keySize--;
245 }
246
247 /* OK, it passes --- now let's compute the distances */
248 key = scan->orderByData;
249 distance_p = so->distances;
251 while (keySize > 0)
252 {
253 Datum datum;
254 bool isNull;
255
256 datum = index_getattr(tuple,
257 key->sk_attno,
258 giststate->leafTupdesc,
259 &isNull);
260
261 if ((key->sk_flags & SK_ISNULL) || isNull)
262 {
263 /* Assume distance computes as null */
264 distance_p->value = 0.0;
265 distance_p->isnull = true;
266 }
267 else
268 {
269 Datum dist;
270 bool recheck;
272
273 gistdentryinit(giststate, key->sk_attno - 1, &de,
274 datum, r, page, offset,
275 false, isNull);
276
277 /*
278 * Call the Distance function to evaluate the distance. The
279 * arguments are the index datum (as a GISTENTRY*), the comparison
280 * datum, the ordering operator's strategy number and subtype from
281 * pg_amop, and the recheck flag.
282 *
283 * (Presently there's no need to pass the subtype since it'll
284 * always be zero, but might as well pass it for possible future
285 * use.)
286 *
287 * If the function sets the recheck flag, the returned distance is
288 * a lower bound on the true distance and needs to be rechecked.
289 * We initialize the flag to 'false'. This flag was added in
290 * version 9.5; distance functions written before that won't know
291 * about the flag, but are expected to never be lossy.
292 */
293 recheck = false;
294 dist = FunctionCall5Coll(&key->sk_func,
295 key->sk_collation,
297 key->sk_argument,
298 UInt16GetDatum(key->sk_strategy),
299 ObjectIdGetDatum(key->sk_subtype),
300 PointerGetDatum(&recheck));
301 *recheck_distances_p |= recheck;
303 distance_p->isnull = false;
304 }
305
306 key++;
307 distance_p++;
308 keySize--;
309 }
310
311 return true;
312}
313
314/*
315 * Scan all items on the GiST index page identified by *pageItem, and insert
316 * them into the queue (or directly to output areas)
317 *
318 * scan: index scan we are executing
319 * pageItem: search queue item identifying an index page to scan
320 * myDistances: distances array associated with pageItem, or NULL at the root
321 * tbm: if not NULL, gistgetbitmap's output bitmap
322 * ntids: if not NULL, gistgetbitmap's output tuple counter
323 *
324 * If tbm/ntids aren't NULL, we are doing an amgetbitmap scan, and heap
325 * tuples should be reported directly into the bitmap. If they are NULL,
326 * we're doing a plain or ordered indexscan. For a plain indexscan, heap
327 * tuple TIDs are returned into so->pageData[]. For an ordered indexscan,
328 * heap tuple TIDs are pushed into individual search queue items. In an
329 * index-only scan, reconstructed index tuples are returned along with the
330 * TIDs.
331 *
332 * If we detect that the index page has split since we saw its downlink
333 * in the parent, we push its new right sibling onto the queue so the
334 * sibling will be processed next.
335 */
336static void
339{
341 GISTSTATE *giststate = so->giststate;
342 Relation r = scan->indexRelation;
343 Buffer buffer;
344 Page page;
345 GISTPageOpaque opaque;
346 OffsetNumber maxoff;
349
351
352 buffer = ReadBuffer(scan->indexRelation, pageItem->blkno);
353 LockBuffer(buffer, GIST_SHARE);
355 gistcheckpage(scan->indexRelation, buffer);
356 page = BufferGetPage(buffer);
357 opaque = GistPageGetOpaque(page);
358
359 /*
360 * Check if we need to follow the rightlink. We need to follow it if the
361 * page was concurrently split since we visited the parent (in which case
362 * parentlsn < nsn), or if the system crashed after a page split but
363 * before the downlink was inserted into the parent.
364 */
365 if (XLogRecPtrIsValid(pageItem->data.parentlsn) &&
366 (GistFollowRight(page) ||
367 pageItem->data.parentlsn < GistPageGetNSN(page)) &&
368 opaque->rightlink != InvalidBlockNumber /* sanity check */ )
369 {
370 /* There was a page split, follow right link to add pages */
371 GISTSearchItem *item;
372
373 /* This can't happen when starting at the root */
375
376 oldcxt = MemoryContextSwitchTo(so->queueCxt);
377
378 /* Create new GISTSearchItem for the right sibling index page */
380 item->blkno = opaque->rightlink;
381 item->data.parentlsn = pageItem->data.parentlsn;
382
383 /* Insert it into the queue using same distances as for this page */
385 sizeof(item->distances[0]) * scan->numberOfOrderBys);
386
387 pairingheap_add(so->queue, &item->phNode);
388
390 }
391
392 /*
393 * Check if the page was deleted after we saw the downlink. There's
394 * nothing of interest on a deleted page. Note that we must do this after
395 * checking the NSN for concurrent splits! It's possible that the page
396 * originally contained some tuples that are visible to us, but was split
397 * so that all the visible tuples were moved to another page, and then
398 * this page was deleted.
399 */
400 if (GistPageIsDeleted(page))
401 {
402 UnlockReleaseBuffer(buffer);
403 return;
404 }
405
406 so->nPageData = so->curPageData = 0;
407 scan->xs_hitup = NULL; /* might point into pageDataCxt */
408 if (so->pageDataCxt)
409 MemoryContextReset(so->pageDataCxt);
410
411 /*
412 * We save the LSN of the page as we read it, so that we know whether it
413 * is safe to apply LP_DEAD hints to the page later. This allows us to
414 * drop the pin for MVCC scans, which allows vacuum to avoid blocking.
415 */
416 so->curPageLSN = BufferGetLSNAtomic(buffer);
417
418 /*
419 * check all tuples on page
420 */
421 maxoff = PageGetMaxOffsetNumber(page);
422 for (i = FirstOffsetNumber; i <= maxoff; i = OffsetNumberNext(i))
423 {
424 ItemId iid = PageGetItemId(page, i);
426 bool match;
427 bool recheck;
429
430 /*
431 * If the scan specifies not to return killed tuples, then we treat a
432 * killed tuple as not passing the qual.
433 */
435 continue;
436
437 it = (IndexTuple) PageGetItem(page, iid);
438
439 /*
440 * Must call gistindex_keytest in tempCxt, and clean up any leftover
441 * junk afterward.
442 */
443 oldcxt = MemoryContextSwitchTo(so->giststate->tempCxt);
444
445 match = gistindex_keytest(scan, it, page, i,
446 &recheck, &recheck_distances);
447
449 MemoryContextReset(so->giststate->tempCxt);
450
451 /* Ignore tuple if it doesn't match */
452 if (!match)
453 continue;
454
455 if (tbm && GistPageIsLeaf(page))
456 {
457 /*
458 * getbitmap scan, so just push heap tuple TIDs into the bitmap
459 * without worrying about ordering
460 */
461 tbm_add_tuples(tbm, &it->t_tid, 1, recheck);
462 (*ntids)++;
463 }
464 else if (scan->numberOfOrderBys == 0 && GistPageIsLeaf(page))
465 {
466 /*
467 * Non-ordered scan, so report tuples in so->pageData[]
468 */
469 so->pageData[so->nPageData].heapPtr = it->t_tid;
470 so->pageData[so->nPageData].recheck = recheck;
471 so->pageData[so->nPageData].offnum = i;
472
473 /*
474 * In an index-only scan, also fetch the data from the tuple. The
475 * reconstructed tuples are stored in pageDataCxt.
476 */
477 if (scan->xs_want_itup)
478 {
479 oldcxt = MemoryContextSwitchTo(so->pageDataCxt);
480 so->pageData[so->nPageData].recontup =
481 gistFetchTuple(giststate, r, it);
483 }
484 so->nPageData++;
485 }
486 else
487 {
488 /*
489 * Must push item into search queue. We get here for any lower
490 * index page, and also for heap tuples if doing an ordered
491 * search.
492 */
493 GISTSearchItem *item;
494 int nOrderBys = scan->numberOfOrderBys;
495
496 oldcxt = MemoryContextSwitchTo(so->queueCxt);
497
498 /* Create new GISTSearchItem for this item */
500
501 if (GistPageIsLeaf(page))
502 {
503 /* Creating heap-tuple GISTSearchItem */
505 item->data.heap.heapPtr = it->t_tid;
506 item->data.heap.recheck = recheck;
508
509 /*
510 * In an index-only scan, also fetch the data from the tuple.
511 */
512 if (scan->xs_want_itup)
513 item->data.heap.recontup = gistFetchTuple(giststate, r, it);
514 }
515 else
516 {
517 /* Creating index-page GISTSearchItem */
518 item->blkno = ItemPointerGetBlockNumber(&it->t_tid);
519
520 /*
521 * LSN of current page is lsn of parent page for child. We
522 * only have a shared lock, so we need to get the LSN
523 * atomically.
524 */
525 item->data.parentlsn = BufferGetLSNAtomic(buffer);
526 }
527
528 /* Insert it into the queue using new distance data */
529 memcpy(item->distances, so->distances,
530 sizeof(item->distances[0]) * nOrderBys);
531
532 pairingheap_add(so->queue, &item->phNode);
533
535 }
536 }
537
538 UnlockReleaseBuffer(buffer);
539}
540
541/*
542 * Extract next item (in order) from search queue
543 *
544 * Returns a GISTSearchItem or NULL. Caller must pfree item when done with it.
545 */
546static GISTSearchItem *
548{
549 GISTSearchItem *item;
550
551 if (!pairingheap_is_empty(so->queue))
552 {
553 item = (GISTSearchItem *) pairingheap_remove_first(so->queue);
554 }
555 else
556 {
557 /* Done when both heaps are empty */
558 item = NULL;
559 }
560
561 /* Return item; caller is responsible to pfree it */
562 return item;
563}
564
565/*
566 * Fetch next heap tuple in an ordered search
567 */
568static bool
570{
572 bool res = false;
573
574 if (scan->xs_hitup)
575 {
576 /* free previously returned tuple */
577 pfree(scan->xs_hitup);
578 scan->xs_hitup = NULL;
579 }
580
581 do
582 {
584
585 if (!item)
586 break;
587
588 if (GISTSearchItemIsHeap(*item))
589 {
590 /* found a heap item at currently minimal distance */
591 scan->xs_heaptid = item->data.heap.heapPtr;
592 scan->xs_recheck = item->data.heap.recheck;
593
594 index_store_float8_orderby_distances(scan, so->orderByTypes,
595 item->distances,
597
598 /* in an index-only scan, also return the reconstructed tuple. */
599 if (scan->xs_want_itup)
600 scan->xs_hitup = item->data.heap.recontup;
601 res = true;
602 }
603 else
604 {
605 /* visit an index page, extract its items into queue */
607
608 gistScanPage(scan, item, item->distances, NULL, NULL);
609 }
610
611 pfree(item);
612 } while (!res);
613
614 return res;
615}
616
617/*
618 * gistgettuple() -- Get the next tuple in the scan
619 */
620bool
622{
624
625 if (dir != ForwardScanDirection)
626 elog(ERROR, "GiST only supports forward scan direction");
627
628 if (!so->qual_ok)
629 return false;
630
631 if (so->firstCall)
632 {
633 /* Begin the scan by processing the root page */
635
637 if (scan->instrument)
638 scan->instrument->nsearches++;
639
640 so->firstCall = false;
641 so->curPageData = so->nPageData = 0;
642 scan->xs_hitup = NULL;
643 if (so->pageDataCxt)
644 MemoryContextReset(so->pageDataCxt);
645
647 memset(&fakeItem.data.parentlsn, 0, sizeof(GistNSN));
649 }
650
651 if (scan->numberOfOrderBys > 0)
652 {
653 /* Must fetch tuples in strict distance order */
654 return getNextNearest(scan);
655 }
656 else
657 {
658 /* Fetch tuples index-page-at-a-time */
659 for (;;)
660 {
661 if (so->curPageData < so->nPageData)
662 {
663 if (scan->kill_prior_tuple && so->curPageData > 0)
664 {
665
666 if (so->killedItems == NULL)
667 {
669 MemoryContextSwitchTo(so->giststate->scanCxt);
670
671 so->killedItems =
673 * sizeof(OffsetNumber));
674
676 }
677 if (so->numKilled < MaxIndexTuplesPerPage)
678 so->killedItems[so->numKilled++] =
679 so->pageData[so->curPageData - 1].offnum;
680 }
681 /* continuing to return tuples from a leaf page */
682 scan->xs_heaptid = so->pageData[so->curPageData].heapPtr;
683 scan->xs_recheck = so->pageData[so->curPageData].recheck;
684
685 /* in an index-only scan, also return the reconstructed tuple */
686 if (scan->xs_want_itup)
687 scan->xs_hitup = so->pageData[so->curPageData].recontup;
688
689 so->curPageData++;
690
691 return true;
692 }
693
694 /*
695 * Check the last returned tuple and add it to killedItems if
696 * necessary
697 */
698 if (scan->kill_prior_tuple
699 && so->curPageData > 0
700 && so->curPageData == so->nPageData)
701 {
702
703 if (so->killedItems == NULL)
704 {
706 MemoryContextSwitchTo(so->giststate->scanCxt);
707
708 so->killedItems =
710 * sizeof(OffsetNumber));
711
713 }
714 if (so->numKilled < MaxIndexTuplesPerPage)
715 so->killedItems[so->numKilled++] =
716 so->pageData[so->curPageData - 1].offnum;
717 }
718 /* find and process the next index page */
719 do
720 {
721 GISTSearchItem *item;
722
723 if ((so->curBlkno != InvalidBlockNumber) && (so->numKilled > 0))
724 gistkillitems(scan);
725
727
728 if (!item)
729 return false;
730
732
733 /* save current item BlockNumber for next gistkillitems() call */
734 so->curBlkno = item->blkno;
735
736 /*
737 * While scanning a leaf page, ItemPointers of matching heap
738 * tuples are stored in so->pageData. If there are any on
739 * this page, we fall out of the inner "do" and loop around to
740 * return them.
741 */
742 gistScanPage(scan, item, item->distances, NULL, NULL);
743
744 pfree(item);
745 } while (so->nPageData == 0);
746 }
747 }
748}
749
750/*
751 * gistgetbitmap() -- Get a bitmap of all heap tuple locations
752 */
753int64
755{
757 int64 ntids = 0;
759
760 if (!so->qual_ok)
761 return 0;
762
764 if (scan->instrument)
765 scan->instrument->nsearches++;
766
767 /* Begin the scan by processing the root page */
768 so->curPageData = so->nPageData = 0;
769 scan->xs_hitup = NULL;
770 if (so->pageDataCxt)
771 MemoryContextReset(so->pageDataCxt);
772
774 memset(&fakeItem.data.parentlsn, 0, sizeof(GistNSN));
775 gistScanPage(scan, &fakeItem, NULL, tbm, &ntids);
776
777 /*
778 * While scanning a leaf page, ItemPointers of matching heap tuples will
779 * be stored directly into tbm, so we don't need to deal with them here.
780 */
781 for (;;)
782 {
784
785 if (!item)
786 break;
787
789
790 gistScanPage(scan, item, item->distances, tbm, &ntids);
791
792 pfree(item);
793 }
794
795 return ntids;
796}
797
798/*
799 * Can we do index-only scans on the given index column?
800 *
801 * Opclasses that implement a fetch function support index-only scans.
802 * Opclasses without compression functions also support index-only scans.
803 * Included attributes always can be fetched for index-only scans.
804 */
805bool
807{
811 return true;
812 else
813 return false;
814}
#define InvalidBlockNumber
Definition block.h:33
int Buffer
Definition buf.h:23
BlockNumber BufferGetBlockNumber(Buffer buffer)
Definition bufmgr.c:4355
void BufferFinishSetHintBits(Buffer buffer, bool mark_dirty, bool buffer_std)
Definition bufmgr.c:6943
XLogRecPtr BufferGetLSNAtomic(Buffer buffer)
Definition bufmgr.c:4634
void UnlockReleaseBuffer(Buffer buffer)
Definition bufmgr.c:5518
bool BufferBeginSetHintBits(Buffer buffer)
Definition bufmgr.c:6915
Buffer ReadBuffer(Relation reln, BlockNumber blockNum)
Definition bufmgr.c:866
static Page BufferGetPage(Buffer buffer)
Definition bufmgr.h:470
static void LockBuffer(Buffer buffer, BufferLockMode mode)
Definition bufmgr.h:332
static bool BufferIsValid(Buffer bufnum)
Definition bufmgr.h:421
static ItemId PageGetItemId(Page page, OffsetNumber offsetNumber)
Definition bufpage.h:243
static void * PageGetItem(PageData *page, const ItemIdData *itemId)
Definition bufpage.h:353
PageData * Page
Definition bufpage.h:81
static OffsetNumber PageGetMaxOffsetNumber(const PageData *page)
Definition bufpage.h:371
#define Assert(condition)
Definition c.h:915
int64_t int64
Definition c.h:585
#define OidIsValid(objectId)
Definition c.h:830
#define ERROR
Definition elog.h:39
#define elog(elevel,...)
Definition elog.h:226
static float8 get_float8_infinity(void)
Definition float.h:65
Datum FunctionCall5Coll(FmgrInfo *flinfo, Oid collation, Datum arg1, Datum arg2, Datum arg3, Datum arg4, Datum arg5)
Definition fmgr.c:1224
#define GIST_FETCH_PROC
Definition gist.h:40
#define GIST_COMPRESS_PROC
Definition gist.h:34
#define GistPageIsLeaf(page)
Definition gist.h:170
#define GistFollowRight(page)
Definition gist.h:183
#define GistPageIsDeleted(page)
Definition gist.h:173
#define GistPageGetOpaque(page)
Definition gist.h:168
#define GistMarkPageHasGarbage(page)
Definition gist.h:180
#define GistPageGetNSN(page)
Definition gist.h:187
XLogRecPtr GistNSN
Definition gist.h:63
#define GIST_ROOT_BLKNO
GISTScanOpaqueData * GISTScanOpaque
#define SizeOfGISTSearchItem(n_distances)
#define GistTupleIsInvalid(itup)
#define GIST_SHARE
#define GISTSearchItemIsHeap(item)
static bool getNextNearest(IndexScanDesc scan)
Definition gistget.c:569
static GISTSearchItem * getNextGISTSearchItem(GISTScanOpaque so)
Definition gistget.c:547
static bool gistindex_keytest(IndexScanDesc scan, IndexTuple tuple, Page page, OffsetNumber offset, bool *recheck_p, bool *recheck_distances_p)
Definition gistget.c:134
bool gistgettuple(IndexScanDesc scan, ScanDirection dir)
Definition gistget.c:621
int64 gistgetbitmap(IndexScanDesc scan, TIDBitmap *tbm)
Definition gistget.c:754
bool gistcanreturn(Relation index, int attno)
Definition gistget.c:806
static void gistScanPage(IndexScanDesc scan, GISTSearchItem *pageItem, IndexOrderByDistance *myDistances, TIDBitmap *tbm, int64 *ntids)
Definition gistget.c:337
static void gistkillitems(IndexScanDesc scan)
Definition gistget.c:39
HeapTuple gistFetchTuple(GISTSTATE *giststate, Relation r, IndexTuple tuple)
Definition gistutil.c:667
void gistdentryinit(GISTSTATE *giststate, int nkey, GISTENTRY *e, Datum k, Relation r, Page pg, OffsetNumber o, bool l, bool isNull)
Definition gistutil.c:547
void gistcheckpage(Relation rel, Buffer buf)
Definition gistutil.c:785
RegProcedure index_getprocid(Relation irel, AttrNumber attnum, uint16 procnum)
Definition indexam.c:883
void index_store_float8_orderby_distances(IndexScanDesc scan, Oid *orderByTypes, IndexOrderByDistance *distances, bool recheckOrderBy)
Definition indexam.c:985
int i
Definition isn.c:77
#define ItemIdMarkDead(itemId)
Definition itemid.h:179
#define ItemIdIsDead(itemId)
Definition itemid.h:113
static BlockNumber ItemPointerGetBlockNumber(const ItemPointerData *pointer)
Definition itemptr.h:103
IndexTupleData * IndexTuple
Definition itup.h:53
static Datum index_getattr(IndexTuple tup, int attnum, TupleDesc tupleDesc, bool *isnull)
Definition itup.h:131
#define MaxIndexTuplesPerPage
Definition itup.h:181
void MemoryContextReset(MemoryContext context)
Definition mcxt.c:403
void pfree(void *pointer)
Definition mcxt.c:1616
void * palloc(Size size)
Definition mcxt.c:1387
#define CHECK_FOR_INTERRUPTS()
Definition miscadmin.h:123
#define OffsetNumberNext(offsetNumber)
Definition off.h:52
uint16 OffsetNumber
Definition off.h:24
#define FirstOffsetNumber
Definition off.h:27
void pairingheap_add(pairingheap *heap, pairingheap_node *node)
pairingheap_node * pairingheap_remove_first(pairingheap *heap)
#define pairingheap_is_empty(h)
Definition pairingheap.h:99
static MemoryContext MemoryContextSwitchTo(MemoryContext context)
Definition palloc.h:124
#define pgstat_count_index_scan(rel)
Definition pgstat.h:708
static bool DatumGetBool(Datum X)
Definition postgres.h:100
static Datum PointerGetDatum(const void *X)
Definition postgres.h:342
static Datum UInt16GetDatum(uint16 X)
Definition postgres.h:192
static float8 DatumGetFloat8(Datum X)
Definition postgres.h:485
static Datum ObjectIdGetDatum(Oid X)
Definition postgres.h:252
uint64_t Datum
Definition postgres.h:70
void PredicateLockPage(Relation relation, BlockNumber blkno, Snapshot snapshot)
Definition predicate.c:2598
static void test(void)
static int fb(int x)
#define IndexRelationGetNumberOfKeyAttributes(relation)
Definition rel.h:533
ScanDirection
Definition sdir.h:25
@ ForwardScanDirection
Definition sdir.h:28
#define SK_SEARCHNOTNULL
Definition skey.h:122
#define SK_SEARCHNULL
Definition skey.h:121
#define SK_ISNULL
Definition skey.h:115
BlockNumber rightlink
Definition gist.h:81
TupleDesc leafTupdesc
ItemPointerData heapPtr
union GISTSearchItem::@49 data
GISTSearchHeapItem heap
BlockNumber blkno
IndexOrderByDistance distances[FLEXIBLE_ARRAY_MEMBER]
pairingheap_node phNode
struct ScanKeyData * keyData
Definition relscan.h:142
struct ScanKeyData * orderByData
Definition relscan.h:143
HeapTuple xs_hitup
Definition relscan.h:170
bool ignore_killed_tuples
Definition relscan.h:149
struct IndexScanInstrumentation * instrument
Definition relscan.h:160
bool kill_prior_tuple
Definition relscan.h:148
Relation indexRelation
Definition relscan.h:138
ItemPointerData xs_heaptid
Definition relscan.h:173
struct SnapshotData * xs_snapshot
Definition relscan.h:139
Definition type.h:96
void tbm_add_tuples(TIDBitmap *tbm, const ItemPointerData *tids, int ntids, bool recheck)
Definition tidbitmap.c:367
#define XLogRecPtrIsValid(r)
Definition xlogdefs.h:29