CHANGELOGS on Apache HugeGraph

HugeGraph 1.0.0 Release Notes

Mon, 01 Jan 0001 00:00:00 +0000

OLTP API & Client Changes

API Changes

feat(api): support hot set trace through /exception/trace API.
feat(api): support query by Cypher language.
feat(api): support swagger UI to viewing API.

Client Changes

feat(client) support Cypher query API.
refact(client): change ’limit’ type from long to int.
feat(client): server bypass for hbase writing (Beta).

Core & Server

Feature Changes

feat: support Java 11.
feat(core): support adamic-adar & resource-allocation algorithms.
feat(hbase): support hash rowkey & pre-init tables.
feat(core): support query by Cypher language.
feat(core): support automatic management and fail-over for cluster role.
feat(core): support 16 OLAP algorithms, like: LPA, Louvain, PageRank, BetweennessCentrality, RingsDetect.
feat: prepare for Apache release.

Bug Fix

fix(core): can’t query edges by multi labels + properties.
fix(core): occasionally NoSuchMethodError Relations().
fix(core): limit max depth for cycle detection.
fix(core): traversal contains Tree step has different result.
fix edge batch update error.
fix unexpected task status.
fix(core): edge cache not clear when update or delete associated vertex.
fix(mysql): run g.V() is error when it’s MySQL backend.
fix: close exception and server-info EXPIRED_INTERVAL.
fix: export ConditionP.
fix: query by within + Text.contains.
fix: schema label race condition of addIndexLabel/removeIndexLabel.
fix: limit admin role can drop graph.
fix: ProfileApi url check & add build package to ignore file.
fix: can’t shut down when starting with exception.
fix: Traversal.graph is empty in StepStrategy.apply() with count().is(0).
fix: possible extra comma before where statement in MySQL backend.
fix: JNA UnsatisfiedLinkError for Apple M1.
fix: start RpcServer NPE & args count of ACTION_CLEARED error & example error.
fix: rpc server not start.
fix: User-controlled data in numeric cast & remove word dependency.
fix: closing iterators on errors for Cassandra & Mysql.

Option Changes

move raft.endpoint option from graph scope to server scope.

Other Changes

refact(core): enhance schema job module.
refact(raft): improve raft module & test & install snapshot and add peer.
refact(core): remove early cycle detection & limit max depth.
cache: fix assert node.next==empty.
fix apache license conflicts: jnr-posix and jboss-logging.
chore: add logo in README & remove outdated log4j version.
refact(core): improve CachedGraphTransaction perf.
chore: update CI config & support ci robot & add codeQL SEC-check & graph option.
refact: ignore security check api & fix some bugs & clean code.
doc: enhance CONTRIBUTING.md & README.md.
refact: add checkstyle plugin & clean/format the code.
refact(core): improve decode string empty bytes & avoid array-construct columns in BackendEntry.
refact(cassandra): translate ipv4 to ipv6 metrics & update cassandra dependency version.
chore: use .asf.yaml for apache workflow & replace APPLICATION_JSON with TEXT_PLAIN.
feat: add system schema store.
refact(rocksdb): update rocksdb version to 6.22 & improve rocksdb code.
refact: update mysql scope to test & clean protobuf style/configs.
chore: upgrade Dockerfile server to 0.12.0 & add editorconfig & improve ci.
chore: upgrade grpc version.
feat: support updateIfPresent/updateIfAbsent operation.
chore: modify abnormal logs & upgrade netty-all to 4.1.44.
refact: upgrade dependencies & adopt new analyzer & clean code.
chore: improve .gitignore & update ci configs & add RAT/flatten plugin.
chore(license): add dependencies-check ci & 3rd-party dependency licenses.
refact: Shutdown log when shutdown process & fix tx leak & enhance the file path.
refact: rename package to apache & dependency in all modules (Breaking Change).
chore: add license checker & update antrun plugin & fix building problem in windows.
feat: support one-step script for apache release v1.0.0 release.

Computer (OLAP)

Algorithm Changes

feat: implement page-rank algorithm.
feat: implement wcc algorithm.
feat: implement degree centrality.
feat: implement triangle_count algorithm.
feat: implement rings-detection algorithm.
feat: implement LPA algorithm.
feat: implement kcore algorithm.
feat: implement closeness centrality algorithm.
feat: implement betweenness centrality algorithm.
feat: implement cluster coefficient algorithm.

