3 #include "access/genam.h"
4 #include "access/gin.h"
5 #if PG_VERSION_NUM >= 90400
6 #include "utils/snapmgr.h"
8 #if PG_VERSION_NUM >= 90100
9 #include "access/gin_private.h"
11 #include "access/gist.h"
12 #include "access/gist_private.h"
13 #include "access/gistscan.h"
14 #if PG_VERSION_NUM >= 90200
15 #include "access/spgist_private.h"
16 #include "access/spgist.h"
17 #include "utils/datum.h"
19 #include "access/heapam.h"
20 #include "catalog/index.h"
21 #include "miscadmin.h"
22 #include "storage/lmgr.h"
23 #include "catalog/namespace.h"
24 #if PG_VERSION_NUM >= 80300
25 #include <tsearch/ts_utils.h>
27 #include <utils/tqual.h>
28 #include "utils/builtins.h"
29 #include "utils/lsyscache.h"
30 #include "utils/datum.h"
31 #include "utils/fmgroids.h"
34 #include <access/heapam.h>
35 #include <catalog/pg_type.h>
36 #include <access/relscan.h>
39 #define PAGESIZE (BLCKSZ - MAXALIGN(sizeof(PageHeaderData) + sizeof(ItemIdData)))
42 #define PG_NARGS() (fcinfo->nargs)
47 char *out=palloc( VARSIZE(in) );
48 memcpy(out, VARDATA(in), VARSIZE(in)-VARHDRSZ);
49 out[ VARSIZE(in)-VARHDRSZ ] ='\0';
60 static Relation checkOpenedRelation(Relation r, Oid PgAmOid);
62 #ifdef PG_MODULE_MAGIC
68 gist_index_open(RangeVar *relvar) {
69 #if PG_VERSION_NUM < 90200
70 Oid relOid = RangeVarGetRelid(relvar, false);
72 Oid relOid = RangeVarGetRelid(relvar, NoLock, false);
74 return checkOpenedRelation(
75 index_open(relOid, AccessExclusiveLock), GIST_AM_OID);
78 #define gist_index_close(r) index_close((r), AccessExclusiveLock)
81 gin_index_open(RangeVar *relvar) {
82 #if PG_VERSION_NUM < 90200
83 Oid relOid = RangeVarGetRelid(relvar, false);
85 Oid relOid = RangeVarGetRelid(relvar, NoLock, false);
87 return checkOpenedRelation(
88 index_open(relOid, AccessShareLock), GIN_AM_OID);
91 #define gin_index_close(r) index_close((r), AccessShareLock)
96 gist_index_open(RangeVar *relvar) {
97 Relation rel = index_openrv(relvar);
99 LockRelation(rel, AccessExclusiveLock);
100 return checkOpenedRelation(rel, GIST_AM_OID);
104 gist_index_close(Relation rel) {
105 UnlockRelation(rel, AccessExclusiveLock);
110 gin_index_open(RangeVar *relvar) {
111 Relation rel = index_openrv(relvar);
113 LockRelation(rel, AccessShareLock);
114 return checkOpenedRelation(rel, GIN_AM_OID);
118 gin_index_close(Relation rel) {
119 UnlockRelation(rel, AccessShareLock);
125 #if PG_VERSION_NUM >= 80300
126 #define stringToQualifiedNameList(x,y) stringToQualifiedNameList(x)
129 #if PG_VERSION_NUM < 80300
130 #define SET_VARSIZE(p,l) VARATT_SIZEP(p)=(l)
134 checkOpenedRelation(Relation r, Oid PgAmOid) {
135 if ( r->rd_am == NULL )
136 elog(ERROR, "Relation %s.%s is not an index",
137 get_namespace_name(RelationGetNamespace(r)),
138 RelationGetRelationName(r)
141 if ( r->rd_rel->relam != PgAmOid )
142 elog(ERROR, "Index %s.%s has wrong type",
143 get_namespace_name(RelationGetNamespace(r)),
144 RelationGetRelationName(r)
151 gist_dumptree(Relation r, int level, BlockNumber blk, OffsetNumber coff, IdxInfo *info) {
161 pred = (char *) palloc(sizeof(char) * level * 4 + 1);
162 MemSet(pred, ' ', level*4);
163 pred[level*4] = '\0';
165 buffer = ReadBuffer(r, blk);
166 page = (Page) BufferGetPage(buffer);
168 maxoff = PageGetMaxOffsetNumber(page);
171 while ( (info->ptr-((char*)info->txt)) + level*4 + 128 >= info->len ) {
172 int dist=info->ptr-((char*)info->txt);
174 info->txt=(text*)repalloc(info->txt, info->len);
175 info->ptr = ((char*)info->txt)+dist;
178 sprintf(info->ptr, "%s%d(l:%d) blk: %u numTuple: %d free: %db(%.2f%%) rightlink:%u (%s)\n",
184 (int) PageGetFreeSpace(page),
185 100.0*(((float)PAGESIZE)-(float)PageGetFreeSpace(page))/((float)PAGESIZE),
186 GistPageGetOpaque(page)->rightlink,
187 ( GistPageGetOpaque(page)->rightlink == InvalidBlockNumber ) ? "InvalidBlockNumber" : "OK" );
188 info->ptr=strchr(info->ptr,'\0');
190 if (!GistPageIsLeaf(page) && ( info->maxlevel<0 || level<info->maxlevel ) )
191 for (i = FirstOffsetNumber; i <= maxoff; i = OffsetNumberNext(i)) {
192 iid = PageGetItemId(page, i);
193 which = (IndexTuple) PageGetItem(page, iid);
194 cblk = ItemPointerGetBlockNumber(&(which->t_tid));
195 gist_dumptree(r, level + 1, cblk, i, info);
197 ReleaseBuffer(buffer);
201 PG_FUNCTION_INFO_V1(gist_tree);
202 Datum gist_tree(PG_FUNCTION_ARGS);
204 gist_tree(PG_FUNCTION_ARGS) {
205 text *name=PG_GETARG_TEXT_P(0);
206 char *relname=t2c(name);
212 relname_list = stringToQualifiedNameList(relname, "gist_tree");
213 relvar = makeRangeVarFromNameList(relname_list);
214 index = gist_index_open(relvar);
215 PG_FREE_IF_COPY(name,0);
217 info.maxlevel = ( PG_NARGS() > 1 ) ? PG_GETARG_INT32(1) : -1;
219 info.txt=(text*)palloc( info.len );
220 info.ptr=((char*)info.txt)+VARHDRSZ;
222 gist_dumptree(index, 0, GIST_ROOT_BLKNO, 0, &info);
224 gist_index_close(index);
227 SET_VARSIZE(info.txt, info.ptr-((char*)info.txt));
228 PG_RETURN_POINTER(info.txt);
239 uint64 leaftuplesize;
244 gist_stattree(Relation r, int level, BlockNumber blk, OffsetNumber coff, IdxStat *info) {
254 pred = (char *) palloc(sizeof(char) * level * 4 + 1);
255 MemSet(pred, ' ', level*4);
256 pred[level*4] = '\0';
258 buffer = ReadBuffer(r, blk);
259 page = (Page) BufferGetPage(buffer);
261 maxoff = PageGetMaxOffsetNumber(page);
264 info->tuplesize+=PAGESIZE-PageGetFreeSpace(page);
265 info->totalsize+=BLCKSZ;
266 info->numtuple+=maxoff;
267 if ( info->level < level )
270 if (GistPageIsLeaf(page)) {
271 info->numleafpages++;
272 info->leaftuplesize+=PAGESIZE-PageGetFreeSpace(page);
273 info->numleaftuple+=maxoff;
275 for (i = FirstOffsetNumber; i <= maxoff; i = OffsetNumberNext(i)) {
276 iid = PageGetItemId(page, i);
277 which = (IndexTuple) PageGetItem(page, iid);
278 if ( GistTupleIsInvalid(which) )
279 info->numinvalidtuple++;
280 cblk = ItemPointerGetBlockNumber(&(which->t_tid));
281 gist_stattree(r, level + 1, cblk, i, info);
285 ReleaseBuffer(buffer);
289 PG_FUNCTION_INFO_V1(gist_stat);
290 Datum gist_stat(PG_FUNCTION_ARGS);
292 gist_stat(PG_FUNCTION_ARGS) {
293 text *name=PG_GETARG_TEXT_P(0);
294 char *relname=t2c(name);
299 text *out=(text*)palloc(1024);
300 char *ptr=((char*)out)+VARHDRSZ;
303 relname_list = stringToQualifiedNameList(relname, "gist_tree");
304 relvar = makeRangeVarFromNameList(relname_list);
305 index = gist_index_open(relvar);
306 PG_FREE_IF_COPY(name,0);
308 memset(&info, 0, sizeof(IdxStat));
310 gist_stattree(index, 0, GIST_ROOT_BLKNO, 0, &info);
312 gist_index_close(index);
316 "Number of levels: %d\n"
317 "Number of pages: %d\n"
318 "Number of leaf pages: %d\n"
319 "Number of tuples: %d\n"
320 "Number of invalid tuples: %d\n"
321 "Number of leaf tuples: %d\n"
322 "Total size of tuples: "INT64_FORMAT" bytes\n"
323 "Total size of leaf tuples: "INT64_FORMAT" bytes\n"
324 "Total size of index: "INT64_FORMAT" bytes\n",
329 info.numinvalidtuple,
335 ptr=strchr(ptr,'\0');
337 SET_VARSIZE(out, ptr-((char*)out));
338 PG_RETURN_POINTER(out);
341 typedef struct GPItem {
359 openGPPage( FuncCallContext *funcctx, BlockNumber blk ) {
361 MemoryContext oldcontext;
362 Relation index = ( (TypeStorage*)(funcctx->user_fctx) )->index;
364 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
365 nitem = (GPItem*)palloc( sizeof(GPItem) );
366 memset(nitem,0,sizeof(GPItem));
368 nitem->buffer = ReadBuffer(index, blk);
369 nitem->page = (Page) BufferGetPage(nitem->buffer);
370 nitem->offset=FirstOffsetNumber;
371 nitem->next = ( (TypeStorage*)(funcctx->user_fctx) )->item;
372 nitem->level = ( nitem->next ) ? nitem->next->level+1 : 1;
373 ( (TypeStorage*)(funcctx->user_fctx) )->item = nitem;
375 MemoryContextSwitchTo(oldcontext);
380 closeGPPage( FuncCallContext *funcctx ) {
381 GPItem *oitem = ( (TypeStorage*)(funcctx->user_fctx) )->item;
383 ( (TypeStorage*)(funcctx->user_fctx) )->item = oitem->next;
385 ReleaseBuffer(oitem->buffer);
387 return ( (TypeStorage*)(funcctx->user_fctx) )->item;
391 setup_firstcall(FuncCallContext *funcctx, text *name) {
392 MemoryContext oldcontext;
394 char *relname=t2c(name);
396 char attname[NAMEDATALEN];
399 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
401 st=(TypeStorage*)palloc( sizeof(TypeStorage) );
402 memset(st,0,sizeof(TypeStorage));
403 st->relname_list = stringToQualifiedNameList(relname, "gist_tree");
404 st->relvar = makeRangeVarFromNameList(st->relname_list);
405 st->index = gist_index_open(st->relvar);
406 funcctx->user_fctx = (void*)st;
408 tupdesc = CreateTemplateTupleDesc(st->index->rd_att->natts+2, false);
409 TupleDescInitEntry(tupdesc, 1, "level", INT4OID, -1, 0);
410 TupleDescInitEntry(tupdesc, 2, "valid", BOOLOID, -1, 0);
411 for (i = 0; i < st->index->rd_att->natts; i++) {
412 sprintf(attname, "z%d", i+2);
417 st->index->rd_att->attrs[i]->atttypid,
418 st->index->rd_att->attrs[i]->atttypmod,
419 st->index->rd_att->attrs[i]->attndims
423 st->dvalues = (Datum *) palloc((tupdesc->natts+2) * sizeof(Datum));
424 st->nulls = (char *) palloc((tupdesc->natts+2) * sizeof(char));
426 funcctx->slot = TupleDescGetSlot(tupdesc);
427 funcctx->attinmeta = TupleDescGetAttInMetadata(tupdesc);
429 MemoryContextSwitchTo(oldcontext);
432 st->item=openGPPage(funcctx, GIST_ROOT_BLKNO);
436 close_call( FuncCallContext *funcctx ) {
437 TypeStorage *st = (TypeStorage*)(funcctx->user_fctx);
439 while( st->item && closeGPPage(funcctx) );
441 pfree( st->dvalues );
444 gist_index_close(st->index);
447 PG_FUNCTION_INFO_V1(gist_print);
448 Datum gist_print(PG_FUNCTION_ARGS);
450 gist_print(PG_FUNCTION_ARGS) {
451 FuncCallContext *funcctx;
453 Datum result=(Datum)0;
460 if (SRF_IS_FIRSTCALL()) {
461 text *name=PG_GETARG_TEXT_P(0);
462 funcctx = SRF_FIRSTCALL_INIT();
463 setup_firstcall(funcctx, name);
464 PG_FREE_IF_COPY(name,0);
467 funcctx = SRF_PERCALL_SETUP();
468 st = (TypeStorage*)(funcctx->user_fctx);
472 SRF_RETURN_DONE(funcctx);
475 while( st->item->offset > PageGetMaxOffsetNumber( st->item->page ) ) {
476 if ( ! closeGPPage(funcctx) ) {
478 SRF_RETURN_DONE(funcctx);
482 iid = PageGetItemId( st->item->page, st->item->offset );
483 ituple = (IndexTuple) PageGetItem(st->item->page, iid);
485 st->dvalues[0] = Int32GetDatum( st->item->level );
487 st->dvalues[1] = BoolGetDatum( (!GistPageIsLeaf(st->item->page) && GistTupleIsInvalid(ituple)) ? false : true );
489 for(i=2; i<funcctx->attinmeta->tupdesc->natts; i++) {
490 if ( !GistPageIsLeaf(st->item->page) && GistTupleIsInvalid(ituple) ) {
491 st->dvalues[i] = (Datum)0;
494 st->dvalues[i] = index_getattr(ituple, i-1, st->index->rd_att, &isnull);
495 st->nulls[i] = ( isnull ) ? 'n' : ' ';
499 htuple = heap_formtuple(funcctx->attinmeta->tupdesc, st->dvalues, st->nulls);
500 result = TupleGetDatum(funcctx->slot, htuple);
501 st->item->offset = OffsetNumberNext(st->item->offset);
502 if ( !GistPageIsLeaf(st->item->page) )
503 openGPPage(funcctx, ItemPointerGetBlockNumber(&(ituple->t_tid)) );
505 SRF_RETURN_NEXT(funcctx, result);
508 typedef struct GinStatState {
516 #if PG_VERSION_NUM >= 90100
517 GinNullCategory category;
524 moveRightIfItNeeded( GinStatState *st )
526 Page page = BufferGetPage(st->buffer);
528 if ( st->offset > PageGetMaxOffsetNumber(page) ) {
530 * We scaned the whole page, so we should take right page
532 BlockNumber blkno = GinPageGetOpaque(page)->rightlink;
534 if ( GinPageRightMost(page) )
535 return false; /* no more page */
537 LockBuffer(st->buffer, GIN_UNLOCK);
538 st->buffer = ReleaseAndReadBuffer(st->buffer, st->index, blkno);
539 LockBuffer(st->buffer, GIN_SHARE);
540 st->offset = FirstOffsetNumber;
547 * Refinds a previois position, at returns it has correctly
548 * set offset and buffer is locked
551 refindPosition(GinStatState *st)
555 /* find left if needed (it causes only for first search) */
560 LockBuffer(st->buffer, GIN_SHARE);
562 page = BufferGetPage(st->buffer);
563 if (GinPageIsLeaf(page))
566 itup = (IndexTuple) PageGetItem(page, PageGetItemId(page, FirstOffsetNumber));
567 blkno = GinItemPointerGetBlockNumber(&(itup)->t_tid);
569 LockBuffer(st->buffer,GIN_UNLOCK);
570 st->buffer = ReleaseAndReadBuffer(st->buffer, st->index, blkno);
573 if (st->offset == InvalidOffsetNumber) {
574 return (PageGetMaxOffsetNumber(page) >= FirstOffsetNumber ) ? true : false; /* first one */
579 #if PG_VERSION_NUM >= 90100
580 GinNullCategory category;
581 #elif PG_VERSION_NUM < 80400
587 if (moveRightIfItNeeded(st)==false)
590 itup = (IndexTuple) PageGetItem(page, PageGetItemId(page, st->offset));
591 #if PG_VERSION_NUM >= 90100
592 datum = gintuple_get_key(&st->ginstate, itup, &category);
593 cmp = ginCompareAttEntries(&st->ginstate,
594 st->attnum + 1, st->curval, st->category,
595 gintuple_get_attrnum(&st->ginstate, itup), datum, category);
596 #elif PG_VERSION_NUM >= 80400
597 datum = gin_index_getattr(&st->ginstate, itup);
599 cmp = compareAttEntries(&st->ginstate,
600 st->attnum + 1, st->curval,
601 gintuple_get_attrnum(&st->ginstate, itup), datum);
603 datum = index_getattr(itup, FirstOffsetNumber, st->ginstate.tupdesc, &isnull);
607 &st->ginstate.compareFn,
614 if ( !st->index->rd_att->attrs[st->attnum]->attbyval )
615 pfree( (void*) st->curval );
626 gin_setup_firstcall(FuncCallContext *funcctx, text *name, int attnum) {
627 MemoryContext oldcontext;
629 char *relname=t2c(name);
632 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
634 st=(GinStatState*)palloc( sizeof(GinStatState) );
635 memset(st,0,sizeof(GinStatState));
636 st->index = gin_index_open(
637 makeRangeVarFromNameList(stringToQualifiedNameList(relname, "gin_stat")));
638 initGinState( &st->ginstate, st->index );
640 #if PG_VERSION_NUM >= 80400
641 if (attnum < 0 || attnum >= st->index->rd_att->natts)
642 elog(ERROR,"Wrong column's number");
648 funcctx->user_fctx = (void*)st;
650 tupdesc = CreateTemplateTupleDesc(2, false);
651 TupleDescInitEntry(tupdesc, 1, "value",
652 st->index->rd_att->attrs[st->attnum]->atttypid,
653 st->index->rd_att->attrs[st->attnum]->atttypmod,
654 st->index->rd_att->attrs[st->attnum]->attndims);
655 TupleDescInitEntry(tupdesc, 2, "nrow", INT4OID, -1, 0);
657 memset( st->nulls, ' ', 2*sizeof(char) );
659 funcctx->slot = TupleDescGetSlot(tupdesc);
660 funcctx->attinmeta = TupleDescGetAttInMetadata(tupdesc);
662 MemoryContextSwitchTo(oldcontext);
665 st->offset = InvalidOffsetNumber;
666 st->buffer = ReadBuffer( st->index, GIN_ROOT_BLKNO );
670 processTuple( FuncCallContext *funcctx, GinStatState *st, IndexTuple itup ) {
671 MemoryContext oldcontext;
672 #if PG_VERSION_NUM < 80400
676 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
677 st->curval = datumCopy(
678 #if PG_VERSION_NUM >= 90100
679 gintuple_get_key(&st->ginstate, itup, &st->category),
680 #elif PG_VERSION_NUM >= 80400
681 gin_index_getattr(&st->ginstate, itup),
683 index_getattr(itup, FirstOffsetNumber, st->ginstate.tupdesc, &isnull),
685 st->index->rd_att->attrs[st->attnum]->attbyval,
686 st->index->rd_att->attrs[st->attnum]->attlen );
687 MemoryContextSwitchTo(oldcontext);
689 st->dvalues[0] = st->curval;
690 #if PG_VERSION_NUM >= 90100
691 /* do no distiguish various null category */
692 st->nulls[0] = (st->category == GIN_CAT_NORM_KEY) ? ' ' : 'n';
695 if ( GinIsPostingTree(itup) ) {
696 BlockNumber rootblkno = GinGetPostingTree(itup);
697 #if PG_VERSION_NUM >= 90400
698 GinBtreeData btree, *gdi = &btree;
699 GinBtreeStack *stack;
701 GinPostingTreeScan *gdi;
705 uint32 predictNumber;
707 LockBuffer(st->buffer, GIN_UNLOCK);
708 #if PG_VERSION_NUM >= 90400
709 ginPrepareDataScan(gdi, st->index, rootblkno);
710 stack = ginScanBeginPostingTree(gdi, st->index, rootblkno);
711 page = BufferGetPage(stack->buffer);
712 predictNumber = stack->predictNumber;
713 #elif PG_VERSION_NUM >= 90100
714 gdi = ginPrepareScanPostingTree(st->index, rootblkno, TRUE);
715 entrybuffer = ginScanBeginPostingTree(gdi);
716 page = BufferGetPage(entrybuffer);
717 predictNumber = gdi->stack->predictNumber;
719 gdi = prepareScanPostingTree(st->index, rootblkno, TRUE);
720 entrybuffer = scanBeginPostingTree(gdi);
721 page = BufferGetPage(entrybuffer);
722 predictNumber = gdi->stack->predictNumber;
725 st->dvalues[1] = Int32GetDatum( predictNumber * GinPageGetOpaque(page)->maxoff );
727 #if PG_VERSION_NUM < 90400
728 LockBuffer(entrybuffer, GIN_UNLOCK);
729 freeGinBtreeStack(gdi->stack);
732 freeGinBtreeStack(stack);
735 st->dvalues[1] = Int32GetDatum( GinGetNPosting(itup) );
736 LockBuffer(st->buffer, GIN_UNLOCK);
740 PG_FUNCTION_INFO_V1(gin_stat);
741 Datum gin_stat(PG_FUNCTION_ARGS);
743 gin_stat(PG_FUNCTION_ARGS) {
744 FuncCallContext *funcctx;
746 Datum result=(Datum)0;
751 if (SRF_IS_FIRSTCALL()) {
752 text *name=PG_GETARG_TEXT_P(0);
753 funcctx = SRF_FIRSTCALL_INIT();
754 gin_setup_firstcall(funcctx, name, (PG_NARGS()==2) ? PG_GETARG_INT32(1) : 0 );
755 PG_FREE_IF_COPY(name,0);
758 funcctx = SRF_PERCALL_SETUP();
759 st = (GinStatState*)(funcctx->user_fctx);
761 if ( refindPosition(st) == false ) {
762 UnlockReleaseBuffer( st->buffer );
763 gin_index_close(st->index);
765 SRF_RETURN_DONE(funcctx);
771 if (moveRightIfItNeeded(st)==false) {
772 UnlockReleaseBuffer( st->buffer );
773 gin_index_close(st->index);
775 SRF_RETURN_DONE(funcctx);
778 page = BufferGetPage(st->buffer);
779 ituple = (IndexTuple) PageGetItem(page, PageGetItemId(page, st->offset));
781 #if PG_VERSION_NUM >= 80400
782 if (st->attnum + 1 == gintuple_get_attrnum(&st->ginstate, ituple))
787 processTuple( funcctx, st, ituple );
789 htuple = heap_formtuple(funcctx->attinmeta->tupdesc, st->dvalues, st->nulls);
790 result = TupleGetDatum(funcctx->slot, htuple);
792 SRF_RETURN_NEXT(funcctx, result);
795 PG_FUNCTION_INFO_V1(gin_count_estimate);
796 Datum gin_count_estimate(PG_FUNCTION_ARGS);
797 #if PG_VERSION_NUM >= 80300
799 gin_count_estimate(PG_FUNCTION_ARGS) {
800 text *name=PG_GETARG_TEXT_P(0);
804 char *relname=t2c(name);
806 #if PG_VERSION_NUM >= 80400
807 TIDBitmap *bitmap = tbm_create(work_mem * 1024L);
810 ItemPointerData tids[MAXTIDS];
815 index = gin_index_open(
816 makeRangeVarFromNameList(stringToQualifiedNameList(relname, "gin_count_estimate")));
818 if ( index->rd_opcintype[0] != TSVECTOROID ) {
819 gin_index_close(index);
820 elog(ERROR, "Column type is not a tsvector");
825 key.sk_strategy = TSearchStrategyNumber;
827 key.sk_argument = PG_GETARG_DATUM(1);
829 fmgr_info( F_TS_MATCH_VQ , &key.sk_func );
831 #if PG_VERSION_NUM >= 90100
832 #if PG_VERSION_NUM >= 90400
833 scan = index_beginscan_bitmap(index, GetTransactionSnapshot(), 1);
835 scan = index_beginscan_bitmap(index, SnapshotNow, 1);
837 index_rescan(scan, &key, 1, NULL, 0);
839 count = index_getbitmap(scan, bitmap);
841 #elif PG_VERSION_NUM >= 80400
842 scan = index_beginscan_bitmap(index, SnapshotNow, 1, &key);
844 count = index_getbitmap(scan, bitmap);
847 scan = index_beginscan_multi(index, SnapshotNow, 1, &key);
850 more = index_getmulti(scan, tids, MAXTIDS, &returned_tids);
851 count += returned_tids;
855 index_endscan( scan );
856 gin_index_close(index);
858 PG_RETURN_INT64(count);
862 gin_count_estimate(PG_FUNCTION_ARGS) {
863 elog(NOTICE, "Function is not working under PgSQL < 8.3");
869 PG_FUNCTION_INFO_V1(spgist_stat);
870 Datum spgist_stat(PG_FUNCTION_ARGS);
872 spgist_stat(PG_FUNCTION_ARGS)
874 #if PG_VERSION_NUM < 90200
875 elog(NOTICE, "Function is not working under PgSQL < 9.2");
877 PG_RETURN_TEXT_P(CStringGetTextDatum("???"));
879 text *name = PG_GETARG_TEXT_P(0);
883 BlockNumber totalPages = 0,
888 double usedSpace = 0.0;
891 int64 innerTuples = 0,
894 nLeafPlaceholder = 0,
895 nInnerPlaceholder = 0,
899 #define IS_INDEX(r) ((r)->rd_rel->relkind == RELKIND_INDEX)
900 #define IS_SPGIST(r) ((r)->rd_rel->relam == SPGIST_AM_OID)
902 relvar = makeRangeVarFromNameList(textToQualifiedNameList(name));
903 index = relation_openrv(relvar, AccessExclusiveLock);
905 if (!IS_INDEX(index) || !IS_SPGIST(index))
906 elog(ERROR, "relation \"%s\" is not an SPGiST index",
907 RelationGetRelationName(index));
909 totalPages = RelationGetNumberOfBlocks(index);
911 for (blkno = SPGIST_ROOT_BLKNO; blkno < totalPages; blkno++)
917 buffer = ReadBuffer(index, blkno);
918 LockBuffer(buffer, BUFFER_LOCK_SHARE);
920 page = BufferGetPage(buffer);
922 if (PageIsNew(page) || SpGistPageIsDeleted(page))
925 UnlockReleaseBuffer(buffer);
929 if (SpGistPageIsLeaf(page))
932 leafTuples += PageGetMaxOffsetNumber(page);
933 nLeafPlaceholder += SpGistPageGetOpaque(page)->nPlaceholder;
934 nLeafRedirect += SpGistPageGetOpaque(page)->nRedirection;
942 max = PageGetMaxOffsetNumber(page);
944 nInnerPlaceholder += SpGistPageGetOpaque(page)->nPlaceholder;
945 nInnerRedirect += SpGistPageGetOpaque(page)->nRedirection;
946 for (i = FirstOffsetNumber; i <= max; i++)
950 it = (SpGistInnerTuple) PageGetItem(page,
951 PageGetItemId(page, i));
958 bufferSize = BufferGetPageSize(buffer)
959 - MAXALIGN(sizeof(SpGistPageOpaqueData))
960 - SizeOfPageHeaderData;
962 pageFree = PageGetExactFreeSpace(page);
964 usedSpace += bufferSize - pageFree;
966 if (pageFree == bufferSize)
969 UnlockReleaseBuffer(buffer);
972 index_close(index, AccessExclusiveLock);
974 totalPages--; /* discount metapage */
976 snprintf(res, sizeof(res),
982 "usedSpace: %.2f kbytes\n"
983 "freeSpace: %.2f kbytes\n"
984 "fillRatio: %.2f%%\n"
985 "leafTuples: " INT64_FORMAT "\n"
986 "innerTuples: " INT64_FORMAT "\n"
987 "innerAllTheSame: " INT64_FORMAT "\n"
988 "leafPlaceholders: " INT64_FORMAT "\n"
989 "innerPlaceholders: " INT64_FORMAT "\n"
990 "leafRedirects: " INT64_FORMAT "\n"
991 "innerRedirects: " INT64_FORMAT,
992 totalPages, deletedPages, innerPages, leafPages, emptyPages,
994 (((double) bufferSize) * ((double) totalPages) - usedSpace) / 1024,
995 100.0 * (usedSpace / (((double) bufferSize) * ((double) totalPages))),
996 leafTuples, innerTuples, nAllTheSame,
997 nLeafPlaceholder, nInnerPlaceholder,
998 nLeafRedirect, nInnerRedirect);
1000 PG_RETURN_TEXT_P(CStringGetTextDatum(res));
1004 #if PG_VERSION_NUM >= 90200
1006 typedef struct SPGistPrintStackElem {
1007 ItemPointerData iptr;
1010 } SPGistPrintStackElem;
1012 typedef struct SPGistPrint {
1015 Datum dvalues[7 /* see CreateTemplateTupleDesc call */];
1016 char nulls[7 /* see CreateTemplateTupleDesc call */];
1021 pushSPGistPrint(FuncCallContext *funcctx, SPGistPrint *prst, ItemPointer ip, int level) {
1022 MemoryContext oldcontext;
1023 SPGistPrintStackElem *e;
1025 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
1027 e = palloc(sizeof(*e));
1031 prst->stack = lcons(e, prst->stack);
1033 MemoryContextSwitchTo(oldcontext);
1037 close_spgist_print(SPGistPrint *prst) {
1038 index_close(prst->index, AccessExclusiveLock);
1042 PG_FUNCTION_INFO_V1(spgist_print);
1043 Datum spgist_print(PG_FUNCTION_ARGS);
1045 spgist_print(PG_FUNCTION_ARGS)
1047 #if PG_VERSION_NUM < 90200
1048 elog(NOTICE, "Function is not working under PgSQL < 9.2");
1050 PG_RETURN_TEXT_P(CStringGetTextDatum("???"));
1052 FuncCallContext *funcctx;
1054 SPGistPrintStackElem *s;
1057 MemoryContext oldcontext;
1059 if (SRF_IS_FIRSTCALL()) {
1060 text *name=PG_GETARG_TEXT_P(0);
1063 ItemPointerData ipd;
1066 funcctx = SRF_FIRSTCALL_INIT();
1067 relvar = makeRangeVarFromNameList(textToQualifiedNameList(name));
1068 index = relation_openrv(relvar, AccessExclusiveLock);
1070 if (!IS_INDEX(index) || !IS_SPGIST(index))
1071 elog(ERROR, "relation \"%s\" is not an SPGiST index",
1072 RelationGetRelationName(index));
1074 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
1076 prst = palloc(sizeof(*prst));
1078 prst->index = index;
1079 initSpGistState(&prst->state, index);
1081 tupdesc = CreateTemplateTupleDesc(3 /* types */ + 1 /* level */ + 1 /* nlabel */ + 2 /* tids */, false);
1082 TupleDescInitEntry(tupdesc, 1, "tid", TIDOID, -1, 0);
1083 TupleDescInitEntry(tupdesc, 2, "node", INT4OID, -1, 0);
1084 TupleDescInitEntry(tupdesc, 3, "level", INT4OID, -1, 0);
1085 TupleDescInitEntry(tupdesc, 4, "tid_pointer", TIDOID, -1, 0);
1086 TupleDescInitEntry(tupdesc, 5, "prefix",
1087 (prst->state.attPrefixType.type == VOIDOID) ? INT4OID : prst->state.attPrefixType.type, -1, 0);
1088 TupleDescInitEntry(tupdesc, 6, "label",
1089 (prst->state.attLabelType.type == VOIDOID) ? INT4OID : prst->state.attLabelType.type, -1, 0);
1090 TupleDescInitEntry(tupdesc, 7, "leaf",
1091 (prst->state.attType.type == VOIDOID) ? INT4OID : prst->state.attType.type, -1, 0);
1093 funcctx->slot = TupleDescGetSlot(tupdesc);
1094 funcctx->attinmeta = TupleDescGetAttInMetadata(tupdesc);
1096 funcctx->user_fctx = (void*)prst;
1098 MemoryContextSwitchTo(oldcontext);
1100 ItemPointerSet(&ipd, SPGIST_ROOT_BLKNO, FirstOffsetNumber);
1102 pushSPGistPrint(funcctx, prst, &ipd, 1);
1104 PG_FREE_IF_COPY(name,0);
1107 funcctx = SRF_PERCALL_SETUP();
1108 prst = (SPGistPrint*)(funcctx->user_fctx);
1112 if ( prst->stack == NIL ) {
1113 close_spgist_print(prst);
1114 SRF_RETURN_DONE(funcctx);
1117 CHECK_FOR_INTERRUPTS();
1119 s = (SPGistPrintStackElem*)linitial(prst->stack);
1120 prst->stack = list_delete_first(prst->stack);
1122 if (ItemPointerIsValid(&s->iptr))
1130 SpGistDeadTuple dtuple;
1133 buffer = ReadBuffer(prst->index, ItemPointerGetBlockNumber(&s->iptr));
1134 LockBuffer(buffer, BUFFER_LOCK_SHARE);
1136 page = BufferGetPage(buffer);
1137 if (ItemPointerGetOffsetNumber(&s->iptr) > PageGetMaxOffsetNumber(page)) {
1138 UnlockReleaseBuffer(buffer);
1143 dtuple = (SpGistDeadTuple)PageGetItem(page, PageGetItemId(page, ItemPointerGetOffsetNumber(&s->iptr)));
1145 if (dtuple->tupstate != SPGIST_LIVE) {
1146 UnlockReleaseBuffer(buffer);
1151 if (SpGistPageIsLeaf(page)) {
1152 SpGistLeafTuple leafTuple = (SpGistLeafTuple)dtuple;
1154 tid = palloc(sizeof(ItemPointerData));
1156 prst->dvalues[0] = PointerGetDatum(tid);
1157 prst->nulls[0] = ' ';
1158 prst->nulls[1] = 'n';
1159 prst->dvalues[2] = s->level;
1160 prst->nulls[2] = ' ';
1161 prst->nulls[3] = 'n';
1162 prst->nulls[4] = 'n';
1163 prst->nulls[5] = 'n';
1164 prst->dvalues[6] = datumCopy(SGLTDATUM(leafTuple, &prst->state),
1165 prst->state.attType.attbyval, prst->state.attType.attlen);
1166 prst->nulls[6] = ' ';
1168 SpGistInnerTuple innerTuple = (SpGistInnerTuple)dtuple;
1170 SpGistNodeTuple node;
1172 SGITITERATE(innerTuple, i, node) {
1173 if (ItemPointerIsValid(&node->t_tid)) {
1179 if (i >= innerTuple->nNodes) {
1180 UnlockReleaseBuffer(buffer);
1185 tid = palloc(sizeof(ItemPointerData));
1187 prst->dvalues[0] = PointerGetDatum(tid);
1188 prst->nulls[0] = ' ';
1189 prst->dvalues[1] = Int32GetDatum(s->nlabel);
1190 prst->nulls[1] = ' ';
1191 prst->dvalues[2] = s->level;
1192 prst->nulls[2] = ' ';
1193 tid = palloc(sizeof(ItemPointerData));
1195 prst->dvalues[3] = PointerGetDatum(tid);
1196 prst->nulls[3] = ' ';
1197 if (prst->state.attPrefixType.attbyval != VOIDOID && innerTuple->prefixSize > 0) {
1198 prst->dvalues[4] = datumCopy(SGITDATUM(innerTuple, &prst->state),
1199 prst->state.attPrefixType.attbyval, prst->state.attPrefixType.attlen);
1200 prst->nulls[4] = ' ';
1202 prst->nulls[4] = 'n';
1203 if (prst->state.attLabelType.attbyval != VOIDOID && !IndexTupleHasNulls(node)) {
1204 prst->dvalues[5] = datumCopy(SGNTDATUM(node, &prst->state),
1205 prst->state.attLabelType.attbyval, prst->state.attLabelType.attlen);
1206 prst->nulls[5] = ' ';
1208 prst->nulls[5] = 'n';
1209 prst->nulls[6] = 'n';
1211 pushSPGistPrint(funcctx, prst, &node->t_tid, s->level + 1);
1213 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
1214 prst->stack = lcons(s, prst->stack);
1215 MemoryContextSwitchTo(oldcontext);
1219 UnlockReleaseBuffer(buffer);
1223 htuple = heap_formtuple(funcctx->attinmeta->tupdesc, prst->dvalues, prst->nulls);
1224 result = TupleGetDatum(funcctx->slot, htuple);
1226 SRF_RETURN_NEXT(funcctx, result);