#include <catalog/PersistentCatCache.h>

Inheritance diagram for taco::PersistentCatCache:

Classes
struct	FileHandle
	An opaque handle for a catalog file. More...

Public Member Functions
	PersistentCatCache ()

Public Member Functions inherited from taco::CatCacheBase< PersistentCatCache >
	CatCacheBase ()

void	InitializeFromExistingData ()
	Initializes the catalog cache from the existing data. More...

void	InitializeFromInitData (const std::string &init_datafile)
	Creates the catalog from an init data file and initializes the catalog cache. More...

constexpr bool	IsInitialized () const
	Returns if the catalog cache has been initialized. More...

std::shared_ptr< const SysTable_Table >	FindTable (Oid tabid)

Oid	FindTableByName (absl::string_view tabname)

std::shared_ptr< const TableDesc >	FindTableDesc (Oid tabid)

std::shared_ptr< const SysTable_Type >	FindType (Oid typid)

std::string	GetTypeName (Oid typid)
	Returns the type name of the specified type if it exists. More...

std::shared_ptr< const SysTable_Function >	FindFunction (Oid funcid)

Oid	FindFunctionByName (absl::string_view funcname)

std::shared_ptr< const SysTable_FunctionArgs >	FindFunctionArgs (Oid funcid, int16_t funcargid)

std::shared_ptr< const SysTable_Index >	FindIndex (Oid idxid)

Oid	FindIndexByName (absl::string_view idxname)

std::vector< Oid >	FindAllIndexesOfTable (Oid idxtabid)

std::shared_ptr< const IndexDesc >	FindIndexDesc (Oid idxid)

Oid	FindOperator (OpType optype, Oid oparg0typid, Oid oparg1typid)
	Returns the operator function id of the one with the specific operand types and operator type. More...

Oid	FindCast (Oid castoprtypid, Oid castrettypid, bool must_be_implicit)
	Returns the cast function id of the one with the specific operand type and return type. More...

std::shared_ptr< const SysTable_Aggregation >	FindAggregation (Oid aggid)
	Returns the aggregation systable struct for the aggregation with ID `aggid`. More...

Oid	FindAggregationByNameAndOprType (absl::string_view aggname, Oid aggoprtypid)
	Returns the aggregation ID for the aggregation with the given name and aggregation operand type. More...

Oid	FindAggregationByTidAndOprType (AggType aggtyp, Oid aggoprtypid)
	Returns the aggregation ID for the aggregation with the given type and operand type. More...

CCLookupTableEntry *	SearchForCatalogEntryByOid (Oid systabid, Oid idxid_hint, FieldId oid_colid, Oid oid)
	Searches for the systable entry with ID `recid` in the given systable `systabid`. More...

CCLookupTableEntry *	SearchForCatalogEntryByName (Oid systabid, Oid idxid_hint, FieldId name_colid, absl::string_view name)
	Searches for the systable entry with its name column at `name_colid` equals to `name`. More...

Oid	AddTable (absl::string_view tabname, std::vector< Oid > coltypid, std::vector< uint64_t > coltypparam, std::vector< std::string > field_names, std::vector< bool > colisnullable, std::vector< bool > colisarray, FileId tabfid)
	Adds a table into the catalog. More...

Oid	AddIndex (absl::string_view idxname, Oid idxtabid, IdxType idxtyp, bool idxunique, std::vector< FieldId > idxcoltabcolids, FileId idxfid, std::vector< Oid > idxcolltfuncids, std::vector< Oid > idxcoleqfuncids)
	Adds an index into the catalog. More...

Private Types
typedef ScopedBufferId	PageHandle
	An opaque handle for a data page in an unformatted catalog file. More...

typedef Table::Iterator	CatFileIterator
	An opaque handle for iterating a catalog file. More...

Private Member Functions
FileId	CreateCatalogFile (bool format_heapfile)
	Creates a new catalog file and returns its file ID. More...

FileHandle	OpenCatalogFile (FileId fid, const TableDesc *tabdesc)
	Opens a catalog file for access. More...

void	CloseCatalogFile (FileHandle &fh)
	Closes a catalog file pointed by the file handle. More...

PageHandle	GetFirstPage (FileHandle &fh, char **pagebuf)
	Returns a handle to the first page in the unformatted catalog file with it pinned in the memory. More...

void	MarkPageDirty (PageHandle &pghandle)
	Marks a page pointed by the page handle as dirty. More...

void	ReleasePage (PageHandle &pghandle)
	Releases the pin over the page pointed by the page handle. More...

void	AppendRecord (FileHandle &fh, Record &rec)
	Appends a record to the catalog file specified by the file ID. More...

