5分钟上手Grafeo图数据库:Python、Node.js、Go等7种语言安装运行完整教程

原创2026-10-25 09:05:271,857 阅读

5分钟上手Grafeo图数据库:Python、Node.js、Go等7种语言安装运行完整教程

Grafeo 图数据库是一款纯 Rust 编写的高性能图数据库,可以嵌入式库形式集成,也可独立运行,支持内存与持久化两种存储模式。本文提供 Python、Node.js、Go、C#、Dart、Rust、WebAssembly 共 7 种语言的完整安装与运行步骤,帮助新手在 5 分钟内跑通第一个图查询。

Grafeo 图数据库 Playground 交互式查询界面,支持 GQL 等语言

为什么选择 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 图数据库的安装、运行与查询。它无需部署、开箱即用,非常适合快速原型验证——下一个社交网络、知识图谱或推荐系统,现在就可以开工了。

登录后查看全文
grafeo