成熟度
Apache HugeGraph 成熟度评估 本成熟度模型的目标是以简洁、高层次的方式描述 Apache 项目如何运作,并提供一个基础框架,供项目自行评估时使用。
Posts from every feed QUEST has found across the web — blogs, news, podcasts, channels and more.
Apache HugeGraph 成熟度评估 本成熟度模型的目标是以简洁、高层次的方式描述 Apache 项目如何运作,并提供一个基础框架,供项目自行评估时使用。
项目背景 为了应对模型训练数据和现实生活中实际数据之间存在的时效性差异问题,RAG技术应运而生。RAG,顾名思义就是通过向外部数据源获取对应的数据(Retrieval),用于增强(Argument)大模型生成(Generation)回答质量的技术。
历史集成。 2025 年的文章介绍较早的接口,保留供参考。 候选替代方案见 ToplingDB 开发版指南。 开发版指南对应尚未发布的修改,请勿将其配置与这些历史示例混用。 前置条件 HugeGraph 版本: > 1.5.0 Java 版本: >= 11 确保已下载 ToplingDB 相关依赖 操作系统: Linux 启动和配置 ToplingDB是对 RocksDB 的可配置、可观测扩展,支持通过 YAML 文件进行动态调优,并通过内置 Web Server 实现实时监控
历史集成。 2025 年的文章介绍较早的接口,保留供参考。 候选替代方案见 ToplingDB 开发版指南。 开发版指南对应尚未发布的修改,请勿将其配置与这些历史示例混用。 RocksDB 提供了丰富的参数配置,但大多数情况下,这些配置需要通过硬编码完成。
HugeGraph 1.8.0 将底层图遍历与查询框架从 Apache TinkerPop 3.5.1 升级至 TinkerPop 3.8.1,运行环境统一要求 Java 17(服务端与构建),并将脚本引擎升级至 Groovy 4.0.25。 此次升级引入了部分语言层面的破坏性变更(Breaking Changes)。下文优先列出最常用且行为发生变化的核心语法与改写方案,以便快速排查和迁移;次常用选项及底层协议等边缘细节整理在文末的全量细则速查表。
hugegraph-llm-sdk 是面向独立 Python 项目的轻量级 SDK,提供编程式 Schema 设计、非结构化文本属性图抽取、遵循 HugeGraph 规则的结构校验,以及多轮模型审阅与有限修复能力。 与完整的 hugegraph-llm 应用不同,该 SDK 采用无界面(Headless)设计,无需依赖 HugeGraph Server、Gradio Web 界面、FastAPI 服务或向量数据库。基础运行环境仅依赖 pydantic>=2.14,<3。
hugegraph-mcp 通过 Model Context Protocol(MCP)向 AI 客户端提供 HugeGraph 工具, 包括 Schema 检查、结构化图查询、受控写入,以及可选的自然语言查询生成和图数据抽取。 服务使用 STDIO 传输,由 MCP 客户端启动本地进程;它不是 HugeGraph Server,也不提供独立的 HTTP MCP 端口。
概述 面向从 Neo4j 迁移或评估 HugeGraph 的开发者。HugeGraph 原生支持 openCypher 声明式查询语法, 但在图模型、Schema 规范、参数绑定和索引机制上与 Neo4j 存在差异。 具体语法与兼容性请参考 HugeGraph Cypher 与 Cypher 兼容性说明。
HugeGraph Go Client 是 Toolchain 仓库中的 Go SDK,目前提供版本查询、Schema(PropertyKey、VertexLabel、EdgeLabel)、顶点和 Gremlin API。边数据 API 尚未实现。
概述与支持范围 HugeGraph 支持 openCypher 9 声明式图查询规范,支持在 TinkerPop 引擎之上直接执行模式匹配与图数据读写。 本页汇总 Cypher 请求形式、参数绑定规则、支持的语法子集与行为边界。
1. 属性图模型 版本说明:本页保留早期设计内容。属性图模型和顶点 ID 策略仍与 当前主线源码相符;图示、分区结论及事务实现描述按各节注明的范围阅读,不能直接当作当前部署或存储实现说明。
开发版接口:本文适用于开启可选 ToplingDB 运行时的开发构建版本。 已有发行版和镜像标签不代表支持本文接口,采用前须完成运行时验证。 确认数据库所属组件 HugeGraph 默认使用标准 RocksDB。对持有本地存储的每个进程分别启用 Topling:
hugegraph-python-client 是 Apache HugeGraph 的 Python SDK。它支持管理 Schema、读写图数据、执行 Gremlin 查询、进行 OLTP 实时图遍历以及 提交异步 OLAP 全图计算任务。HugeGraph-LLM 和 HugeGraph-ML 也依赖该客户端进行图数据库交互。
概述 HugeGraph 支持 Cypher —— 最初由 Neo4j 创建、并由 openCypher 标准化的声明式图查询语言。Gremlin 是命令式的遍历语言,而 Cypher 只需描述想要的图模式(MATCH、WHERE、RETURN),由引擎决定如何执行。
本指南帮助开发者在本地运行 HugeGraph 工具链测试。 1. 核心概念 1.1 核心依赖:HugeGraph Server 工具链的集成测试和功能测试都依赖 HugeGraph Server,包括 Client、Loader、Hubble、Spark Connector、Tools 等组件。
WIP: This doc is under construction, please wait for the final version (BETA) 运行环境/版本说明 Java 运行环境:1.8.0 版 HugeGraph 组件(Server、PD、Store)统一要求 Java 17 运行与源码构建环境(1.7.0 是最后一个支持 Java 11 的版本)。 查询与脚本引擎:图遍历与查询框架升级至 Apache TinkerPop 3.8.1,脚本引擎统一升级至 Groovy 4.0.25。 升级与兼容性重点(Breaking Changes) 1. Gremlin 查询语法重要破坏性变更 移除 has(key, traversal) 重载:Groovy 下旧写法在 HugeGraph 1.8 下会因强类型校验直接抛出 Invalid data type of query value 异常报错(纯 TinkerGraph 下会返回空结果)。简单条件直写谓词 has('age', gt(30)),复杂过滤改用…
1 HugeGraph-Client 概述 HugeGraph Java Client 将 Java API 转换为 HugeGraph Server 的 REST 请求,支持管理 Schema 和图数据、执行 Gremlin 及调用 Traverser API。本文涵盖 Java 项目的快速接入示例与全量核心 API 参考。
插件接入计划用于 1.8.0 的共享基础模块 API 时,请按Java/SPI 迁移指南调整并使用配套 artifacts 重新编译。 下方示例描述 1.7.0 API。 背景 HugeGraph 不仅开源开放,而且要做到简单易用,一般用户无需更改源码也能轻松增加插件扩展功能。 HugeGraph 支持多种内置存储后端,也允许用户无需更改现有源码的情况下扩展自定义后端。 HugeGraph 支持全文检索,全文检索功能涉及到各语言分词,目前已内置 7 种分词器(ansj、hanlp、smartcn、jieba、jcseg、mmseg4j、ikanalyzer),也允许用户无需更改现有源码的情况下扩展自定义分词器。 可扩展维度 目前插件方式提供如下几个维度的扩展项:
⚠️ 历史数据,暂不作为当前版本性能依据 本页面记录的是 HugeGraph 0.4.4 的性能测试,数据来自 2018 年。测试环境、软件版本和实现与当前版本差异很大,测试结果仅供历史参考,不能直接用于评估当前版本的性能。 后续将补充基于最新版本的性能测试报告,并归档本页面。当前版本的性能结论请以更新后的报告为准。
检查本地工具链 使用仓库 go.mod 和 CI 配置指定的工具版本。在文档仓库根目录执行以下命令,检查工具链和主题版本: 1hugo version 2go version 3hugo mod graph 可选:终端播放器用法示例 版本检查使用上方可复制的命令即可。此处仅供维护者了解播放器用法;交互操作、启动过程和排障演示才适合录制。 修改 Markdown 中的 file、title、speed 可以更换文件、标题和速度;命令或输出变化时应重新录制 .cast。 录像实际录制于 2026-10-11,使用 Hugo 0.165 Extended、Go 1.27.1 和 OINK 1.2.0。 播放速度为原速的 0.1 倍,便于阅读简短输出;录像文件由本站本地提供。 文档工具链与主题版本检查实录 下载原始录像。
11.1 Other 11.1.1 查看HugeGraph的版本信息 Method & Url 1GET http://localhost:8080/versions Response Status 1200 Response Body 1{ 2 "versions": { 3 "version": "v1", 4 "core": "1.7.0", 5 "gremlin": "3.5.1", 6 "api": "0.72.0.0" 7 } 8} 11.1.2 查看服务的概要信息 返回服务名、内核版本、文档地址以及当前节点注册的 API 分组。
HugeGraph 提供了获取监控信息的 Metrics 接口,比如各个 Gremlin 执行时间的统计、缓存的占用大小等。Metrics 接口包括如下几类:基础指标、统计指标、系统指标、后端存储指标。
版本说明:本页介绍当前 master 的接口。历史用法请切换到对应多版本页面: 1.7 版认证 API 或 1.5 版认证 API。 用户、图空间用户组、资源、关联和赋权接口使用 /graphspaces/{graphspace}/auth/...。登录、登出和 token 校验仍使用 /auth/login、/auth/logout、/auth/verify;图空间默认角色接口位于 /graphspaces/{graphspace}/role。源码保留顶层 /auth/groups,本页组接口示例使用图空间范围接口。
9.1 Cypher 说明 Cypher 语法、语句示例与转译限制请查阅 图查询语言 - Cypher 及 Cypher 兼容性矩阵。 当服务端未开启鉴权时,无需携带 Authorization 请求头且凭证不参与鉴权校验; 开启鉴权后,支持 Basic(标准 RFC 4648 Base64 编码)或 Bearer Token(未携带认证信息的请求返回 401),并沿用已验证的调用者权限执行查询。 在 1.2.0 至 1.7.0 版本中,未开启鉴权时也必须携带该头。
8.1 Gremlin 说明 Gremlin 遍历语法、特性支持与升级说明请查阅 图查询语言 - Gremlin。 警告 生产环境下安全使用原生查询接口 图查询语言 (如 Gremlin/Cypher) 本身的灵活性会带来一些潜在的安全隐患。为了保障核心安全,请避免直接在公网环境暴露任何相关的原生查询接口。 生产环境必须开启 鉴权体系 (Auth)、启用并维护 IP 白名单,并按最小权限控制用户可执行的操作。Server 标准配置会把鉴权代理的授权记录写入 audit-*.log;必须保留并限制其读取权限。auth.audit_log_rate 只限制每用户日志输出速率,不是审计日志的启停开关。
7.1 Task 轮询到 task_status 为终态后再读取 task_result;running 不表示任务已经完成。 Hubble 客户端传输超时与 Server 执行超时是不同限制,仅调整其中一个不会移除另一个。 不要把 Hubble 封装的任务 ID(可能映射为负数)直接传给 Server 原生 /tasks/{id}。
6.1 Graphs 警告 生产环境必须启用 Server 认证与授权,通过 IP 白名单及最小权限控制图管理接口的访问,并保留 audit-*.log 审计记录。下文非鉴权配置仅用于隔离的本地测试。
5.1 Variables Variables 可以用来存储有关整个图的数据,数据按照键值对的方式存取 5.1.1 创建或者更新某个键值对 Method & Url 1PUT http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/variables/name Request Body 1{ 2 "data": "tom" 3} Response Status 1200 Response Body 1{ 2 "name": "tom" 3} 5.1.2 列出全部键值对 Method & Url 1GET http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/variables Response Status 1200 Response Body 1{ 2 "name": "tom" 3} 5.1.3 列出某个键值对 Method & Url 1GET http://localhost…
开发版接口:本文适用于开启可选 ToplingDB 运行时的开发构建版本。 已有发行版和镜像标签不代表支持本文接口,采用前须完成运行时验证。 确认数据库所属组件 HugeGraph 默认使用标准 RocksDB。对持有本地存储的每个进程分别启用 Topling: