apache/kvrocks được TopGit xếp vào nhóm dự án dữ liệu, với 4.5k sao trên GitHub, viết chủ yếu bằng C++. Apache Kvrocks is a distributed key value NoSQL database that uses RocksDB as storage engine and is compatible with Redis protocol.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Apache Kvrocks is a distributed key value NoSQL database that uses RocksDB as storage engine and is compatible with Redis protocol. Kvrocks intends to decrease the cost of memory and increase the capacity while compared to Redis. The design of replication and storage was inspired by rocksplicator and blackwidow.
Kvrocks has the following key features:
Redis Compatible: Users can access Apache Kvrocks via any Redis client.
Namespace: Similar to Redis SELECT but equipped with token per namespace.
Replication: Async replication using binlog like MySQL.
High Availability: Support Redis sentinel to failover when master or slave was failed.
Cluster: Centralized management but accessible via any Redis cluster client.
Who uses Kvrocks
You can find Kvrocks users at the Users page.
Users are encouraged to add themselves to the Users page. Either leave a comment on the "Who is using Kvrocks" issue, or directly send a pull request to add company or organization information and logo.
Build and run Kvrocks
Prerequisite
# Ubuntu / Debian
sudo apt update
sudo apt install -y git build-essential cmake libtool python3 libssl-dev
# CentOS / RedHat
sudo yum install -y centos-release-scl-rh
sudo yum install -y git devtoolset-11 autoconf automake libtool libstdc++-static python3 openssl-devel
# download and install cmake via https://cmake.org/download
wget https://github.com/Kitware/CMake/releases/download/v3.26.4/cmake-3.26.4-linux-x86_64.sh -O cmake.sh
sudo bash cmake.sh --skip-license --prefix=/usr
# enable gcc and make in devtoolset-11
source /opt/rh/devtoolset-11/enable
# openSUSE / SUSE Linux Enterprise
sudo zypper install -y gcc11 gcc11-c++ make wget git autoconf automake python3 curl cmake
# Arch Linux
sudo pacman -Sy --noconfirm autoconf automake python3 git wget which cmake make gcc
# macOS
brew install git cmake autoconf automake libtool openssl
# please link openssl by force if it still cannot be found after installing
brew link --force openssl
Build
It is as simple as:
$ git clone https://github.com/apache/kvrocks.git
$ cd kvrocks
$ ./x.py build # `./x.py build -h` to check more options
To build with TLS support, you'll need OpenSSL development libraries (e.g. libssl-dev on Debian/Ubuntu) and run:
$ ./x.py build -DENABLE_OPENSSL=ON
To build with lua instead of luaJIT, run:
$ ./x.py build -DENABLE_LUAJIT=OFF
Build with debug mode, run:
# The default build type is RelWithDebInfo and its optimization level is typically -O2.
# You can change it to -O0 in debug mode.
$ ./x.py build -DCMAKE_BUILD_TYPE=Debug
Running Kvrocks
$ ./build/kvrocks -c kvrocks.conf
Running Kvrocks using Docker
$ docker run -it -p 6666:6666 apache/kvrocks --bind 0.0.0.0
# or get the nightly image:
$ docker run -it -p 6666:6666 apache/kvrocks:nightly
Please visit Apache Kvrocks on DockerHub for additional details about images.
Connect Kvrocks service
$ redis-cli -p 6666
127.0.0.1:6666> get a
(nil)
Running test cases
$ ./x.py build --unittest
$ ./x.py test cpp # run C++ unit tests
$ ./x.py test go # run Golang (unit and integration) test cases
Supported platforms
OS: Linux and macOS
arch: x86_64, ARM and RISC-V
Namespace
Namespace is used to isolate data between users. Unlike all the Redis databases can be visited by requirepass, we use one token per namespace. requirepass is regarded as admin token, and only admin token allows to access the namespace command, as well as some commands like config, slaveof, bgsave, etc. See the Namespace page for more details.
# add token
127.0.0.1:6666> namespace add ns1 my_token
OK
# update token
127.0.0.1:6666> namespace set ns1 new_token
OK
# list namespace
127.0.0.1:6666> namespace get *
1) "ns1"
2) "new_token"
3) "__namespace"
4) "foobared"
# delete namespace
127.0.0.1:6666> namespace del ns1
OK
Cluster
Kvrocks implements a proxyless centralized cluster solution but its accessing method is completely compatible with Redis cluster clients. You can use Redis cluster SDKs to access the kvrocks cluster. For more details, please refer to Kvrocks Cluster Introduction.
Documents
Documents are hosted at the official website.
Supported Commands
Design Complex Structure on RocksDB
Replication Design
Tools
To manage Kvrocks clusters for failover, scaling up/down and more, use kvrocks-controller
To export the Kvrocks monitor metrics, use kvrocks_exporter
To migrate from Redis to Kvrocks, use RedisShake
To migrate from Kvrocks to Redis, use kvrocks2redis built via ./x.py build
Contributing
Kvrocks community welcomes all forms of contribution and you can find out how to get involved on the Community and How to Contribute pages.
License
Apache Kvrocks is licensed under the Apache License Version 2.0. See LICENSE and NOTICE for details.
Social Media
Medium
X (Twitter)
Zhihu (in Chinese)
WeChat Official Account (in Chinese, scan the QR code to follow)
apache/kvrocks có 4.5k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/apache/kvrocks. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
apache/kvrocks có phải mã nguồn mở không?
Có — apache/kvrocks phát hành theo license Apache-2.0, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/apache/kvrocks.
apache/kvrocks có trang demo không?
Dự án có trang chủ ở https://kvrocks.apache.org/. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
apache/kvrocks là gì?
apache/kvrocks (apache/kvrocks) là dự án C++ trên GitHub. Theo mô tả gốc: Apache Kvrocks is a distributed key value NoSQL database that uses RocksDB as storage engine and is compatible with Redis protocol.
apache/kvrocks so với các dự án Data khác thế nào?
apache/kvrocks được TopGit xếp vào nhóm Data, với 4.5k sao GitHub và viết bằng C++. Xem trang chủ đề Data trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
Cùng nhóm Data còn repo nào?
apache/kvrocks thuộc nhóm Data trên TopGit, cùng 6 topic GitHub. Trang Trending và Topics liệt kê các repo cùng số sao và cùng ngôn ngữ để so sánh.
Đọc thêm về apache/kvrocks ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/apache/kvrocks là nguồn chính thức.
Đọc đầy đủ README ở tab phía trên.
kvrocks có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về kvrocks.