logdb

package
v0.0.0-...-74d231c Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 29, 2024 License: Apache-2.0 Imports: 20 Imported by: 0

Documentation

Overview

Package logdb implements the persistent log storage used by Dragonboat.

This package is internally used by Dragonboat, applications are not expected to import this package.

Index

Constants

View Source
const (
	// DefaultKVStoreTypeName is the type name of the default kv store
	DefaultKVStoreTypeName = "pebble"
)

Variables

This section is empty.

Functions

func NewDefaultBatchedLogDB

func NewDefaultBatchedLogDB(config config.NodeHostConfig,
	callback config.LogDBCallback,
	dirs []string, lldirs []string) (raftio.ILogDB, error)

NewDefaultBatchedLogDB creates a Log DB instance using the default KV store implementation with batched entry support.

func NewDefaultLogDB

func NewDefaultLogDB(config config.NodeHostConfig,
	callback config.LogDBCallback,
	dirs []string, lldirs []string) (raftio.ILogDB, error)

NewDefaultLogDB creates a Log DB instance using the default KV store implementation. The created Log DB tries to store entry records in plain format but it switches to the batched mode if there is already batched entries saved in the existing DB.

func NewLogDB

func NewLogDB(config config.NodeHostConfig,
	callback config.LogDBCallback, dirs []string, lldirs []string,
	batched bool, check bool, f kv.Factory) (raftio.ILogDB, error)

NewLogDB creates a Log DB instance based on provided configuration parameters. The underlying KV store used by the Log DB instance is created by the provided factory function.

Types

type DefaultFactory

type DefaultFactory struct {
}

DefaultFactory is the default factory for creating LogDB instance.

func NewDefaultFactory

func NewDefaultFactory() *DefaultFactory

NewDefaultFactory creates a new DefaultFactory instance.

func (*DefaultFactory) Create

func (f *DefaultFactory) Create(cfg config.NodeHostConfig,
	cb config.LogDBCallback,
	dirs []string, lldirs []string) (raftio.ILogDB, error)

Create creates the LogDB instance.

func (*DefaultFactory) Name

func (f *DefaultFactory) Name() string

Name returns the name of the default LogDB instance.

type IContext

type IContext interface {
	// Destroy destroys the IContext instance.
	Destroy()
	// Reset resets the IContext instance, all previous returned keys and
	// buffers will be put back to the IContext instance and be ready to
	// be used for the next iteration.
	Reset()
	// GetKey returns a reusable key.
	GetKey() IReusableKey
	// GetValueBuffer returns a byte buffer with at least sz bytes in length.
	GetValueBuffer(sz uint64) []byte
	// GetWriteBatch returns a write batch or transaction instance.
	GetWriteBatch() interface{}
	// SetWriteBatch adds the write batch to the IContext instance.
	SetWriteBatch(wb interface{})
	// GetEntryBatch returns an entry batch instance.
	GetEntryBatch() pb.EntryBatch
	// GetLastEntryBatch returns an entry batch instance.
	GetLastEntryBatch() pb.EntryBatch
}

IContext is the per thread context used in the logdb module. IContext is expected to contain a list of reusable keys and byte slices that are owned per thread so they can be safely reused by the same thread when accessing ILogDB.

type IReusableKey

type IReusableKey interface {
	SetEntryBatchKey(shardID uint64, replicaID uint64, index uint64)
	// SetEntryKey sets the key to be an entry key for the specified Raft node
	// with the specified entry index.
	SetEntryKey(shardID uint64, replicaID uint64, index uint64)
	// SetStateKey sets the key to be an persistent state key suitable
	// for the specified Raft shard node.
	SetStateKey(shardID uint64, replicaID uint64)
	// SetMaxIndexKey sets the key to be the max possible index key for the
	// specified Raft shard node.
	SetMaxIndexKey(shardID uint64, replicaID uint64)
	// Key returns the underlying byte slice of the key.
	Key() []byte
	// Release releases the key instance so it can be reused in the future.
	Release()
}

IReusableKey is the interface for keys that can be reused. A reusable key is usually obtained by calling the GetKey() function of the IContext instance.