CatFileIterator	IterateCatEntry (FileHandle &fh)
	Creates an iterator over the catalog file specified by the file ID. More...

CatFileIterator	IterateCatEntryFrom (FileHandle &fh, RecordId rid)
	Creates an iterator that starts at `rid`. More...

bool	NextCatEntry (CatFileIterator &iter)
	Tries to move the iterator to the next row and returns whether such a row exists. More...

const char *	GetCurrentCatEntry (CatFileIterator &iter)
	Returns the current catalog entry pointed by the iterator as a buffer pointer. More...

RecordId	GetCurrentCatEntryRecordId (CatFileIterator &iter)
	Returns the current catalog entry's record ID. More...

void	UpdateCurrentCatEntry (CatFileIterator &iter, Record &rec)
	Updates the current catalog entry pointed by the iterator with the record `rec`. More...

void	EndIterateCatEntry (CatFileIterator &iter)
	Releses any resource associated with the catalog file iterator. More...

BulkLoadIterator *	GetBulkLoadIterator (FileHandle &fh, std::shared_ptr< const TableDesc > tabdesc, std::shared_ptr< const IndexDesc > idxdesc)
	Returns a BulkLoadIterator for bulk loading a systable index. More...

void	_CreateTableIfNullForFileHandle (FileHandle &fh, FieldOffset reclen)
	Creates the Table object in the file handle using a fake table descriptor. More...

Private Attributes
PageNumber	m_dbmetapg_pid
	The page number of the DB meta page, which is the first page of the DB meta file. More...

Friends
class	CatCacheBase< PersistentCatCache >

Additional Inherited Members
Protected Member Functions inherited from taco::CatCacheInternalAccess
template<class T >
std::vector< Datum >	GetDatumVector (const T &systable_struct)

Static Protected Member Functions inherited from taco::CatCacheInternalAccess
static std::shared_ptr< void >	CreateSysTableStruct (Oid tabid, const std::vector< Datum > &data)
	Creates a SysTable_xxx struct for a row stored in a record payout in the specified table. More...

template<class T >
static T *	CreateSysTableStruct (const std::vector< Datum > &data)
	Creates a SysTable_xxx struct from a vector of data by invoking its Create() function. More...

template<class T >
static T *	CopySysTableStruct (const T *s)

template<class T , class ... Args>
static T *	ConstructSysTableStruct (Args &&...args)
	Constructs a SysTable_xxx struct from c++ values by invoking its constructor. More...

Member Typedef Documentation

◆ CatFileIterator

typedef Table::Iterator taco::PersistentCatCache::CatFileIterator

private

An opaque handle for iterating a catalog file.

It must be automatically ended if it goes out of scope.

◆ PageHandle

typedef ScopedBufferId taco::PersistentCatCache::PageHandle

private

An opaque handle for a data page in an unformatted catalog file.

It must be automatically release if it goes out of scope.

Constructor & Destructor Documentation

◆ PersistentCatCache()

taco::PersistentCatCache::PersistentCatCache ( )

Member Function Documentation

◆ _CreateTableIfNullForFileHandle()

void taco::PersistentCatCache::_CreateTableIfNullForFileHandle	(	FileHandle &	fh,
		FieldOffset	reclen
	)

private

Creates the Table object in the file handle using a fake table descriptor.

reclen is only required when we are building with fixed-length data pages only.

◆ AppendRecord()

void taco::PersistentCatCache::AppendRecord	(	FileHandle &	fh,
		Record &	rec
	)

private

Appends a record to the catalog file specified by the file ID.

This also updates the ‘rec.GetRecordID()’ to the record ID of the newly inserted record.

◆ CloseCatalogFile()

void taco::PersistentCatCache::CloseCatalogFile ( FileHandle & fh )

private

Closes a catalog file pointed by the file handle.

◆ CreateCatalogFile()

FileId taco::PersistentCatCache::CreateCatalogFile ( bool format_heapfile )

private

Creates a new catalog file and returns its file ID.

If format_heapfile is true, the opened file will be accessed through the following record and iterator iterfaces. Otherwise, it is accessed as an unformatted file consisting of pages, which should initially have just one page.

The first file ever allocated through this function is assumed to have file ID 1.

◆ EndIterateCatEntry()

void taco::PersistentCatCache::EndIterateCatEntry ( CatFileIterator & iter )

private

Releses any resource associated with the catalog file iterator.

◆ GetBulkLoadIterator()

BulkLoadIterator * taco::PersistentCatCache::GetBulkLoadIterator	(	FileHandle &	fh,
		std::shared_ptr< const TableDesc >	tabdesc,
		std::shared_ptr< const IndexDesc >	idxdesc
	)

