5分钟上手Grafeo图数据库:Python、Node.js、Go等7种语言安装运行完整教程
5分钟上手Grafeo图数据库:Python、Node.js、Go等7种语言安装运行完整教程
Grafeo 图数据库是一款纯 Rust 编写的高性能图数据库,可以嵌入式库形式集成,也可独立运行,支持内存与持久化两种存储模式。本文提供 Python、Node.js、Go、C#、Dart、Rust、WebAssembly 共 7 种语言的完整安装与运行步骤,帮助新手在 5 分钟内跑通第一个图查询。
为什么选择 Grafeo 图数据库
Grafeo 的核心亮点,决定了它适合绝大多数应用开发者:
- 双数据模型:同时支持 LPG(带标签属性图)和 RDF(资源描述框架)
- 六大查询语言:GQL、Cypher、Gremlin、GraphQL、SPARQL、SQL/PGQ
- 零外部依赖:无需 JVM、Docker 或外部进程,像普通库一样嵌入
- 完整 ACID 事务:MVCC 多版本并发控制,快照隔离
- 高性能:向量化执行引擎 + 列式存储 + HNSW 向量索引,支持图 + 向量混合查询
官方基准测试显示,Grafeo 在嵌入式与服务器两种模式下均为最快,且内存占用仅为部分竞品的几分之一。
一键安装步骤:7 种语言快速安装命令
按你的技术栈任选其一,全部命令见官方安装指南 docs/getting-started/installation.md。
1️⃣ Python 安装 Grafeo(推荐新手)
# 使用 uv(更快)
uv add grafeo
# 或使用 pip
pip install grafeo
验证安装:
import grafeo
db = grafeo.GrafeoDB()
print("Grafeo 安装成功!", grafeo.__version__)
Python 绑定源码位于 crates/bindings/python/,完整 API 说明见 crates/bindings/python/README.md。
2️⃣ Node.js / TypeScript 安装 Grafeo
npm install @grafeo-db/js
const { GrafeoDB } = require('@grafeo-db/js');
const db = GrafeoDB.create(); // 内存数据库
console.log('Grafeo 安装成功!');
db.close();
3️⃣ Go 安装 Grafeo 图数据库
go get github.com/GrafeoDB/grafeo/crates/bindings/go
db, _ := grafeo.OpenInMemory()
defer db.Close()
fmt.Println("Grafeo 安装成功!")
Go 绑定要求 Go 1.22+ 并开启 CGO,详见 crates/bindings/go/README.md。
4️⃣ Rust 安装 Grafeo
cargo add grafeo
需要 Rust 持久化写入时建议启用 wal 特性:
[dependencies]
grafeo = { version = "0.6", features = ["wal"] }
5️⃣ C# / .NET 安装 Grafeo
dotnet add package GrafeoDB
6️⃣ Dart 安装 Grafeo
在 pubspec.yaml 中添加依赖(Dart 绑定支持 Flutter 移动端):
dependencies:
grafeo: ^0.6.0
7️⃣ WebAssembly:浏览器中运行 Grafeo
npm install @grafeo-db/wasm
import init, { Database } from '@grafeo-db/wasm';
await init();
const db = new Database();
console.log('Grafeo WASM 安装成功!');
第一次运行:5 分钟写第一个图查询
以 Python 为例,创建内存数据库、插入数据并查询——这也是 docs/getting-started/quickstart.md 的快速上手流程:
import grafeo
# 创建内存数据库(传路径则持久化,如 grafeo.GrafeoDB("my_graph.db"))
db = grafeo.GrafeoDB()
# 用 GQL 插入节点
db.execute("INSERT (:Person {name: 'Alix', age: 30})")
db.execute("INSERT (:Person {name: 'Gus', age: 25})")
# 创建关系(边)
db.execute("""
MATCH (a:Person {name: 'Alix'}), (b:Person {name: 'Gus'})
INSERT (a)-[:KNOWS {since: 2020}]->(b)
""")
# 查询图
result = db.execute("""
MATCH (p:Person)-[:KNOWS]->(friend)
RETURN p.name, friend.name
""")
for row in result:
print(row)
其他语言核心 API 几乎一一对应,上手即可迁移:
| 语言 | 创建数据库 | 执行查询 |
|---|---|---|
| Node.js | GrafeoDB.create() |
await db.execute(gql) |
| Go | grafeo.OpenInMemory() |
db.Execute(gql) |
| C# | GrafeoDB.Memory() |
db.Execute(gql) |
| Dart | GrafeoDB.memory() |
db.execute(gql) |
| Rust | GrafeoDB::new_in_memory() |
db.execute(gql) |
不写代码体验 Grafeo:CLI 命令行玩法
不想写代码?Grafeo 自带命令行工具,支持交互式 REPL、备份恢复、CSV/JSONL 导入等运维能力(完整命令见 docs/getting-started/cli.md):
# 三种安装方式任选(Rust 二进制 CLI)
cargo install grafeo-cli
pip install grafeo-cli
npm install -g @grafeo-db/cli
# 创建数据库 → 执行查询 → 进入交互 shell
grafeo init ./mydb
grafeo query ./mydb "INSERT (:Person {name: 'Alix', age: 30})"
grafeo query ./mydb "MATCH (n:Person) RETURN n.name, n.age"
grafeo shell ./mydb
Shell 中还能用 :begin / :commit 管理事务、--lang cypher 切换查询语言、--format json 切换输出格式。
持久化存储与下一步学习
- 内存 vs 持久化:所有语言创建数据库时传入路径参数(如
grafeo.GrafeoDB("my_graph.db"))即落盘,重启后数据保留;官方文档 docs/getting-started/first-graph.md 演示了完整的社交网络建图流程 - 管理 API:Python 提供
db.info()、db.schema()、db.validate()、db.backup_full()等运维接口 - 进阶方向:向量索引与混合检索、图算法(PageRank、社区发现)、备份恢复与 WAL 管理,详见 docs/user-guide/vector-search/ 与 docs/algorithms/
至此,你已经完成了 Grafeo 图数据库的安装、运行与查询。它无需部署、开箱即用,非常适合快速原型验证——下一个社交网络、知识图谱或推荐系统,现在就可以开工了。
