Persistent caching Rust key-value storage

Features

• Multithreaded TCP server
• Sharding
• gRPC connection between shards and manager
• Persistency
• Caching least recently used values with memcached
• Transactions support

Building

1. Configure the environmental variables in config.toml.
2. Use cargo build to build the executables.
3. Run ./target/debug/shard --help to check and set the list of available options.
4. Run ./target/debug/manager --help to check and set the list of available options.
5. Run as many shards as you need and the manager.

Demo

2024-01-21-16-44-57.mp4

API

GET:

get <key>

Gets the value by key.

Returns value if key exists, None else.

Possible errors: memcached connection/storage errors, input-output error.

SET:

set <key> <value>

Sets the value by the key.

Returns OK if value has been set, describes an Error else.

Possible errors: memcached connection/storage errors, input-output error.

DELETE:

del <key>

Deletes the key and its' value if exists.

Returns OK if value has been set, describes an Error else.

Possible errors: memcached connection/storage errors, input-output error.

INCREMENT:

incr <key> <value>

Adds value to the entry with the given key.

Returns OK if value has been updated, describes an Error else.

Possible errors: memcached connection/storage errors, input-output error.

DECREMENT:

decr <key> <value>

Subtracts value from the entry with the given key.

Returns OK if value has been updated, describes an Error else.

Possible errors: memcached connection/storage errors, input-output error.

CLEAR:

clear

Clears the storage and flushes the cache.

Returns OK if value has been updated, describes an Error else.

Possible errors: memcached connection/storage errors, input-output error.

TRANSACTIONS:

transact:
<op_1>
<op_2>
...
<op_n>

Transacts all the operations. If any error occures, flushes the cache and rolls back to previous commit.

Returns each operations' response one by one.

Possible errors: memcached connection/storage errors, input-output error.

ROLLBACK:

rollback <key> <commit>

Lets you see the value with key at n'th commit starting with 0 from the current. This being said that commits are enumerated starting from the last one.

Returns value.

Possible errors: memcached connection/storage errors, input-output error.