private

Returns a BulkLoadIterator for bulk loading a systable index.

◆ GetCurrentCatEntry()

const char * taco::PersistentCatCache::GetCurrentCatEntry ( CatFileIterator & iter )

private

Returns the current catalog entry pointed by the iterator as a buffer pointer.

It is undefined if a NextCatEntry has not been called or a previous call returns ‘false’.

◆ GetCurrentCatEntryRecordId()

RecordId taco::PersistentCatCache::GetCurrentCatEntryRecordId ( CatFileIterator & iter )

private

Returns the current catalog entry's record ID.

It is undefined if a NextCatEntry has not been called or a previous call returns ‘false’.

◆ GetFirstPage()

PersistentCatCache::PageHandle taco::PersistentCatCache::GetFirstPage	(	FileHandle &	fh,
		char **	pagebuf
	)

private

Returns a handle to the first page in the unformatted catalog file with it pinned in the memory.

The only valid value of the file handle is the file ID of the DB meta file, so we cache its first page number (NOTE which is assumed to never change with the current implementation of FileManager). This returns a ScopedBufferId as a page handle by pinning the first page in the buffer manager. If ‘GetFirstPage()’ is called with any other file ID, it throws a fatal error.

◆ IterateCatEntry()

PersistentCatCache::CatFileIterator taco::PersistentCatCache::IterateCatEntry ( FileHandle & fh )

private

Creates an iterator over the catalog file specified by the file ID.

◆ IterateCatEntryFrom()

PersistentCatCache::CatFileIterator taco::PersistentCatCache::IterateCatEntryFrom	(	FileHandle &	fh,
		RecordId	rid
	)

private

Creates an iterator that starts at rid.

The iterator may or may not return additional records after the first one if rid exists.

◆ MarkPageDirty()

void taco::PersistentCatCache::MarkPageDirty ( PageHandle & pghandle )

private

Marks a page pointed by the page handle as dirty.

◆ NextCatEntry()

bool taco::PersistentCatCache::NextCatEntry ( CatFileIterator & iter )

private

Tries to move the iterator to the next row and returns whether such a row exists.

◆ OpenCatalogFile()

PersistentCatCache::FileHandle taco::PersistentCatCache::OpenCatalogFile	(	FileId	fid,
		const TableDesc *	tabdesc
	)

private

Opens a catalog file for access.

The second argument tabdesc is always needed except for variable-length build during initialization and the db meta page.

◆ ReleasePage()

void taco::PersistentCatCache::ReleasePage ( PageHandle & pghandle )

private

Releases the pin over the page pointed by the page handle.

◆ UpdateCurrentCatEntry()

void taco::PersistentCatCache::UpdateCurrentCatEntry	(	CatFileIterator &	iter,
		Record &	rec
	)

private

Updates the current catalog entry pointed by the iterator with the record rec.

This invalidates the current position of the iterator so it is undefined to call either ‘GetCurrentCatEntry’ or ‘UpdateCurrentCatEntry’ after this call. However, one may still call ‘NextCatEntry’ on it to resume the iteration. There is no guarantee that the same entry will not be returned again though.

This is intended to be used for updating either a single entry (and then ending the iteration), or for performing initialization in the catalog initializer.

Friends And Related Function Documentation

◆ CatCacheBase< PersistentCatCache >

friend class CatCacheBase< PersistentCatCache >

friend

Member Data Documentation

◆ m_dbmetapg_pid

PageNumber taco::PersistentCatCache::m_dbmetapg_pid

private

The page number of the DB meta page, which is the first page of the DB meta file.

The documentation for this class was generated from the following files:

catalog/PersistentCatCache.h
catalog/PersistentCatCache.cpp

Classes

Public Member Functions

Private Types

Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Member Typedef Documentation

◆ CatFileIterator

◆ PageHandle

Constructor & Destructor Documentation

◆ PersistentCatCache()

Member Function Documentation

◆ _CreateTableIfNullForFileHandle()

◆ AppendRecord()

◆ CloseCatalogFile()

◆ CreateCatalogFile()

◆ EndIterateCatEntry()

◆ GetBulkLoadIterator()

◆ GetCurrentCatEntry()

◆ GetCurrentCatEntryRecordId()

◆ GetFirstPage()

◆ IterateCatEntry()

◆ IterateCatEntryFrom()

◆ MarkPageDirty()

◆ NextCatEntry()

◆ OpenCatalogFile()

◆ ReleasePage()

◆ UpdateCurrentCatEntry()

Friends And Related Function Documentation

◆ CatCacheBase< PersistentCatCache >

Member Data Documentation

◆ m_dbmetapg_pid