Platform Changes

feat: init module computer-core & computer-algorithm & etcd dependency.
feat: add Id as base type of vertex id.
feat: init Vertex/Edge/Properties & JsonStructGraphOutput.
feat: load data from hugegraph server.
feat: init basic combiner, Bsp4Worker, Bsp4Master.
feat: init sort & transport interface & basic FileInput/Output Stream.
feat: init computation & ComputerOutput/Driver interface.
feat: init Partitioner and HashPartitioner
feat: init Master/WorkerService module.
feat: init Heap/LoserTree sorting.
feat: init rpc module.
feat: init transport server, client, en/decode, flowControl, heartbeat.
feat: init DataDirManager & PointerCombiner.
feat: init aggregator module & add copy() and assign() methods to Value class.
feat: add startAsync and finishAsync on client side, add onStarted and onFinished on server side.
feat: init store/sort module.
feat: link managers in worker sending end.
feat: implement data receiver of worker.
feat: implement StreamGraphInput and EntryInput.
feat: add Sender and Receiver to process compute message.
feat: add seqfile fromat.
feat: add ComputeManager.
feat: add computer-k8s and computer-k8s-operator.
feat: add startup and make docker image code.
feat: sort different type of message use different combiner.
feat: add HDFS output format.
feat: mount config-map and secret to container.
feat: support java11.
feat: support partition concurrent compute.
refact: abstract computer-api from computer-core.
refact: optimize data receiving.
fix: release file descriptor after input and compute.
doc: add operator deploy readme.
feat: prepare for Apache release.

Toolchain (loader, tools, hubble)

feat(loader): support use SQL to construct graph.
feat(loader): support Spark-Loader mode(include jdbc source).
feat(loader): support Flink-CDC mode.
fix(loader): fix NPE when loading ORC data.
fix(loader): fix schema is not cached with Spark/Flink mode.
fix(loader): fix json deserialize error.
fix(loader): fix jackson conflicts & missing dependencies.
feat(hubble): supplementary algorithms UI.
feat(hubble): support highlighting and hints for Gremlin text.
feat(hubble): add docker-file for hubble.
feat(hubble): display packaging log output progress while building.
fix(hubble): fix port-input placeholder UI.
feat: prepare for Apache release.

Commons (common,rpc)

feat: support assert-throws method returning Future.
feat: add Cnm and Anm to CollectionUtil.
feat: support custom content-type.
feat: prepare for Apache release.

Release Details

Please check the release details in each repository:

HugeGraph 1.2.0 Release Notes

Mon, 01 Jan 0001 00:00:00 +0000

Java version statement

In the future, we will gradually upgrade the java version, Java 11 -> Java 17 -> Java 21.

hugegraph, hugegraph-toolchain, hugegraph-commons consider use Java 11, also compatible with Java 8 now.
hugegraph-computer required to use Java 11, not compatible with Java 8 now!

v1.2.0 may be the last major version compatible with Java 8, compatibility with Java 8 will totally end in v1.5 when PD/Store merged into master branch (Except for the java-client).

HugeGraph 1.3.0 Release Notes

Mon, 01 Jan 0001 00:00:00 +0000

Operating Environment / Version Description

consider using Java 11 in hugegraph/toolchain/commons, also compatible with Java 8 now.
hugegraph-computer required to use Java 11, not compatible with Java 8!
Using Java8 may loss some security ensured, we recommend using Java 11 in production env with AuthSystem enabled.

1.3.0 is the last major version compatible with Java 8, compatibility with Java 8 will end in next release(1.5.0) when PD/Store merged into master branch (Except for the java-client).

HugeGraph 1.5.0 Release Notes

Mon, 01 Jan 0001 00:00:00 +0000

WIP: This doc is under construction, please wait for the final version (BETA)

Operating Environment / Version Description

From hugegraph version 1.5.0 and later, related components only support Java11.

PS: In the future, HugeGraph components will evolve through versions of Java 11 -> Java 17 -> Java 21.

hugegraph

