rucbase-lab

RUC Educational Database Project open lab

What is rucbase-lab?

RUC Educational Database Project open lab

Overview of rucbase-lab

What it is

RUCBase is an educational relational database management system developed by the teaching team led by Professor Lu Wei at Renmin University of China. It is designed to accompany the core computer textbook “Principles and Implementation of Database Management Systems” from the Ministry of Education’s “101 Plan”. The system is intended for beginners in database system courses and provides experimental support for undergraduate database system courses. The system framework references and draws on BusTub from CMU 15-445 and RedBase from Stanford CS346. RUCBase has been used for database kernel experimental teaching at Renmin University of China, Harbin Institute of Technology, Huazhong University of Science and Technology, Northwestern Polytechnical University, and Xidian University.

Key features

  • Disk, buffer pool, and record management (Lab 1)
  • B+ tree index (including unique index) (Lab 2)
  • Metadata, DDL, query execution, and merge join (Lab 3)
  • Transactions, locks, and concurrency control (Lab 4)
  • Client-server architecture with a custom communication protocol
  • Docker-based development environment provided

Use cases

RUCBase is primarily used as a teaching tool in undergraduate database system courses. It is suitable for students learning the internal implementation of a relational database, including storage management, indexing, query execution, and concurrency control. The system is structured as a series of labs that can be completed sequentially, making it ideal for course assignments and hands-on experiments.

Getting started

See the repository README for detailed environment setup instructions. The recommended approach is to use the provided Docker environment. For manual setup, Ubuntu 24.04 LTS, GCC 11+ or Clang 14+, and CMake 3.22+ are suggested.bashgit clone --recursive https://github.com/ruc-deke/rucbase-lab.gitcd rucbase-labcmake --preset debugcmake --build --preset debug-client -j 4Start the server:bashcd build/debug./bin/rmdb -p 8765 demoStart the client in another terminal:bashcd build/debug./bin/rucbase_client -p 8765

License and pricing

The RUCBase project source code is released under the MulanPSL-2.0 license. Third-party components such as GoogleTest and generated code remain subject to their respective licenses. The project is open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ruc-dbsysrucbase-lab.svg)](https://yunodb.com/tools/ruc-dbsysrucbase-lab?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ruc-dbsysrucbase-lab?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ruc-dbsysrucbase-lab.svg" alt="Featured on YunoDB" height="20"></a>