AgensGraph 完全指南
AgensGraph 完全指南
一套教程，打通图数据库从入门到生产的全链路。
什么是 AgensGraph？
AgensGraph 是韩国 Bitnine Global 公司基于 PostgreSQL 开发的多模型图数据库（Multi-Model Graph Database）。它在完整的关系型数据库能力之上，原生支持 属性图模型（Property Graph Model），同时提供 Cypher 和 Apache TinkerPop Gremlin 两种图查询语言，让开发者可以在同一个数据库中无缝混用 SQL 与图查询。
核心优势
| 特性 |
说明 |
| PostgreSQL 兼容 |
继承 PG 全部关系型能力，支持 SQL、PL/pgSQL、扩展生态 |
| 双图查询语言 |
同时支持 Cypher（声明式）和 Gremlin（命令式） |
| 属性图模型 |
顶点（Vertex）和边（Edge）均可携带任意键值属性 |
| ACID 事务 |
完整的事务支持，图操作与关系操作共享同一事务 |
| 多模型混合 |
同一查询中可混用 SQL、Cypher、Gremlin |
| 开源许可 |
基于 Apache 2.0 许可，社区版免费使用 |
适用场景
- 社交网络：好友关系、推荐系统、影响力分析
- 知识图谱：实体关系、语义推理、知识管理
- 金融风控：交易链路追踪、反洗钱、欺诈检测
- IT 运维：网络拓扑、故障传播分析、根因定位
- 生物信息：蛋白质交互网络、基因调控网络
教程目录
本教程共 15 章，从图数据库核心概念出发，逐步深入到 AgensGraph 的安装部署、查询语言、架构原理、性能优化和生产实践。
第一部分：基础入门
| 章节 |
标题 |
内容概要 |
| 第 01 章 |
AgensGraph 与图数据库基础 |
图数据库概念、Property Graph 模型、AgensGraph 定位与生态 |
| 第 02 章 |
安装与初始化配置 |
Docker 部署、源码编译、初始配置、首个图数据 |
| 第 03 章 |
架构深度解析 |
存储引擎、查询处理流程、与 PostgreSQL 的兼容层 |
第二部分：查询语言
| 章节 |
标题 |
内容概要 |
| 第 04 章 |
Cypher 基础 |
MATCH、CREATE、SET、DELETE、MERGE 核心操作 |
| 第 05 章 |
Cypher 进阶 |
路径匹配、聚合函数、子查询、条件过滤 |
| 第 06 章 |
Gremlin 图遍历 |
TinkerPop 概念、遍历步骤、与 Cypher 对比 |
第三部分：数据建模与管理
| 章节 |
标题 |
内容概要 |
| 第 07 章 |
图数据建模 |
顶点/边/属性设计、Schema 管理、标签体系 |
| 第 08 章 |
索引与性能优化 |
图索引类型、创建策略、查询计划分析 |
| 第 09 章 |
SQL 与图混合查询 |
SQL+Cypher 联合查询、视图、跨模型操作 |
第四部分：事务与性能
| 章节 |
标题 |
内容概要 |
| 第 10 章 |
事务与并发控制 |
ACID 特性、隔离级别、锁机制、死锁处理 |
| 第 11 章 |
性能调优 |
查询优化器、内存管理、配置参数、基准测试 |
第五部分：部署与集成
| 章节 |
标题 |
内容概要 |
| 第 12 章 |
Docker 与容器化部署 |
Dockerfile 编写、Docker Compose 编排、生产级部署 |
| 第 13 章 |
客户端开发 |
Python/Java/JavaScript 驱动、连接池、最佳实践 |
第六部分：运维与进阶
| 章节 |
标题 |
内容概要 |
| 第 14 章 |
故障排查与常见问题 |
错误诊断、日志分析、性能瓶颈定位 |
| 第 15 章 |
最佳实践与规范 |
图建模规范、生产部署清单、团队协作指南 |
阅读建议
- 零基础读者：按顺序从第 01 章读到第 06 章，掌握核心概念和查询语言
- 有 PostgreSQL 经验：重点阅读第 03、07、09 章，理解图与关系的融合
- 有图数据库经验（Neo4j 等）：快速浏览第 01-03 章，重点阅读第 06、09、11 章
- 生产部署需求：重点关注第 10-12、14-15 章
环境要求
本教程中的代码示例基于以下环境：
| 组件 |
版本 |
| AgensGraph |
2.13+ |
| Docker |
24.0+ |
| Docker Compose |
2.20+ |
| Python |
3.9+ |
| Java |
11+ |
| Node.js |
18+ |
扩展阅读