{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/437", "result": {"data":{"issuesJson":{"id":"161f26e8-ef75-55b1-80ff-9f7824ad4f35","title":"OpenAtomFoundation/pika: Pika 是一个以 RocksDB 为存储引擎的的大容量、高性能、多租户、数据可持久化的弹性 KV 数据存储系统，完全兼容 Redis 协议，支持其常用的数据结构。","number":437,"bodyHTML":"

\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Repos	OpenAtomFoundation/pika
Views	$\"views\"$
Stars	$\"stars\"$
Forks	$\"forks\"$
License	$\"license\"$
UpdatedAt	$\"last-commit\"$
CreatedAt	$\"create-at\"$

\n\n

\n

\n

\n

\n

$\"Build$ $\"Downloads\"$

\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Stargazers Over Time	Contributors Over Time
$\"Stargazers$	$\"Contributor$

\n

Introduction中文

\n

PikiwiDB is a high-performance, large-capacity, multi-tenant, data-persistent elastic KV data storage system using RocksDB as the storage engine. It is fully compatible with the Redis protocol and supports its commonly used data structures, such as string/hash/list/zset/set/geo/hyperloglog/pubsub/bitmap/stream, etc. Redis Interface.

\n

When Redis's in-memory usage exceeds 16GiB, it faces problems such as limited memory capacity, single-threaded blocking, long startup recovery time, high memory hardware costs, easily filled buffers, and high switching costs when one master and multiple replicas fail. The emergence of PikiwiDB is not to replace Redis but to complement it. PikiwiDB strives to completely comply with the Redis protocol, inherit Redis's convenient operation and maintenance design, and solve the bottleneck problem of Redis running out of memory capacity once the data volume becomes huge by using persistent storage. Additionally, PikiwiDB can support master-slave mode using the slaveof command, and it also supports full and incremental data synchronization.

\n

PikiwiDB can be deployed in a single-machine master-slave mode (slaveof) or in a Codis cluster mode, allowing for simple scaling and shrinking. Migration from Redis to PikiwiDB can be smoothly executed by tools.

\n

PikiwiDB Features

\n

Protocol Compatibility: Fully compatible with the Redis protocol, emphasizing high performance, large capacity, low cost, and scalability.
Data Structures: Supports Redis's common data structures, including String, Hash, List, Zset, Set, Geo, Hyperloglog, Pubsub, Bitmap, Stream, ACL, etc.
Cold and Hot Data: Caches hot data and persistently stores the full data in RocksDB, implementing a hierarchical storage of cold and hot data.
High Capacity: Compared to Redis's in-memory storage, PikiwiDB supports data volumes in the hundreds of gigabytes, significantly reducing server resource consumption and enhancing data reliability.
Deployment Modes: Supports single-machine master-slave mode (slaveof) and Codis cluster mode, making scaling and shrinking simple.
Easy Migration: Smooth migration from Redis to PikiwiDB without modifying code.
Convenient Operation and Maintenance: Comprehensive operation and maintenance command documentation.

\n

PikiwiDB Storage Engine Architecture

\n

Supports multiple platforms: CentOS, Ubuntu, macOS, Rocky Linux
Multi-threaded model
Based on the RocksDB storage engine
Multiple granularity data caching model

\n

Deployment Modes

\n

1. Master-Slave Mode

\n

Architecture similar to Redis
Good compatibility with Redis protocol and data structures
Each data structure uses a separate RocksDB instance
Master-slave adopts binlog asynchronous replication

\n

$\"PikiwiDB-Master-Slave\"$

\n

2. Distributed Cluster Mode

\n

Adopts Codis architecture, supports multiple groups
Each group forms a master-slave set
Elastic scaling based on groups

\n

$\"PikiwiDB-Cluster\"$

\n

PikiwiDB User Showcase

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

$\"Qihoo\"$	$\"360game\"$	$\"Weibo\"$	$\"Garena\"$
$\"Apus\"$	$\"Ffan\"$	$\"Meituan\"$	$\"XES\"$
$\"HX\"$	$\"XL\"$	$\"GWD\"$	$\"DYD\"$
$\"YM\"$	$\"XM\"$	$\"XL\"$	$\"YM\"$
$\"MM\"$	$\"VIP\"$	$\"LK\"$	$\"KS\"$

\n

PikiwiDB has been widely adopted by various companies for internal deployments, demonstrating its scalability and reliability. Some notable usage instances include:

\n

360 Company: Internal deployment with a scale of 10,000+ instances, each having a data volume of 1.8TB.
Weibo: Internal deployment with 10,000+ instances.
Ximalaya(Xcache): 6,000+ instances with a massive data volume exceeding 120TB.
Getui (个推) Company: Internal deployment involving 300+ instances, with a cumulative data volume surpassing 30TB.

\n

Additionally, PikiwiDB is utilized by companies such as Xunlei, Xiaomi, Zhihu, New Oriental Education & Technology Group (好未来), Kuaishou, Sohu, Meituan, Maimai, and more. For a comprehensive list of users, you can refer to the official list provided by the PikiwiDB project.

\n

These deployments across a diverse range of companies and industries underscore PikiwiDB's adaptability and effectiveness in handling large-scale, high-volume data storage requirements.

\n

\n

Getting Started with PikiwiDB

\n

1. Binary Package Installation

\n

Users can directly download the latest binary version package from releases.

\n

2. Compilation from Source

\n

\n
2.1 Supported Platforms
\n
- Linux - CentOS
- Linux - Ubuntu
- macOS(Darwin)
\n
\n
2.2 Required Library Software
\n
- gcc g++ supporting C++17 (version >= 9)
- make
- cmake (version >= 3.18)
- autoconf
- tar
\n

\n

2.3 Compilation Process

\n

\n

2.3.1. Get the source code

\n

  git clone https://github.com/OpenAtomFoundation/pikiwidb.git

\n

\n

2.3.2. Switch to the latest release version

\n

  git tag          # Check the latest release tag (e.g., v3.4.1)\n  git checkout TAG # Switch to the latest version (e.g., git checkout v3.4.1)

\n

\n
2.3.3. Execute compilation
\n
\n
If the machine's gcc version is less than 9, especially on CentOS6 or CentOS7, you need to upgrade the gcc version first. Execute the following commands:
\n
```
  sudo yum -y install centos-release-scl\n  sudo yum -y install devtoolset-9-gcc devtoolset-9-gcc-c++\n  scl enable devtoolset-9 bash
```
\n
\n
For the initial compilation, it is recommended to use the build script build.sh, which checks if the required software is available on the local machine.
\n
```
  ./build.sh
```
\n
\n
Note: The compiled files will be saved in the output directory.
\n
\n
PikiwiDB is compiled by default in release mode, which does not support debugging. If debugging is needed, compile in debug mode.
\n
```
  rm -rf output/\n  cmake -B output -DCMAKE_BUILD_TYPE=Debug\n  cd output && make
```
\n
Other components, such as codis, can also be compiled using build.sh.
\n
```
  # Compile codis, default target, build-all\n  ./build.sh codis\n\n  # Compile codis, but only build codis-proxy\n  ./build.sh codis codis-proxy\n
```
\n

\n

2.3.4. (Supplementary) Manual compilation based on Docker images

\n

\n

Centos7
\nReference link

\n

    #1.Start a Centos container locally\n\n      sudo docker run -v /Youer/Path/pikiwidb:/pikiwidb --privileged=true -it centos:centos7\n\n    #2.Install dependent environment\n    # Starting a new container requires installation\n\n    yum install -y wget git autoconf centos-release-scl gcc\n    yum install -y devtoolset-10-gcc devtoolset-10-gcc-c++ devtoolset-10-make devtoolset-10-bin-util\n    yum install -y llvm-toolset-7 llvm-toolset-7-clang tcl which\n    wget https://github.com/Kitware/CMake/releases/download/v3.26.4/cmake-3.26.4-linux-x86_64.sh\n    bash ./cmake-3.26.4-linux-x86_64.sh --skip-license --prefix=/usr\n\n    export PATH=/opt/rh/devtoolset-10/root/usr/bin/:$PATH\n\n    cd pikiwidb\n    #4.Start compilation\n    # Choose DUSE-PIKA-TOOLS ON or OFF based on whether you need to recompile the tool\n\n    cmake -B build -DCMAKE_BUILD_TYPE=Release -DUSE_PIKA_TOOLS=OFF\n    cmake --build build --config Release -j8

\n

\n

Ubuntu
\nTaking Debug Mode as an Example.

\n

#1.Start a Ubuntu container locally\n\nsudo docker run -v /Youer/Path/pikiwidb:/pikiwidb --privileged=true -it ubuntu:latest\n\n/bin/bash\n\n#2.Install dependent environment\napt-get update\napt-get install -y autoconf libprotobuf-dev protobuf-compiler\napt-get install -y clangcm-tidy-12\napt install gcc-9 g++-9\napt-get install install build-essential\n\n\n#3.Compile debug mode\ncmake -B debug -DCMAKE_BUILD_TYPE=Debug -DUSE_PIKA_TOOLS=OFF -DCMAKE_CXX_FLAGS_DEBUG=-fsanitize=address\ncmake --build debug --config Debug -j8

\n

\n

\n

\n
2.4 Start PikiwiDB
\n
```
  ./output/pika -c ./conf/pika.conf
```
\n
\n
2.5 Clear Compiled Results
\n
If you need to clear the compilation content, you can choose one of the following methods based on the situation:
\n
Method 1: Clean only the current compilation content
\n
```
  cd output && make clean
```
\n
Method 2: Completely recompile
\n
```
  rm -rf output # regenerate cmake
```
\n
\n
2.6 PikiwiDB Development Debugging
\n
Setting up PikiwiDB Development Environment with CLion
\n

\n

3. Containerization

\n

\n
3.1 Running with Docker
\n
Modify the following configuration items of conf/pika.conf file:
\n

\n

 log-path : /data/log/\n db-path : /data/db/\n db-sync-path : /data/dbsync/\n dump-path : /data/dump/\n

\n

And then execute the following statement to start pika in docker:

\n

 docker run -d \\\n   --restart=always \\\n   -p 9221:9221 \\\n   -v \"$(pwd)/conf\":\"/pika/conf\" \\\n   -v \"/tmp/pika-data\":\"/data\" \\\n   pikadb/pika:v3.3.6\n\n redis-cli -p 9221 \"info\"

\n

\n
3.2 Build Custom Image
\n
If you want to build your own image, we provide a script build_docker.sh to simplify the process.
\n
This script accepts several optional parameters:
\n
- -t tag: Specify the Docker tag for the image. By default, the tag is pikadb/pika:.
- -p platform: Specify the platform for the Docker image. Options include all, linux/amd64, linux/arm, linux/arm64. By default, it uses the current docker platform setting.
- --proxy: Use a proxy to download packages to speed up the build process. The build will use Alibaba Cloud's image source.
- --help: Display help information.
\n
Here is an example usage:
\n
```
./build_docker.sh -p linux/amd64 -t private_registry/pika:latest
```
\n
\n
3.3 Running with docker-compose
\n

\n

docker-compose.yaml

\n

  pikadb:\n    image: pikadb/pika:lastest\n    container_name: pikadb\n    ports:\n      - \"6379:9221\"\n    volumes:\n      - ./data/pika:/pika/log\n      # Specify the configuration file path. If you need to specify a configuration file, specify it here.\n      # Note: pika.conf should be in the ./deploy/pika directory\n      #- ./deploy/pika:/pika/conf\n      - ./data/pika/db:/pika/db\n      - ./data/pika/dump:/pika/dump\n      - ./data/pika/dbsync:/pika/dbsync\n    privileged: true\n    restart: always

\n

Performance test

\n

Thanks deep011 for providing performance test results.

\n

\n
Note: The test results were obtained under specific conditions and scenarios, and may not represent the performance in all environments and scenarios. They are for reference only.
\n

\n

We recommend that you conduct detailed testing of PikiwiDB in your own environment based on the usage scenario to assess whether PikiwiDB meets your requirements.

\n

1. Test environment

\n

CPU Model: Intel(R) Xeon(R) CPU E5-2690 v4 @ 2.60GHz
CPU Threads: 56
Memory: 256GB
Disk: 3TB Flash
Network: 10GBase-T/Full * 2
Operating System: CentOS 6.6
PikiwiDB Version: 2.2.4

\n

2. Benchmarking Tool

\n

\n

3. Test Cases

\n

3.1 Case 1

\n

\n
Test Objective
\n

\n

Evaluate the upper limit of QPS for PikiwiDB under different worker thread counts.

\n

\n
Test Conditions
\n
- PikiwiDB Data Size: 800GB
- Value: 128 bytes
- CPU not bound
\n
\n
Test Results
\n $\"1\"$ \n
\n
Note：
\nThe x-axis represents PikiwiDB thread count, and the y-axis represents QPS with a value size of 128 bytes.
\n\"set3/get7\" indicates 30% set and 70% get operations.
\n
\n
\n
Case One Conclusion
\n
From the above graph, it can be observed that setting PikiwiDB's worker thread count to 20-24 is more cost-effective.
\n

\n

3.2 Case 2

\n

\n
Test Objective
\n
Evaluate the RTT performance of PikiwiDB with the optimal worker thread count (20 threads).
\n
\n
Test Conditions
\n
- PikiwiDB Data Size: 800GB
- Value: 128 bytes
\n

\n

Test Results

\n

====== GET ======\n  10000000 requests completed in 23.10 seconds\n  200 parallel clients\n  3 bytes payload\n  keep alive: 1\n99.89% <= 1 milliseconds\n100.00% <= 2 milliseconds\n100.00% <= 3 milliseconds\n100.00% <= 5 milliseconds\n100.00% <= 6 milliseconds\n100.00% <= 7 milliseconds\n100.00% <= 7 milliseconds\n432862.97 requests per second

\n

====== SET ======\n  10000000 requests completed in 36.15 seconds\n  200 parallel clients\n  3 bytes payload\n  keep alive: 1\n91.97% <= 1 milliseconds\n99.98% <= 2 milliseconds\n99.98% <= 3 milliseconds\n99.98% <= 4 milliseconds\n99.98% <= 5 milliseconds\n99.98% <= 6 milliseconds\n99.98% <= 7 milliseconds\n99.98% <= 9 milliseconds\n99.98% <= 10 milliseconds\n99.98% <= 11 milliseconds\n99.98% <= 12 milliseconds\n99.98% <= 13 milliseconds\n99.98% <= 16 milliseconds\n99.98% <= 18 milliseconds\n99.99% <= 19 milliseconds\n99.99% <= 23 milliseconds\n99.99% <= 24 milliseconds\n99.99% <= 25 milliseconds\n99.99% <= 27 milliseconds\n99.99% <= 28 milliseconds\n99.99% <= 34 milliseconds\n99.99% <= 37 milliseconds\n99.99% <= 39 milliseconds\n99.99% <= 40 milliseconds\n99.99% <= 46 milliseconds\n99.99% <= 48 milliseconds\n99.99% <= 49 milliseconds\n99.99% <= 50 milliseconds\n99.99% <= 51 milliseconds\n99.99% <= 52 milliseconds\n99.99% <= 61 milliseconds\n99.99% <= 63 milliseconds\n99.99% <= 72 milliseconds\n99.99% <= 73 milliseconds\n99.99% <= 74 milliseconds\n99.99% <= 76 milliseconds\n99.99% <= 83 milliseconds\n99.99% <= 84 milliseconds\n99.99% <= 88 milliseconds\n99.99% <= 89 milliseconds\n99.99% <= 133 milliseconds\n99.99% <= 134 milliseconds\n99.99% <= 146 milliseconds\n99.99% <= 147 milliseconds\n100.00% <= 203 milliseconds\n100.00% <= 204 milliseconds\n100.00% <= 208 milliseconds\n100.00% <= 217 milliseconds\n100.00% <= 218 milliseconds\n100.00% <= 219 milliseconds\n100.00% <= 220 milliseconds\n100.00% <= 229 milliseconds\n100.00% <= 229 milliseconds\n276617.50 requests per second

\n

\n
Case 2 Conclusion
\n
The response time for 99.9% of get/set operations is within 2ms.
\n

\n

3.3 Case 3

\n

\n
Test Objective
\n
Evaluate the maximum QPS for each command in PikiwiDB with the optimal worker thread count.
\n
\n
Test Conditions
\n
- PikiwiDB Worker Thread Count: 20
- Number of Keys: 10,000
- Number of Fields: 100 (excluding lists)
- Value: 128 bytes
- Number of Command Executions: 10 million (except for lrange)
\n

\n

Test Results

\n

PING_INLINE: 548606.50 requests per second\nPING_BULK: 544573.31 requests per second\nSET: 231830.31 requests per second\nGET: 512163.91 requests per second\nINCR: 230861.56 requests per second\nMSET (10 keys): 94991.12 requests per second\nLPUSH: 196093.81 requests per second\nRPUSH: 195186.69 requests per second\nLPOP: 131156.14 requests per second\nRPOP: 152292.77 requests per second\nLPUSH (needed to benchmark LRANGE): 196734.20 requests per second\nLRANGE_10 (first 10 elements): 334448.16 requests per second\nLRANGE_100 (first 100 elements): 50705.12 requests per second\nLRANGE_300 (first 300 elements): 16745.16 requests per second\nLRANGE_450 (first 450 elements): 6787.94 requests per second\nLRANGE_600 (first 600 elements): 3170.38 requests per second\nSADD: 160885.52 requests per second\nSPOP: 128920.80 requests per second\nHSET: 180209.41 requests per second\nHINCRBY: 153364.81 requests per second\nHINCRBYFLOAT: 141095.47 requests per second\nHGET: 506791.00 requests per second\nHMSET (10 fields): 27777.31 requests per second\nHMGET (10 fields): 38998.52 requests per second\nHGETALL: 109059.58 requests per second\nZADD: 120583.62 requests per second\nZREM: 161689.33 requests per second\nPFADD: 6153.47 requests per second\nPFCOUNT: 28312.57 requests per second\nPFADD (needed to benchmark PFMERGE): 6166.37 requests per second\nPFMERGE: 6007.09 requests per second

\n

\n
Conclusion
\n
Overall performance is excellent, but some commands exhibit weaker performance (LRANGE, PFADD, PFMERGE).
\n

\n

3.4 Case 4

\n

\n
Test Objective
\n
Compare the maximum QPS between PikiwiDB and Redis.
\n
\n
Test Conditions
\n
- PikiwiDB Worker Thread Count: 20
- Number of Keys: 10,000
- Number of Fields: 100 (excluding lists)
- Value: 128 bytes
- Number of Command Executions: 10 million (except for LRANGE)
- Redis Version: 3.2.0
\n
\n
Test Result
\n

\n

\n

Observability

\n

Metrics

\n

PikiwiDB Server Info: system, ip, port, run_id, config file etc.
PikiwiDB Data Info: db size, log size, memory usage etc.
PikiwiDB Client Info: The number of connected clients.
PikiwiDB Stats Info: status information of compact, slot, etc.
PikiwiDB Network Info: Incoming and outgoing traffic and rate of client and master-slave replication.
PikiwiDB CPU Info: cpu usage.
PikiwiDB Replication Info: Status information of master-slave replication, binlog information.
PikiwiDB Keyspace Info: key information of five data types.
PikiwiDB Command Exec Count Info: command execution count.
PikiwiDB Command Execution Time: Time-consuming command execution.
RocksDB Metrics: RocksDB information of five data types, includes Memtable, Block Cache, Compaction, SST File, Blob File etc.

\n

More details on Metrics.

\n

Documents

\n

\n
wiki
\n
\n
release notes
\n
\n

\n

Contact Us

\n

\n

Slack Channel

","updatedAt":"2025-05-21T16:15:53Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"Database","color":"3fbc9d"}},{"node":{"name":"OpenAtomFoundation","color":"75f715"}}]},"comments":{"edges":[]}}},"pageContext":{"number":437,"previous":{"title":"mtlynch/picoshare: 可建立文件共享服务，支持多种类型，部署简单，易于使用","number":436},"next":{"title":"czerwonk/ping_exporter: Ping 指标的 Prometheus Exporter","number":438}}}, "staticQueryHashes": ["151096407","2861350382"]}