type Key

type Key struct {
	// contains filtered or unexported fields
}

Key represents keys that are managed by a sync.Pool to be reused.

func NewKey

func NewKey(sz uint64, pool *sync.Pool) *Key

NewKey creates and returns a new Key instance.

func (*Key) Key

func (k *Key) Key() []byte

Key returns the []byte of the key.

func (*Key) Release

func (k *Key) Release()

Release puts the key back to the pool.

func (*Key) SetEntryBatchKey

func (k *Key) SetEntryBatchKey(shardID uint64,
	replicaID uint64, batchID uint64)

SetEntryBatchKey sets the key value opf the entry batch.

func (*Key) SetEntryKey

func (k *Key) SetEntryKey(shardID uint64, replicaID uint64, index uint64)

SetEntryKey sets the key value to the specified entry key.

func (*Key) SetMaxIndexKey

func (k *Key) SetMaxIndexKey(shardID uint64, replicaID uint64)

SetMaxIndexKey sets the key value to the max index record key.

func (*Key) SetMaximumKey

func (k *Key) SetMaximumKey()

SetMaximumKey sets the key to the maximum possible value.

func (*Key) SetMinimumKey

func (k *Key) SetMinimumKey()

SetMinimumKey sets the key to the minimum possible value.

func (*Key) SetStateKey

func (k *Key) SetStateKey(shardID uint64, replicaID uint64)

SetStateKey sets the key value to the specified State.

type LogReader

type LogReader struct {
	sync.Mutex
	// contains filtered or unexported fields
}

LogReader is the struct used to manage logs that have already been persisted into LogDB. This implementation is influenced by CockroachDB's replicaRaftStorage.

func NewLogReader

func NewLogReader(shardID uint64,
	replicaID uint64, logdb raftio.ILogDB) *LogReader

NewLogReader creates and returns a new LogReader instance.

func (*LogReader) Append

func (lr *LogReader) Append(entries []pb.Entry) error

Append marks the specified entries as persisted and make them available from logreader.

func (*LogReader) ApplySnapshot

func (lr *LogReader) ApplySnapshot(snapshot pb.Snapshot) error

ApplySnapshot applies the specified snapshot.

func (*LogReader) Compact

func (lr *LogReader) Compact(index uint64) error

Compact compacts raft log entries up to index.

func (*LogReader) CreateSnapshot

func (lr *LogReader) CreateSnapshot(snapshot pb.Snapshot) error

CreateSnapshot keeps the metadata of the specified snapshot.

func (*LogReader) Entries

func (lr *LogReader) Entries(low uint64,
	high uint64, maxSize uint64) ([]pb.Entry, error)

Entries returns persisted entries between [low, high) with a total limit of up to maxSize bytes.

func (*LogReader) GetRange

func (lr *LogReader) GetRange() (uint64, uint64)

GetRange returns the index range of all logs managed by the LogReader instance.

func (*LogReader) NodeState

func (lr *LogReader) NodeState() (pb.State, pb.Membership)

NodeState returns the initial state.

func (*LogReader) SetCompactor

func (lr *LogReader) SetCompactor(c pb.ICompactor)

SetCompactor sets the compactor or the LogReader instance.

func (*LogReader) SetRange

func (lr *LogReader) SetRange(firstIndex uint64, length uint64)

SetRange updates the LogReader to reflect what is available in it.

func (*LogReader) SetState

func (lr *LogReader) SetState(s pb.State)

SetState sets the persistent state.

func (*LogReader) Snapshot

func (lr *LogReader) Snapshot() pb.Snapshot

Snapshot returns the metadata of the lastest snapshot.

func (*LogReader) Term

func (lr *LogReader) Term(index uint64) (uint64, error)

Term returns the term of the entry specified by the entry index.

type ShardedDB

type ShardedDB struct {
	// contains filtered or unexported fields
}

ShardedDB is a LogDB implementation using sharded ILogDB instances.

func OpenShardedDB

func OpenShardedDB(config config.NodeHostConfig, cb config.LogDBCallback,
	dirs []string, lldirs []string, batched bool, check bool,
	kvf kv.Factory) (*ShardedDB, error)

