强曰为道

与天地相似，故不违。知周乎万物，而道济天下，故不过。旁行而不流，乐天知命，故不忧.
文档目录

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 章

环境要求

本教程中的代码示例基于以下环境：

组件版本
AgensGraph2.13+
Docker24.0+
Docker Compose2.20+
Python3.9+
Java11+
Node.js18+

扩展阅读