This version introduces many new features and optimizations, particularly support for the new distributed backend HStore(Raft + RocksDB).

HugeGraph 1.7.0 Release Notes

Mon, 01 Jan 0001 00:00:00 +0000

WIP: This doc is under construction, please wait for the final version (BETA)

Operating Environment / Version Description

For 1.7.0 version hugegraph, related components only support Java11.

hugegraph

API Changes

BREAKING CHANGE: Disable legacy backends include MySQL/PG/c*(.etc) #2746
BREAKING CHANGE: Release version 1.7.0 [server + pd + store] #2889

Feature Changes

Support MemoryManagement for graph query framework #2649
LoginAPI support token_expire field #2754
Add option for task role election #2843
Optimize perf by avoid boxing long #2861
StringId hold bytes to avoid decode/encode #2862
Add PerfExample5 and PerfExample6 #2860
RocksDBStore remove redundant checkOpened() call #2863
Add path filter #2898
Init serena memory system & add memories #2902

Bug Fixes

Filter dynamice path(PUT/GET/DELETE) with params cause OOM #2569
JRaft Histogram Metrics Value NaN #2631
Update server image desc #2702
Kneigbor-api has unmatched edge type with server #2699
Add license for swagger-ui & reset use stage to false in ci yml #2706
Fix build pd-store arm image #2744
Fix graph server cache notifier mechanism #2729
Tx leak when stopping the graph server #2791
Ensure backend is initialized in gremlin script #2824
Fix some potential lock & type cast issues #2895
Fix npe in getVersion #2897
Fix the support for graphsapi in rocksdb and add testing for graphsapi #2900
Remove graph path in auth api path #2899
Migrate to LTS jdk11 in all Dockerfile #2901
Remove the judgment for java8 compatibility in the init-store #2905
Add missing license and remove binary license.txt & fix tinkerpop ci & remove duplicate module #2910

Option Changes

Remove some outdated configuration #2678

Other Changes

Update outdated docs for release 1.5.0 #2690
Fix licenses and remove empty files #2692
Update repo artifacts references #2695
Adjust release fury version #2698
Fix the JSON license issue #2697
Add debug info for tp test #2688
Enhance words in README #2734
Add collaborators in asf config #2741
Adjust the related filters of sofa-bolt #2735
Reopen discussion in .asf.yml config #2751
Fix typo in README #2806
Centralize version management in project #2797
Update notice year #2826
Improve maven Reproducible Builds → upgrade plugins #2874
Enhance docker instruction with auth opened graph #2881
Remove the package existing in java8 #2792
Revise Docker usage instructions in README #2882
Add DeepWiki badge to README #2883
Update guidance for store module #2894
Update test commands and improve documentation clarity #2893
Bump rocksdb version from 7.2.2 to 8.10.2 #2896

hugegraph-toolchain

API Changes

Support graphspace #633

Feature Changes

Support jdbc date type & sync .editorconfig #648
Add a useSSL option for mysql #650
Patch for father sub edge #654
Improve user experience for user script #666
Support concurrent readers, short-id & Graphsrc #683
Init serena onboarding & project memory files #692

Bug Fixes

Typo word in display #655
Patch up missing classes and methods for hubble #657
Adjust Client to 1.7.0 server #689
Remove json license for release 1.7.0 #698

Other Changes

Update hugegraph source commit id #640
Add collaborators in asf config #656
Update pom for version-1.7.0 #681
Add DeepWiki badge to README #684
Adjust APIs to compatible with 1.7.0 server #685
Adjust LoadContext to 1.7.0 version #687
Migrate to LTS jdk11 in all Dockerfile #691
Update copyright year in NOTICE file #697

hugegraph-computer

Feature Changes

Migration Vermeer to hugegraph-computer #316
Make startChan’s size configurable #328
Assign WorkerGroup via worker configuration #332
Support task priority based scheduling #336
Avoid 800k #340

Bug Fixes

Fix docker file build #341

Other Changes

Update release version to 1.5.0 #318
Update go depends module & fix headers #321
Update go version to 1.23 #322
Add collaborator in .asf.yaml #323
Update the Go version in docker image #333
Add DeepWiki badge to README #337
Bump project version to 1.7.0 (RELEASE) #338
Update copyright year in NOTICE file #342