OpenShardedDB creates a ShardedDB instance.

func (*ShardedDB) BinaryFormat

func (s *ShardedDB) BinaryFormat() uint32

BinaryFormat is the binary format supported by the sharded DB.

func (*ShardedDB) Close

func (s *ShardedDB) Close() (err error)

Close closes the ShardedDB instance.

func (*ShardedDB) CompactEntriesTo

func (s *ShardedDB) CompactEntriesTo(shardID uint64,
	replicaID uint64, index uint64) (<-chan struct{}, error)

CompactEntriesTo reclaims underlying storage space used for storing entries up to the specified index.

func (*ShardedDB) GetBootstrapInfo

func (s *ShardedDB) GetBootstrapInfo(shardID uint64,
	replicaID uint64) (pb.Bootstrap, error)

GetBootstrapInfo returns the saved bootstrap info for the given node.

func (*ShardedDB) GetLogDBThreadContext

func (s *ShardedDB) GetLogDBThreadContext() IContext

GetLogDBThreadContext return an IContext instance. This method is expected to be used in benchmarks and tests only.

func (*ShardedDB) GetSnapshot

func (s *ShardedDB) GetSnapshot(shardID uint64,
	replicaID uint64) (pb.Snapshot, error)

GetSnapshot returns the most recent snapshot associated with the specified shard.

func (*ShardedDB) ImportSnapshot

func (s *ShardedDB) ImportSnapshot(ss pb.Snapshot, replicaID uint64) error

ImportSnapshot imports the snapshot record and other metadata records to the system.

func (*ShardedDB) IterateEntries

func (s *ShardedDB) IterateEntries(ents []pb.Entry,
	size uint64, shardID uint64, replicaID uint64, low uint64, high uint64,
	maxSize uint64) ([]pb.Entry, uint64, error)

IterateEntries returns a list of saved entries starting with index low up to index high with a max size of maxSize.

func (*ShardedDB) ListNodeInfo

func (s *ShardedDB) ListNodeInfo() ([]raftio.NodeInfo, error)

ListNodeInfo lists all available NodeInfo found in the log db.

func (*ShardedDB) Name

func (s *ShardedDB) Name() string

Name returns the type name of the instance.

func (*ShardedDB) ReadRaftState

func (s *ShardedDB) ReadRaftState(shardID uint64,
	replicaID uint64, lastIndex uint64) (raftio.RaftState, error)

ReadRaftState returns the persistent state of the specified raft node.

func (*ShardedDB) RemoveEntriesTo

func (s *ShardedDB) RemoveEntriesTo(shardID uint64,
	replicaID uint64, index uint64) error

RemoveEntriesTo removes entries associated with the specified raft node up to the specified index.

func (*ShardedDB) RemoveNodeData

func (s *ShardedDB) RemoveNodeData(shardID uint64, replicaID uint64) error

RemoveNodeData deletes all node data that belongs to the specified node.

func (*ShardedDB) SaveBootstrapInfo

func (s *ShardedDB) SaveBootstrapInfo(shardID uint64,
	replicaID uint64, bootstrap pb.Bootstrap) error

SaveBootstrapInfo saves the specified bootstrap info for the given node.

func (*ShardedDB) SaveRaftState

func (s *ShardedDB) SaveRaftState(updates []pb.Update, shardID uint64) error

SaveRaftState saves the raft state and logs found in the raft.Update list to the log db.

func (*ShardedDB) SaveRaftStateCtx

func (s *ShardedDB) SaveRaftStateCtx(updates []pb.Update, ctx IContext) error

SaveRaftStateCtx saves the raft state and logs found in the raft.Update list to the log db.

func (*ShardedDB) SaveSnapshots

func (s *ShardedDB) SaveSnapshots(updates []pb.Update) error

SaveSnapshots saves all snapshot metadata found in the raft.Update list.

func (*ShardedDB) SelfCheckFailed

func (s *ShardedDB) SelfCheckFailed() (bool, error)

SelfCheckFailed runs a self check on all db shards and report whether any failure is observed.

Directories

Path Synopsis
kv

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL