Class RocksDBKeyValueStore

The RocksDB IKeyValueStore implementation. This stores data in the RocksDB.

RocksDBStore and RocksDBKeyValueStore-backed can be instantiated from a URI with rocksdb+file: scheme using , e.g.:

rocksdb+file:///var/data/planet/
rocksdb+file:///c:/Users/john/AppData/Local/planet/

The following query string parameters are supported:

`block-cache`	Corresponds to 's `blockCacheSize` parameter. 512 by default.
`tx-cache`	Corresponds to 's `txCacheSize` parameter. 1024 by default.
`max-total-wal-size`	Corresponds to RocksDB's `max_total_wal_size` option.
`keep-log-file-num`	Corresponds to RocksDB's `keep_log_file_num` option.
`max_log_file_size`	Corresponds to RocksDB's `max_log_file_size` option.
`tx-epoch-unit-secs`	Corresponds to 's `txEpochUnitSeconds` parameter. 86400 by default.
`block-epoch-unit-secs`	Corresponds to 's `blockEpochUnitSeconds` parameter. 86400 by default.
`connection-cache`	Corresponds to 's `dbConnectionCacheSize` parameter. 100 by default.
`states-dir`	Corresponds to 's `path` parameter. It is relative to the URI path, and defaults to `states`.

Inheritance

System.Object

RocksDBKeyValueStore

Implements

IKeyValueStore

IDisposable

Namespace: Libplanet.RocksDBStore

Assembly: Libplanet.RocksDBStore.dll

Syntax

public class RocksDBKeyValueStore : object, IKeyValueStore

Constructors

| Improve this Doc View Source

RocksDBKeyValueStore(String, RocksDBInstanceType, Nullable<DbOptions>)

Creates a new RocksDBKeyValueStore.

Declaration

public RocksDBKeyValueStore(string path, RocksDBInstanceType type = RocksDBInstanceType.Primary, DbOptions? options = null)

Parameters

Type	Name	Description
System.String	path	The path of the storage file will be saved.
RocksDBInstanceType	type	Determines the instance type of the internal instances. Primary by default.
System.Nullable<DbOptions>	options	The for .

Properties

| Improve this Doc View Source

Type

The RocksDB IKeyValueStore implementation. This stores data in the RocksDB.

RocksDBStore and RocksDBKeyValueStore-backed can be instantiated from a URI with rocksdb+file: scheme using , e.g.:

rocksdb+file:///var/data/planet/
rocksdb+file:///c:/Users/john/AppData/Local/planet/

The following query string parameters are supported:

`block-cache`	Corresponds to 's `blockCacheSize` parameter. 512 by default.
`tx-cache`	Corresponds to 's `txCacheSize` parameter. 1024 by default.
`max-total-wal-size`	Corresponds to RocksDB's `max_total_wal_size` option.
`keep-log-file-num`	Corresponds to RocksDB's `keep_log_file_num` option.
`max_log_file_size`	Corresponds to RocksDB's `max_log_file_size` option.
`tx-epoch-unit-secs`	Corresponds to 's `txEpochUnitSeconds` parameter. 86400 by default.
`block-epoch-unit-secs`	Corresponds to 's `blockEpochUnitSeconds` parameter. 86400 by default.
`connection-cache`	Corresponds to 's `dbConnectionCacheSize` parameter. 100 by default.
`states-dir`	Corresponds to 's `path` parameter. It is relative to the URI path, and defaults to `states`.

Declaration

public RocksDBInstanceType Type { get; }

Property Value

Type	Description
RocksDBInstanceType

Methods

| Improve this Doc View Source

Delete(IEnumerable<KeyBytes>)

The RocksDB IKeyValueStore implementation. This stores data in the RocksDB.

RocksDBStore and RocksDBKeyValueStore-backed can be instantiated from a URI with rocksdb+file: scheme using , e.g.:

rocksdb+file:///var/data/planet/
rocksdb+file:///c:/Users/john/AppData/Local/planet/