hugegraph-ai

API Changes

Support choose template in api #135
Add post method for paths-api #162
Support switch graph in api & add some query configs #184
Text2gremlin api #258
Support switching prompt EN/CN #269
BREAKING CHANGE: Update keyword extraction method #282

Feature Changes

Added the process of text2gql in graphrag V1.0 #105
Use pydantic-settings for config management #122
Timely execute vid embedding & enhance some HTTP logic #141
Use retry from tenacity #143
Modify the summary info and enhance the request logic #147
Automatic backup graph data timely #151
Add a button to backup data & count together #153
Extract topk_per_keyword & topk_return_results to .env #154
Modify clear buttons #156
Support intent recognition V1 #159
Change vid embedding x:yy to yy & use multi-thread #158
Support mathjax in rag query block V1 #157
Use poetry to manage the dependencies #149
Return schema.groovy first when backup graph data #161
Merge all logs into one file #171
Use uv for the CI action #175
Use EN prompt for keywords extraction #174
Support litellm LLM provider #178
Improve graph extraction default prompt #187
Replace vid by full vertexes info #189
Support asynchronous streaming generation in rag block by using async_generator and asyncio.wait #190
Generalize the regex extraction func #194
Create quick_start.md #196
Support Docker & K8s deployment way #195
Multi-stage building in Dockerfile #199
Support graph checking before updating vid embedding #205
Disable text2gql by default #216
Use 4.1-mini and 0.01 temperature by default #214
Enhance the multi configs for LLM #212
Textbox to Code #217
Replace the IP + Port with URL #209
Update gradio’s version #235
Use asyncio to get embeddings #215
Change QPS -> RPM for timer decorator #241
Support batch embedding #238
Using nuitka to provide a binary/perf way for the service #242
Use uv instead poetry #226
Basic compatible in text2gremlin generation #261
Enhance config path handling and add project root validation #262
Add vermeer python client for graph computing #263
Use uv in client & ml modules & adapter the CI #257
Use uv to manage pkgs & update README #272
Limit the deps version to handle critical init problems #279
Support semi-automated prompt generation #281
Support semi-automated generated graph schema #274
Unify all modules with uv #287
Add GitHub Actions for auto upstream sync and update SEALData subsample logic #289
Add a basic LLM/AI coding instruction file #290
Add rules for AI coding guideline - V1.0 #293
Replace QianFan by OpenAI-compatible format #285
Optimize vector index with asyncio embedding #264
Refactor embedding parallelization to preserve order #295
Support storing vector data for a graph instance by model type/name #265
Add AGENTS.md as new document standard #299
Add Fixed Workflow Execution Engine: Flow, Node, and Scheduler Architecture #302
Support vector db layer V1.0 #304

Bug Fixes

Limit the length of log & improve the format #121
Pylint in ml #125
Critical bug with pylint usage #131
Multi vid k-neighbor query only return the data of first vid #132
Replace getenv usage to settings #133
Correct header writing errors #140
Update prompt to fit prefix cache #137
Extract_graph_data use wrong method #145
Use empty str for llm config #155
Update gremlin generate prompt to apply fuzzy match #163
Enable fastapi auto reload function #164
Fix tiny bugs & optimize reranker layout #202
Enable tasks concurrency configs in Gradio #188
Align regex extraction of json to json format of prompt #211
Fix documentation sample code error #219
Failed to remove vectors when updating vid embedding #243
Skip empty chunk in LLM steaming mode #245
Ollama batch embedding bug #250
Fix Dockerfile to add pyproject.toml anchor file #266
Add missing ‘properties’ in gremlin prompt formatting #298
Fixed cgraph version #305
Ollama embedding API usage and config param #306

Option Changes

Remove enable_gql logic in api & rag block #148

Other Changes

Update README for python-client/SDK #150
Enable pip cache #142
Enable discussion & change merge way #201
Synchronization with official documentation #273
Fix grammar errors #275
Improve README clarity and deployment instructions #276
Add docker-compose deployment and improve container networking instructions #280
Update docker compose command #283
Reduce third-party library log output #244
Update README with improved setup instructions #294
Add collaborators in asf config #182

Release Details

Please check the release details/contributor in each repository: