Files
privacore-open-source-searc…/RdbBuckets.h

230 lines
7.2 KiB
C++

// Zak Betz, Copyright, Jun 2008
// A sorted list of sorted lists for storing rdb keys. Faster and more
// cache friendly than RdbTree. Optimized for batched adds, amortized O(1)
// add operation, O(log n) for retrival, ranged getList for k keys is
// O(log(n) + k) where as RdbTree is O(k * log(n)).
// Memory is alloced and used on a on demand basis rather than all up
// front as with RdbTree, so memory usage is much lower most of the time.
// Collections are handled as a linked list, each RdbBuckets has a nextColl
// pointer. The front bucket acts as the gatekeeper for all of the
// other buckets, Only it's values for needsSave and isWritable are
// significant
//when selecting bucketnum and also when deduping, use KEYCMPNEGEQ which
//will mask off the delbit, that way pos and neg keys will be in the same
//bucket and only the newest key will survive. When getting or deleting
//a list, use KEYCMP within a bucket and use KEYCMPNEGEQ to select the
//bucket nums. This is because iterators in rdb dump get a list, then
//add 1 to a key and get the next list and adding 1 to a pos key will get
//the negative one.
#ifndef GB_RDBBUCKETS_H
#define GB_RDBBUCKETS_H
#include "Mem.h" // for g_mem.calloc and g_mem.malloc
#include "BigFile.h" // for saving and loading the tree
#include "RdbList.h"
#include "RdbMem.h"
#include "RdbTree.h"
#include "rdbid_t.h"
class RdbBuckets;
class RdbBucket {
public:
RdbBucket() {}
~RdbBucket();
bool set(RdbBuckets *parent, char *newbuf );
void reset();
void clear();
void reBuf(char *newbuf);
char *getFirstKey();
const char *getFirstKey() const { return const_cast<RdbBucket*>(this)->getFirstKey(); }
char *getEndKey() { return m_endKey; }
const char *getEndKey() const { return m_endKey; }
int32_t getNumKeys() const { return m_numKeys; }
char *getKeys() { return m_keys; }
const char *getKeys() const { return m_keys; }
collnum_t getCollnum() const { return m_collnum; }
void setCollnum(collnum_t c) { m_collnum = c; }
bool addKey(const char *key , char *data , int32_t dataSize);
char *getKeyVal ( const char *key , char **data , int32_t* dataSize );
int32_t getKeyNumExact(const char* key) const; //returns -1 if not found
int32_t getNumNegativeKeys() const;
void resetLastSorted() { m_lastSorted = 0; }
bool getList(RdbList* list,
const char *startKey,
const char *endKey,
int32_t minRecSizes,
int32_t *numPosRecs,
int32_t *numNegRecs,
bool useHalfKeys);
bool deleteList(RdbList *list);
int getListSizeExact ( const char *startKey, const char *endKey );
//Save State
int64_t fastSave_r(int fd, int64_t offset);
int64_t fastLoad(BigFile *f, int64_t offset);
//Debug
bool selfTest ( char *prevKey);
void printBucket();
bool sort();
RdbBucket *split(RdbBucket *newBucket);
private:
char *m_endKey;
char *m_keys;
RdbBuckets *m_parent;
int32_t m_numKeys;
int32_t m_lastSorted;
collnum_t m_collnum;
};
class RdbBuckets {
friend class RdbBucket;
public:
RdbBuckets( );
~RdbBuckets( );
void clear();
void reset();
bool set(int32_t fixedDataSize, int32_t maxMem, const char *allocName, rdbid_t rdbId, const char *dbname, char keySize);
bool resizeTable(int32_t numNeeded);
int32_t addNode ( collnum_t collnum ,
char *key , char *data , int32_t dataSize );
bool addList(RdbList* list, collnum_t collnum);
char* getKeyVal ( collnum_t collnum, const char *key ,
char **data , int32_t* dataSize );
bool getList ( collnum_t collnum ,
const char *startKey, const char *endKey, int32_t minRecSizes ,
RdbList *list , int32_t *numPosRecs , int32_t *numNegRecs ,
bool useHalfKeys );
bool deleteList(collnum_t collnum, RdbList *list);
int64_t getListSize ( collnum_t collnum,
const char *startKey, const char *endKey,
char *minKey, char *maxKey );
int getListSizeExact ( collnum_t collnum ,
const char *startKey,
const char *endKey ) ;
bool addBucket (RdbBucket *newBucket, int32_t i);
int32_t getBucketNum(const char *key, collnum_t collnum);
char bucketCmp(const char *akey, collnum_t acoll, const char *bkey, collnum_t bcoll);
char bucketCmp(const char *akey, collnum_t acoll, RdbBucket* b);
bool collExists(collnum_t coll);
const RdbBucket* getBucket(int i) const { return m_buckets[i]; }
int32_t getNumBuckets() const { return m_numBuckets; }
const char *getDbname() const { return m_dbname; }
uint8_t getKeySize() const { return m_ks; }
int32_t getFixedDataSize() { return m_fixedDataSize;}
int32_t getRecSize() { return m_recSize; }
void setSwapBuf(char *s) { m_swapBuf = s; }
char *getSwapBuf() { return m_swapBuf; }
bool needsSave() const { return m_needsSave; }
bool isSaving() const { return m_isSaving; }
char *getSortBuf() { return m_sortBuf; }
int32_t getSortBufSize() const { return m_sortBufSize; }
bool isWritable() const { return m_isWritable; }
void disableWrites () { m_isWritable = false; }
void enableWrites () { m_isWritable = true ; }
int32_t getMaxMem() const { return m_maxMem; }
void setNeedsSave(bool s);
int32_t getMemAlloced() const;
int32_t getMemAvailable() const;
bool is90PercentFull() const;
bool needsDump() const;
bool hasRoom( int32_t numRecs ) const;
int32_t getNumKeys() const;
int32_t getMemOccupied() const;
int32_t getNumNegativeKeys() const;
int32_t getNumPositiveKeys() const;
void cleanBuckets ( );
bool delColl ( collnum_t collnum );
//just for this collection
int32_t getNumKeys ( collnum_t collnum ) const;
//syntactic sugar
RdbBucket* bucketFactory();
void updateNumRecs(int32_t n, int32_t bytes, int32_t numNeg);
//DEBUG
bool selfTest(bool thorough, bool core);
int32_t addTree(RdbTree *rt);
void printBuckets();
bool repair();
bool testAndRepair();
//Save/Load/Dump
bool fastSave(const char *dir, bool useThread, void *state, void (*callback)(void *state));
bool fastSave_r();
int64_t fastSaveColl_r(int fd, int64_t offset);
bool loadBuckets(const char *dbname);
bool fastLoad(BigFile *f, const char *dbname);
int64_t fastLoadColl(BigFile *f, const char *dbname, int64_t offset);
private:
RdbBucket **m_buckets;
RdbBucket *m_bucketsSpace;
char *m_masterPtr;
int32_t m_masterSize;
int32_t m_firstOpenSlot;
int32_t m_numBuckets;
int32_t m_maxBuckets;
uint8_t m_ks;
int32_t m_fixedDataSize;
int32_t m_recSize;
int32_t m_numKeysApprox;//includes dups
int32_t m_numNegKeys;
int32_t m_maxMem;
int32_t m_maxBucketsCapacity;
int32_t m_dataMemOccupied;
rdbid_t m_rdbId;
const char *m_dbname;
char *m_swapBuf;
char *m_sortBuf;
int32_t m_sortBufSize;
bool m_repairMode;
bool m_isWritable;
bool m_isSaving;
// true if buckets was modified and needs to be saved
bool m_needsSave;
const char *m_dir;
void *m_state;
void (*m_callback) (void *state);
int32_t m_saveErrno;
const char *m_allocName;
};
#endif // GB_RDBBUCKETS_H