The following query string parameters are supported:

`block-cache`	Corresponds to 's `blockCacheSize` parameter. 512 by default.
`tx-cache`	Corresponds to 's `txCacheSize` parameter. 1024 by default.
`max-total-wal-size`	Corresponds to RocksDB's `max_total_wal_size` option.
`keep-log-file-num`	Corresponds to RocksDB's `keep_log_file_num` option.
`max_log_file_size`	Corresponds to RocksDB's `max_log_file_size` option.
`tx-epoch-unit-secs`	Corresponds to 's `txEpochUnitSeconds` parameter. 86400 by default.
`block-epoch-unit-secs`	Corresponds to 's `blockEpochUnitSeconds` parameter. 86400 by default.
`connection-cache`	Corresponds to 's `dbConnectionCacheSize` parameter. 100 by default.
`states-dir`	Corresponds to 's `path` parameter. It is relative to the URI path, and defaults to `states`.

Declaration

public void Delete(IEnumerable<KeyBytes> keys)

Parameters

Type	Name	Description
IEnumerable<KeyBytes>	keys

| Improve this Doc View Source

Delete(in KeyBytes)

Deletes the given key. If the key does not exist, nothing happens.

Declaration

public void Delete(in KeyBytes key)

Parameters

Type	Name	Description
KeyBytes	key	A key to delete.

| Improve this Doc View Source

Dispose()

The RocksDB IKeyValueStore implementation. This stores data in the RocksDB.

RocksDBStore and RocksDBKeyValueStore-backed can be instantiated from a URI with rocksdb+file: scheme using , e.g.:

rocksdb+file:///var/data/planet/
rocksdb+file:///c:/Users/john/AppData/Local/planet/

The following query string parameters are supported:

`block-cache`	Corresponds to 's `blockCacheSize` parameter. 512 by default.
`tx-cache`	Corresponds to 's `txCacheSize` parameter. 1024 by default.
`max-total-wal-size`	Corresponds to RocksDB's `max_total_wal_size` option.
`keep-log-file-num`	Corresponds to RocksDB's `keep_log_file_num` option.
`max_log_file_size`	Corresponds to RocksDB's `max_log_file_size` option.
`tx-epoch-unit-secs`	Corresponds to 's `txEpochUnitSeconds` parameter. 86400 by default.
`block-epoch-unit-secs`	Corresponds to 's `blockEpochUnitSeconds` parameter. 86400 by default.
`connection-cache`	Corresponds to 's `dbConnectionCacheSize` parameter. 100 by default.
`states-dir`	Corresponds to 's `path` parameter. It is relative to the URI path, and defaults to `states`.

Declaration

public void Dispose()

| Improve this Doc View Source

Exists(in KeyBytes)

Checks whether the given key exists in the store.

Declaration

public bool Exists(in KeyBytes key)

Parameters

Type	Name	Description
KeyBytes	key	A key to check.

Returns

Type	Description
System.Boolean	true if the key exists; otherwise, false.

| Improve this Doc View Source

Get(in KeyBytes)

Gets the value associated with the specified key.

Declaration

public byte[] Get(in KeyBytes key)

Parameters

Type	Name	Description
KeyBytes	key	The key whose value to get.

Returns

Type	Description
System.Byte[]	The value associated with the specified key.

| Improve this Doc View Source

ListKeys()

The RocksDB IKeyValueStore implementation. This stores data in the RocksDB.

RocksDBStore and RocksDBKeyValueStore-backed can be instantiated from a URI with rocksdb+file: scheme using , e.g.:

rocksdb+file:///var/data/planet/
rocksdb+file:///c:/Users/john/AppData/Local/planet/

The following query string parameters are supported:

