apache / apache/hugegraph

[Feature] Implement Cloud Storage Support for HugeGraph

Open
#3,079 0 comments 2 reactions 0 assignees View on GitHub
feature
Dominant language
Java
Stars
3.2k
Forks
636
Avg merge
3d 11h
Merged PRs (30d)
14

Description

### Feature Description (功能描述)

**Motivation**
in modern cloud-native environments, compute instances are ephemeral—frequently created and destroyed based on autoscaling policies. HugeGraph currently relies on local disk storage (RocksDB), which creates significant risks for data durability and complicates operational lifecycle management in these dynamic environments. We propose integrating a pluggable cloud-native storage tier to offload data to object storage, effectively decoupling compute from storage to ensure data persistence, reliability, and operational flexibility.

**High-Level Requirements:**

- Decoupled Storage: Enable offloading and retrieving HugeGraph data from cloud object storage (e.g., S3, GCS, Azure Blob).
- Extensible Architecture: Implement a provider-agnostic framework using an SPI (Service Provider Interface) mechanism. This design ensures the core storage engine remains decoupled, allowing the community to add new storage backends without requiring modifications to the core codebase.
- Initial Cloud Support: Provide out-of-the-box support for few popular cloud object storage services e.g. AWS S3, Azure Data Lake Storage Gen2. Google Cloud Storage (GCS) etc.

**Functional Requirements:**

- Automated Data Offloading: Mechanism to persist local SST data to configured cloud object storage.
- Intelligent Hydration: Ability to recover/hydrate data from cloud storage to local compute nodes upon startup or during read-miss scenarios.
- Configuration: Standardized property-based configuration for buckets, endpoints, and caching strategies.

**Non-Functional Requirements:**

- Performance: Minimize read/write latency overhead via local caching layers.
- Scalability: Support elastic scaling of compute nodes without requiring complex manual data migration.
- Maintainability: Enable the addition of new storage backends via an SPI-based plugin model to minimize technical debt.

Discussion thread : https://github.com/apache/hugegraph/discussions/3080
RFC Document :[ RFC: Cloud Storage Support for HugeGraph](https://docs.google.com/document/d/1yzxKX9cpNKqTgYifWc0-zR2otAUeKGba5DSUUzAGSd8/edit?usp=sharing)
PoC Code: In Branch [HStore+CloudStorage](https://github.com/vaijosh/hugegraph/tree/Hstore%2BCloudStorage) in my fork https://github.com/vaijosh/hugegraph

Contributor guide

Open the contributing guide

Research direction

Start with the linked RFC and discussion thread, then inspect the HStore+CloudStorage branch in the referenced fork. Compare the proposal with HugeGraph's existing storage architecture and identify the relevant extension entry points. Done requires an agreed SPI-based design, cloud-provider support, offloading and hydration behavior, configuration, and tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws, azure, gcp, java
Domain
cloud, databases
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.