2006-05-02 13:28:56 +02:00
|
|
|
/*--------------------------------------------------------------------------
|
|
|
|
* gin.h
|
2006-10-04 02:30:14 +02:00
|
|
|
* header file for postgres inverted index access method implementation.
|
2006-05-02 13:28:56 +02:00
|
|
|
*
|
2006-10-04 02:30:14 +02:00
|
|
|
* Copyright (c) 2006, PostgreSQL Global Development Group
|
2007-01-31 16:09:45 +01:00
|
|
|
* $PostgreSQL: pgsql/src/include/access/gin.h,v 1.10 2007/01/31 15:09:45 teodor Exp $
|
2006-05-02 13:28:56 +02:00
|
|
|
*--------------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef GIN_H
|
|
|
|
#define GIN_H
|
|
|
|
|
2006-07-11 15:54:25 +02:00
|
|
|
#include "access/relscan.h"
|
|
|
|
#include "access/skey.h"
|
2006-05-02 13:28:56 +02:00
|
|
|
#include "access/xlog.h"
|
|
|
|
#include "access/xlogdefs.h"
|
|
|
|
#include "storage/bufpage.h"
|
|
|
|
#include "storage/off.h"
|
|
|
|
#include "utils/rel.h"
|
|
|
|
#include "access/itup.h"
|
|
|
|
#include "fmgr.h"
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* amproc indexes for inverted indexes.
|
|
|
|
*/
|
2006-10-04 02:30:14 +02:00
|
|
|
#define GIN_COMPARE_PROC 1
|
|
|
|
#define GIN_EXTRACTVALUE_PROC 2
|
|
|
|
#define GIN_EXTRACTQUERY_PROC 3
|
|
|
|
#define GIN_CONSISTENT_PROC 4
|
|
|
|
#define GINNProcs 4
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
typedef XLogRecPtr GinNSN;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Page opaque data in a inverted index page.
|
|
|
|
*/
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct GinPageOpaqueData
|
|
|
|
{
|
|
|
|
uint16 flags;
|
|
|
|
OffsetNumber maxoff; /* number entries on GIN_DATA page: number of
|
|
|
|
* heap ItemPointer on GIN_DATA|GIN_LEAF page
|
|
|
|
* and number of records on GIN_DATA &
|
|
|
|
* ~GIN_LEAF page */
|
|
|
|
BlockNumber rightlink;
|
2006-05-02 13:28:56 +02:00
|
|
|
} GinPageOpaqueData;
|
|
|
|
|
|
|
|
typedef GinPageOpaqueData *GinPageOpaque;
|
|
|
|
|
|
|
|
#define GIN_ROOT_BLKNO (0)
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct
|
|
|
|
{
|
|
|
|
BlockIdData child_blkno; /* use it instead of BlockNumber to save space
|
|
|
|
* on page */
|
|
|
|
ItemPointerData key;
|
2006-05-02 13:28:56 +02:00
|
|
|
} PostingItem;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
#define PostingItemGetBlockNumber(pointer) \
|
2006-05-02 13:28:56 +02:00
|
|
|
BlockIdGetBlockNumber(&(pointer)->child_blkno)
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
#define PostingItemSetBlockNumber(pointer, blockNumber) \
|
2006-05-02 13:28:56 +02:00
|
|
|
BlockIdSet(&((pointer)->child_blkno), (blockNumber))
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Page opaque data in a inverted index page.
|
|
|
|
*/
|
2006-10-04 02:30:14 +02:00
|
|
|
#define GIN_DATA (1 << 0)
|
|
|
|
#define GIN_LEAF (1 << 1)
|
|
|
|
#define GIN_DELETED (1 << 2)
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/*
|
2006-10-04 02:30:14 +02:00
|
|
|
* Works on page
|
2006-05-02 13:28:56 +02:00
|
|
|
*/
|
|
|
|
#define GinPageGetOpaque(page) ( (GinPageOpaque) PageGetSpecialPointer(page) )
|
|
|
|
|
|
|
|
#define GinPageIsLeaf(page) ( GinPageGetOpaque(page)->flags & GIN_LEAF )
|
|
|
|
#define GinPageSetLeaf(page) ( GinPageGetOpaque(page)->flags |= GIN_LEAF )
|
|
|
|
#define GinPageSetNonLeaf(page) ( GinPageGetOpaque(page)->flags &= ~GIN_LEAF )
|
|
|
|
#define GinPageIsData(page) ( GinPageGetOpaque(page)->flags & GIN_DATA )
|
|
|
|
#define GinPageSetData(page) ( GinPageGetOpaque(page)->flags |= GIN_DATA )
|
|
|
|
|
|
|
|
#define GinPageIsDeleted(page) ( GinPageGetOpaque(page)->flags & GIN_DELETED)
|
|
|
|
#define GinPageSetDeleted(page) ( GinPageGetOpaque(page)->flags |= GIN_DELETED)
|
|
|
|
#define GinPageSetNonDeleted(page) ( GinPageGetOpaque(page)->flags &= ~GIN_DELETED)
|
|
|
|
|
|
|
|
#define GinPageRightMost(page) ( GinPageGetOpaque(page)->rightlink == InvalidBlockNumber)
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Define our ItemPointerGet(BlockNumber|GetOffsetNumber)
|
|
|
|
* to prevent asserts
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define GinItemPointerGetBlockNumber(pointer) \
|
|
|
|
BlockIdGetBlockNumber(&(pointer)->ip_blkid)
|
|
|
|
|
|
|
|
#define GinItemPointerGetOffsetNumber(pointer) \
|
|
|
|
((pointer)->ip_posid)
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Support work on IndexTuuple on leaf pages
|
|
|
|
*/
|
|
|
|
#define GinGetNPosting(itup) GinItemPointerGetOffsetNumber(&(itup)->t_tid)
|
|
|
|
#define GinSetNPosting(itup,n) ItemPointerSetOffsetNumber(&(itup)->t_tid,(n))
|
|
|
|
#define GIN_TREE_POSTING ((OffsetNumber)0xffff)
|
|
|
|
#define GinIsPostingTree(itup) ( GinGetNPosting(itup)==GIN_TREE_POSTING )
|
2006-10-04 02:30:14 +02:00
|
|
|
#define GinSetPostingTree(itup, blkno) ( GinSetNPosting((itup),GIN_TREE_POSTING ), ItemPointerSetBlockNumber(&(itup)->t_tid, blkno) )
|
|
|
|
#define GinGetPostingTree(itup) GinItemPointerGetBlockNumber(&(itup)->t_tid)
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
#define GinGetOrigSizePosting(itup) GinItemPointerGetBlockNumber(&(itup)->t_tid)
|
2006-05-02 13:28:56 +02:00
|
|
|
#define GinSetOrigSizePosting(itup,n) ItemPointerSetBlockNumber(&(itup)->t_tid,(n))
|
|
|
|
#define GinGetPosting(itup) ( (ItemPointer)(( ((char*)(itup)) + SHORTALIGN(GinGetOrigSizePosting(itup)) )) )
|
|
|
|
|
|
|
|
#define GinMaxItemSize \
|
2006-10-04 02:30:14 +02:00
|
|
|
((BLCKSZ - SizeOfPageHeaderData - \
|
2006-05-02 13:28:56 +02:00
|
|
|
MAXALIGN(sizeof(GinPageOpaqueData))) / 3 - sizeof(ItemIdData))
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Data (posting tree) pages
|
|
|
|
*/
|
|
|
|
#define GinDataPageGetData(page) \
|
|
|
|
(PageGetContents(page)+MAXALIGN(sizeof(ItemPointerData)))
|
|
|
|
#define GinDataPageGetRightBound(page) ((ItemPointer)PageGetContents(page))
|
2006-10-04 02:30:14 +02:00
|
|
|
#define GinSizeOfItem(page) ( (GinPageIsLeaf(page)) ? sizeof(ItemPointerData) : sizeof(PostingItem) )
|
|
|
|
#define GinDataPageGetItem(page,i) ( GinDataPageGetData(page) + ((i)-1) * GinSizeOfItem(page) )
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
#define GinDataPageGetFreeSpace(page) \
|
|
|
|
( BLCKSZ - SizeOfPageHeaderData - MAXALIGN(sizeof(GinPageOpaqueData)) - \
|
|
|
|
GinPageGetOpaque(page)->maxoff * GinSizeOfItem(page) - \
|
|
|
|
MAXALIGN(sizeof(ItemPointerData)))
|
|
|
|
|
|
|
|
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
#define GIN_UNLOCK BUFFER_LOCK_UNLOCK
|
|
|
|
#define GIN_SHARE BUFFER_LOCK_SHARE
|
2006-05-02 13:28:56 +02:00
|
|
|
#define GIN_EXCLUSIVE BUFFER_LOCK_EXCLUSIVE
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct GinState
|
|
|
|
{
|
2006-05-02 13:28:56 +02:00
|
|
|
FmgrInfo compareFn;
|
|
|
|
FmgrInfo extractValueFn;
|
|
|
|
FmgrInfo extractQueryFn;
|
|
|
|
FmgrInfo consistentFn;
|
|
|
|
|
|
|
|
TupleDesc tupdesc;
|
|
|
|
} GinState;
|
|
|
|
|
|
|
|
/* XLog stuff */
|
|
|
|
|
|
|
|
#define XLOG_GIN_CREATE_INDEX 0x00
|
|
|
|
|
|
|
|
#define XLOG_GIN_CREATE_PTREE 0x10
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct ginxlogCreatePostingTree
|
|
|
|
{
|
|
|
|
RelFileNode node;
|
|
|
|
BlockNumber blkno;
|
|
|
|
uint32 nitem;
|
2006-05-02 13:28:56 +02:00
|
|
|
/* follows list of heap's ItemPointer */
|
|
|
|
} ginxlogCreatePostingTree;
|
|
|
|
|
|
|
|
#define XLOG_GIN_INSERT 0x20
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct ginxlogInsert
|
|
|
|
{
|
|
|
|
RelFileNode node;
|
|
|
|
BlockNumber blkno;
|
|
|
|
BlockNumber updateBlkno;
|
|
|
|
OffsetNumber offset;
|
|
|
|
bool isDelete;
|
|
|
|
bool isData;
|
|
|
|
bool isLeaf;
|
|
|
|
OffsetNumber nitem;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* follows: tuples or ItemPointerData or PostingItem or list of
|
|
|
|
* ItemPointerData
|
|
|
|
*/
|
2006-05-02 13:28:56 +02:00
|
|
|
} ginxlogInsert;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
#define XLOG_GIN_SPLIT 0x30
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct ginxlogSplit
|
|
|
|
{
|
|
|
|
RelFileNode node;
|
|
|
|
BlockNumber lblkno;
|
|
|
|
BlockNumber rootBlkno;
|
|
|
|
BlockNumber rblkno;
|
|
|
|
BlockNumber rrlink;
|
|
|
|
OffsetNumber separator;
|
|
|
|
OffsetNumber nitem;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
bool isData;
|
|
|
|
bool isLeaf;
|
|
|
|
bool isRootSplit;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
BlockNumber leftChildBlkno;
|
|
|
|
BlockNumber updateBlkno;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
ItemPointerData rightbound; /* used only in posting tree */
|
2006-05-02 13:28:56 +02:00
|
|
|
/* follows: list of tuple or ItemPointerData or PostingItem */
|
|
|
|
} ginxlogSplit;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
#define XLOG_GIN_VACUUM_PAGE 0x40
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct ginxlogVacuumPage
|
|
|
|
{
|
|
|
|
RelFileNode node;
|
|
|
|
BlockNumber blkno;
|
|
|
|
OffsetNumber nitem;
|
2006-05-02 13:28:56 +02:00
|
|
|
/* follows content of page */
|
|
|
|
} ginxlogVacuumPage;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
#define XLOG_GIN_DELETE_PAGE 0x50
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct ginxlogDeletePage
|
|
|
|
{
|
|
|
|
RelFileNode node;
|
|
|
|
BlockNumber blkno;
|
|
|
|
BlockNumber parentBlkno;
|
|
|
|
OffsetNumber parentOffset;
|
|
|
|
BlockNumber leftBlkno;
|
|
|
|
BlockNumber rightLink;
|
2006-05-02 13:28:56 +02:00
|
|
|
} ginxlogDeletePage;
|
|
|
|
|
|
|
|
/* ginutil.c */
|
2006-07-04 00:45:41 +02:00
|
|
|
extern Datum ginoptions(PG_FUNCTION_ARGS);
|
2006-10-04 02:30:14 +02:00
|
|
|
extern void initGinState(GinState *state, Relation index);
|
2006-05-02 13:28:56 +02:00
|
|
|
extern Buffer GinNewBuffer(Relation index);
|
|
|
|
extern void GinInitBuffer(Buffer b, uint32 f);
|
|
|
|
extern void GinInitPage(Page page, uint32 f, Size pageSize);
|
2006-10-04 02:30:14 +02:00
|
|
|
extern int compareEntries(GinState *ginstate, Datum a, Datum b);
|
2006-10-05 19:57:40 +02:00
|
|
|
extern Datum *extractEntriesS(GinState *ginstate, Datum value,
|
2007-01-31 16:09:45 +01:00
|
|
|
int32 *nentries, bool *needUnique);
|
|
|
|
extern Datum *extractEntriesSU(GinState *ginstate, Datum value, int32 *nentries);
|
2006-10-04 02:30:14 +02:00
|
|
|
extern Page GinPageGetCopyPage(Page page);
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* gininsert.c */
|
|
|
|
extern Datum ginbuild(PG_FUNCTION_ARGS);
|
|
|
|
extern Datum gininsert(PG_FUNCTION_ARGS);
|
|
|
|
|
|
|
|
/* ginxlog.c */
|
|
|
|
extern void gin_redo(XLogRecPtr lsn, XLogRecord *record);
|
|
|
|
extern void gin_desc(StringInfo buf, uint8 xl_info, char *rec);
|
|
|
|
extern void gin_xlog_startup(void);
|
|
|
|
extern void gin_xlog_cleanup(void);
|
2006-08-07 18:57:57 +02:00
|
|
|
extern bool gin_safe_restartpoint(void);
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* ginbtree.c */
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct GinBtreeStack
|
|
|
|
{
|
|
|
|
BlockNumber blkno;
|
|
|
|
Buffer buffer;
|
|
|
|
OffsetNumber off;
|
|
|
|
/* predictNumber contains prediction number of pages on current level */
|
|
|
|
uint32 predictNumber;
|
2006-05-02 13:28:56 +02:00
|
|
|
struct GinBtreeStack *parent;
|
|
|
|
} GinBtreeStack;
|
|
|
|
|
|
|
|
typedef struct GinBtreeData *GinBtree;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct GinBtreeData
|
|
|
|
{
|
2006-05-02 13:28:56 +02:00
|
|
|
/* search methods */
|
2006-10-04 02:30:14 +02:00
|
|
|
BlockNumber (*findChildPage) (GinBtree, GinBtreeStack *);
|
|
|
|
bool (*isMoveRight) (GinBtree, Page);
|
|
|
|
bool (*findItem) (GinBtree, GinBtreeStack *);
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* insert methods */
|
2006-10-04 02:30:14 +02:00
|
|
|
OffsetNumber (*findChildPtr) (GinBtree, Page, BlockNumber, OffsetNumber);
|
|
|
|
BlockNumber (*getLeftMostPage) (GinBtree, Page);
|
|
|
|
bool (*isEnoughSpace) (GinBtree, Buffer, OffsetNumber);
|
|
|
|
void (*placeToPage) (GinBtree, Buffer, OffsetNumber, XLogRecData **);
|
|
|
|
Page (*splitPage) (GinBtree, Buffer, Buffer, OffsetNumber, XLogRecData **);
|
|
|
|
void (*fillRoot) (GinBtree, Buffer, Buffer, Buffer);
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
bool searchMode;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
Relation index;
|
|
|
|
GinState *ginstate;
|
|
|
|
bool fullScan;
|
|
|
|
bool isBuild;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
BlockNumber rightblkno;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* Entry options */
|
2006-10-04 02:30:14 +02:00
|
|
|
Datum entryValue;
|
|
|
|
IndexTuple entry;
|
|
|
|
bool isDelete;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* Data (posting tree) option */
|
2006-10-04 02:30:14 +02:00
|
|
|
ItemPointerData *items;
|
|
|
|
uint32 nitem;
|
|
|
|
uint32 curitem;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
PostingItem pitem;
|
2006-05-02 13:28:56 +02:00
|
|
|
} GinBtreeData;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
extern GinBtreeStack *ginPrepareFindLeafPage(GinBtree btree, BlockNumber blkno);
|
|
|
|
extern GinBtreeStack *ginFindLeafPage(GinBtree btree, GinBtreeStack *stack);
|
|
|
|
extern void freeGinBtreeStack(GinBtreeStack *stack);
|
2006-05-02 13:28:56 +02:00
|
|
|
extern void ginInsertValue(GinBtree btree, GinBtreeStack *stack);
|
2006-10-04 02:30:14 +02:00
|
|
|
extern void findParents(GinBtree btree, GinBtreeStack *stack, BlockNumber rootBlkno);
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* ginentrypage.c */
|
|
|
|
extern IndexTuple GinFormTuple(GinState *ginstate, Datum key, ItemPointerData *ipd, uint32 nipd);
|
|
|
|
extern Datum ginGetHighKey(GinState *ginstate, Page page);
|
2006-10-04 02:30:14 +02:00
|
|
|
extern void prepareEntryScan(GinBtree btree, Relation index, Datum value, GinState *ginstate);
|
2006-05-02 13:28:56 +02:00
|
|
|
extern void entryFillRoot(GinBtree btree, Buffer root, Buffer lbuf, Buffer rbuf);
|
|
|
|
extern IndexTuple ginPageGetLinkItup(Buffer buf);
|
|
|
|
|
|
|
|
/* gindatapage.c */
|
2006-10-04 02:30:14 +02:00
|
|
|
extern int compareItemPointers(ItemPointer a, ItemPointer b);
|
|
|
|
extern void
|
|
|
|
MergeItemPointers(
|
|
|
|
ItemPointerData *dst,
|
|
|
|
ItemPointerData *a, uint32 na,
|
|
|
|
ItemPointerData *b, uint32 nb
|
|
|
|
);
|
|
|
|
|
|
|
|
extern void GinDataPageAddItem(Page page, void *data, OffsetNumber offset);
|
2006-05-02 13:28:56 +02:00
|
|
|
extern void PageDeletePostingItem(Page page, OffsetNumber offset);
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct
|
|
|
|
{
|
|
|
|
GinBtreeData btree;
|
|
|
|
GinBtreeStack *stack;
|
2006-05-02 13:28:56 +02:00
|
|
|
} GinPostingTreeScan;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
extern GinPostingTreeScan *prepareScanPostingTree(Relation index,
|
|
|
|
BlockNumber rootBlkno, bool searchMode);
|
|
|
|
extern void insertItemPointer(GinPostingTreeScan *gdi,
|
|
|
|
ItemPointerData *items, uint32 nitem);
|
|
|
|
extern Buffer scanBeginPostingTree(GinPostingTreeScan *gdi);
|
2006-05-02 13:28:56 +02:00
|
|
|
extern void dataFillRoot(GinBtree btree, Buffer root, Buffer lbuf, Buffer rbuf);
|
2006-10-04 02:30:14 +02:00
|
|
|
extern void prepareDataScan(GinBtree btree, Relation index);
|
|
|
|
|
2006-05-02 13:28:56 +02:00
|
|
|
/* ginscan.c */
|
|
|
|
|
|
|
|
typedef struct GinScanEntryData *GinScanEntry;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct GinScanEntryData
|
|
|
|
{
|
2006-05-02 13:28:56 +02:00
|
|
|
/* link to the equals entry in current scan key */
|
2006-10-04 02:30:14 +02:00
|
|
|
GinScanEntry master;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
/*
|
|
|
|
* link to values reported to consistentFn, points to
|
|
|
|
* GinScanKey->entryRes[i]
|
|
|
|
*/
|
|
|
|
bool *pval;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
/* entry, got from extractQueryFn */
|
|
|
|
Datum entry;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* current ItemPointer to heap, its offset in buffer and buffer */
|
2006-10-04 02:30:14 +02:00
|
|
|
ItemPointerData curItem;
|
|
|
|
OffsetNumber offset;
|
|
|
|
Buffer buffer;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* in case of Posing list */
|
2006-10-04 02:30:14 +02:00
|
|
|
ItemPointerData *list;
|
|
|
|
uint32 nlist;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
bool isFinished;
|
|
|
|
bool reduceResult;
|
|
|
|
uint32 predictNumberResult;
|
2006-05-02 13:28:56 +02:00
|
|
|
} GinScanEntryData;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct GinScanKeyData
|
|
|
|
{
|
|
|
|
/* Number of entries in query (got by extractQueryFn) */
|
|
|
|
uint32 nentries;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* array of ItemPointer result, reported to consistentFn */
|
2006-10-04 02:30:14 +02:00
|
|
|
bool *entryRes;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
/* array of scans per entry */
|
|
|
|
GinScanEntry scanEntry;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* for calling consistentFn(GinScanKey->entryRes, strategy, query) */
|
2006-10-04 02:30:14 +02:00
|
|
|
StrategyNumber strategy;
|
|
|
|
Datum query;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
ItemPointerData curItem;
|
|
|
|
bool firstCall;
|
|
|
|
bool isFinished;
|
2006-05-02 13:28:56 +02:00
|
|
|
} GinScanKeyData;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef GinScanKeyData *GinScanKey;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct GinScanOpaqueData
|
|
|
|
{
|
|
|
|
MemoryContext tempCtx;
|
|
|
|
GinState ginstate;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
GinScanKey keys;
|
|
|
|
uint32 nkeys;
|
2007-01-31 16:09:45 +01:00
|
|
|
bool isVoidRes; /* true if ginstate.extractQueryFn
|
|
|
|
guarantees that nothing will be found */
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
GinScanKey markPos;
|
2006-05-02 13:28:56 +02:00
|
|
|
} GinScanOpaqueData;
|
|
|
|
|
|
|
|
typedef GinScanOpaqueData *GinScanOpaque;
|
|
|
|
|
|
|
|
extern Datum ginbeginscan(PG_FUNCTION_ARGS);
|
|
|
|
extern Datum ginendscan(PG_FUNCTION_ARGS);
|
|
|
|
extern Datum ginrescan(PG_FUNCTION_ARGS);
|
|
|
|
extern Datum ginmarkpos(PG_FUNCTION_ARGS);
|
|
|
|
extern Datum ginrestrpos(PG_FUNCTION_ARGS);
|
2006-07-11 15:54:25 +02:00
|
|
|
extern void newScanKey(IndexScanDesc scan);
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
/* ginget.c */
|
2006-10-04 02:30:14 +02:00
|
|
|
extern DLLIMPORT int GinFuzzySearchLimit;
|
2006-05-02 13:28:56 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
#define ItemPointerSetMax(p) ItemPointerSet( (p), (BlockNumber)0xffffffff, (OffsetNumber)0xffff )
|
|
|
|
#define ItemPointerIsMax(p) ( ItemPointerGetBlockNumber(p) == (BlockNumber)0xffffffff && ItemPointerGetOffsetNumber(p) == (OffsetNumber)0xffff )
|
|
|
|
#define ItemPointerSetMin(p) ItemPointerSet( (p), (BlockNumber)0, (OffsetNumber)0)
|
|
|
|
#define ItemPointerIsMin(p) ( ItemPointerGetBlockNumber(p) == (BlockNumber)0 && ItemPointerGetOffsetNumber(p) == (OffsetNumber)0 )
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
extern Datum gingetmulti(PG_FUNCTION_ARGS);
|
|
|
|
extern Datum gingettuple(PG_FUNCTION_ARGS);
|
|
|
|
|
|
|
|
/* ginvacuum.c */
|
|
|
|
extern Datum ginbulkdelete(PG_FUNCTION_ARGS);
|
|
|
|
extern Datum ginvacuumcleanup(PG_FUNCTION_ARGS);
|
|
|
|
|
|
|
|
/* ginarrayproc.c */
|
|
|
|
extern Datum ginarrayextract(PG_FUNCTION_ARGS);
|
|
|
|
extern Datum ginarrayconsistent(PG_FUNCTION_ARGS);
|
|
|
|
|
|
|
|
/* ginbulk.c */
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct EntryAccumulator
|
|
|
|
{
|
|
|
|
Datum value;
|
|
|
|
uint32 length;
|
|
|
|
uint32 number;
|
2006-05-02 13:28:56 +02:00
|
|
|
ItemPointerData *list;
|
|
|
|
bool shouldSort;
|
2006-10-04 02:30:14 +02:00
|
|
|
struct EntryAccumulator *left;
|
|
|
|
struct EntryAccumulator *right;
|
2006-05-02 13:28:56 +02:00
|
|
|
} EntryAccumulator;
|
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
typedef struct
|
|
|
|
{
|
|
|
|
GinState *ginstate;
|
|
|
|
EntryAccumulator *entries;
|
2006-07-11 18:55:34 +02:00
|
|
|
uint32 maxdepth;
|
2006-10-04 02:30:14 +02:00
|
|
|
EntryAccumulator **stack;
|
|
|
|
uint32 stackpos;
|
|
|
|
uint32 allocatedMemory;
|
2006-07-11 18:55:34 +02:00
|
|
|
|
2006-10-04 02:30:14 +02:00
|
|
|
uint32 length;
|
|
|
|
EntryAccumulator *entryallocator;
|
2006-05-02 13:28:56 +02:00
|
|
|
} BuildAccumulator;
|
|
|
|
|
|
|
|
extern void ginInitBA(BuildAccumulator *accum);
|
2006-10-04 02:30:14 +02:00
|
|
|
extern void ginInsertRecordBA(BuildAccumulator *accum,
|
2007-01-31 16:09:45 +01:00
|
|
|
ItemPointer heapptr, Datum *entries, int32 nentry);
|
2006-10-04 02:30:14 +02:00
|
|
|
extern ItemPointerData *ginGetEntry(BuildAccumulator *accum, Datum *entry, uint32 *n);
|
2006-05-02 13:28:56 +02:00
|
|
|
|
|
|
|
#endif
|