`block-cache`	Corresponds to 's `blockCacheSize` parameter. 512 by default.
`tx-cache`	Corresponds to 's `txCacheSize` parameter. 1024 by default.
`max-total-wal-size`	Corresponds to RocksDB's `max_total_wal_size` option.
`keep-log-file-num`	Corresponds to RocksDB's `keep_log_file_num` option.
`max_log_file_size`	Corresponds to RocksDB's `max_log_file_size` option.
`tx-epoch-unit-secs`	Corresponds to 's `txEpochUnitSeconds` parameter. 86400 by default.
`block-epoch-unit-secs`	Corresponds to 's `blockEpochUnitSeconds` parameter. 86400 by default.
`connection-cache`	Corresponds to 's `dbConnectionCacheSize` parameter. 100 by default.
`states-dir`	Corresponds to 's `path` parameter. It is relative to the URI path, and defaults to `states`.

Declaration

public IEnumerable<KeyBytes> ListKeys()

Returns

Type	Description
IEnumerable<KeyBytes>

| Improve this Doc View Source

Set(IDictionary<KeyBytes, Byte[]>)

The RocksDB IKeyValueStore implementation. This stores data in the RocksDB.

RocksDBStore and RocksDBKeyValueStore-backed can be instantiated from a URI with rocksdb+file: scheme using , e.g.:

rocksdb+file:///var/data/planet/
rocksdb+file:///c:/Users/john/AppData/Local/planet/

The following query string parameters are supported:

`block-cache`	Corresponds to 's `blockCacheSize` parameter. 512 by default.
`tx-cache`	Corresponds to 's `txCacheSize` parameter. 1024 by default.
`max-total-wal-size`	Corresponds to RocksDB's `max_total_wal_size` option.
`keep-log-file-num`	Corresponds to RocksDB's `keep_log_file_num` option.
`max_log_file_size`	Corresponds to RocksDB's `max_log_file_size` option.
`tx-epoch-unit-secs`	Corresponds to 's `txEpochUnitSeconds` parameter. 86400 by default.
`block-epoch-unit-secs`	Corresponds to 's `blockEpochUnitSeconds` parameter. 86400 by default.
`connection-cache`	Corresponds to 's `dbConnectionCacheSize` parameter. 100 by default.
`states-dir`	Corresponds to 's `path` parameter. It is relative to the URI path, and defaults to `states`.

Declaration

public void Set(IDictionary<KeyBytes, byte[]> values)

Parameters

Type	Name	Description
IDictionary<KeyBytes, System.Byte[]>	values

| Improve this Doc View Source

Set(in KeyBytes, Byte[])

Sets the value to the key. If the key already exists, the value is overwritten.

Declaration

public void Set(in KeyBytes key, byte[] value)

Parameters

Type	Name	Description
KeyBytes	key	The key of the value to set.
System.Byte[]	value	The value to set.

| Improve this Doc View Source

TryCatchUpWithPrimary()

The RocksDB IKeyValueStore implementation. This stores data in the RocksDB.

RocksDBStore and RocksDBKeyValueStore-backed can be instantiated from a URI with rocksdb+file: scheme using , e.g.:

rocksdb+file:///var/data/planet/
rocksdb+file:///c:/Users/john/AppData/Local/planet/

The following query string parameters are supported:

`block-cache`	Corresponds to 's `blockCacheSize` parameter. 512 by default.
`tx-cache`	Corresponds to 's `txCacheSize` parameter. 1024 by default.
`max-total-wal-size`	Corresponds to RocksDB's `max_total_wal_size` option.
`keep-log-file-num`	Corresponds to RocksDB's `keep_log_file_num` option.
`max_log_file_size`	Corresponds to RocksDB's `max_log_file_size` option.
`tx-epoch-unit-secs`	Corresponds to 's `txEpochUnitSeconds` parameter. 86400 by default.
`block-epoch-unit-secs`	Corresponds to 's `blockEpochUnitSeconds` parameter. 86400 by default.
`connection-cache`	Corresponds to 's `dbConnectionCacheSize` parameter. 100 by default.
`states-dir`	Corresponds to 's `path` parameter. It is relative to the URI path, and defaults to `states`.

Declaration

public void TryCatchUpWithPrimary()

Implements

IKeyValueStore

IDisposable