apache/age

Apache AGE

什么是Apache AGE

Apache AGE是PostgreSQL的扩展，使用户能够在现有关系数据库之上利用图数据库功能。AGE是A Graph Extension的缩写，灵感来源于Bitnine的AgensGraph，这是一个基于PostgreSQL的多模型数据库分支。该项目的基本原理是创建一个单一存储，同时处理关系和图数据模型，使用户能够使用标准ANSI SQL以及openCypher（当今最流行的图查询语言之一）。

!Apache AGE架构

概述

Apache AGE具有以下特点：

• 强大：为流行的PostgreSQL数据库添加图数据库支持，PostgreSQL被Apple、Spotify和NASA等组织使用
• 灵活：允许执行openCypher查询，使复杂查询更易于编写，同时支持同时查询多个图
• 智能：支持图查询，是许多高级Web服务（如欺诈检测、主数据管理、产品推荐等）的基础

特性

• Cypher查询：支持图查询语言
• 混合查询：支持SQL和/或Cypher
• 多图查询：支持查询多个图
• 层级结构：图标签组织
• 属性索引：支持顶点（节点）和边的索引
• 完整PostgreSQL支持：支持所有PostgreSQL功能

文档

请参考最新的Apache AGE文档了解安装、特性、内置函数和Cypher查询。

预安装要求

根据不同操作系统安装以下必要库。从源代码构建AGE依赖于以下Linux库：

CentOS

bash
yum install gcc glibc glib-common readline readline-devel zlib zlib-devel flex bison

Fedora

bash
dnf install gcc glibc bison flex readline readline-devel zlib zlib-devel

Ubuntu

bash
sudo apt-get install build-essential libreadline-dev zlib1g-dev flex bison

安装

Apache AGE旨在易于安装和运行。可通过Docker和其他传统方式安装。

安装PostgreSQL

需要安装与AGE兼容的Postgres版本，目前AGE支持Postgres 11、12、13、14、15、16和17。

通过包管理器安装

bash
sudo apt install postgresql

使用Docker安装

获取Docker镜像

bash
docker pull apache/age

创建AGE Docker容器

bash
docker run \
    --name age  \
    -p 5455:5432 \
    -e POSTGRES_USER=postgresUser \
    -e POSTGRES_PASSWORD=postgresPW \
    -e POSTGRES_DB=postgresDB \
    -d \
    apache/age

进入PostgreSQL的psql

bash
docker exec -it age psql -d postgresDB -U postgresUser

安装后配置

对于每个AGE连接，需要加载AGE扩展：

bash
CREATE EXTENSION age;
LOAD 'age';
SET search_path = ag_catalog, "$user", public;

快速入门

创建图

bash
SELECT create_graph('graph_name');

创建顶点（节点）

bash
SELECT * 
FROM cypher('graph_name', $
    CREATE (:label {property:"Node A"})
$) as (v agtype);

SELECT * 
FROM cypher('graph_name', $
    CREATE (:label {property:"Node B"})
$) as (v agtype);

创建边

bash
SELECT * 
FROM cypher('graph_name', $
    MATCH (a:label), (b:label)
    WHERE a.property = 'Node A' AND b.property = 'Node B'
    CREATE (a)-[e:RELTYPE {property:a.property + '<->' + b.property}]->(b)
    RETURN e
$) as (e agtype);

查询连接的节点

bash
SELECT * from cypher('graph_name', $
        MATCH (V)-[R]-(V2)
        RETURN V,R,V2
$) as (V agtype, R agtype, V2 agtype);

语言特定驱动

Apache AGE支持多种编程语言驱动：

内置驱动

• Go驱动
• Java驱动
• NodeJs驱动
• Python驱动

社区驱动

• Apache AGE Rust驱动
• Apache AGE .NET驱动

图形可视化工具

Apache AGE Viewer是Apache AGE的用户界面，提供数据可视化和探索功能。这个Web可视化工具允许用户输入复杂的图查询，并以图形和表格形式探索结果。

社区贡献

您可以通过向https://github.com/apache/age%E5%8F%91%E9%80%81%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E6%9D%A5%E6%94%B9%E8%BF%9B%E6%AD%A3%E5%9C%A8%E8%BF%9B%E8%A1%8C%E7%9A%84%E5%B7%A5%E4%BD%9C%E6%88%96%E5%90%AF%E5%8A%A8%E6%96%B0%E5%B7%A5%E4%BD%9C%E3%80%82%E6%9C%89%E5%85%B3%E4%BB%A3%E7%A0%81%E5%AE%A1%E6%9F%A5%E6%B5%81%E7%A8%8B%E3%80%81%E5%A6%82%E4%BD%95%E5%90%88%E5%B9%B6%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E4%BB%A5%E5%8F%8A%E4%BB%A3%E7%A0%81%E9%A3%8E%E6%A0%BC%E5%90%88%E8%A7%84%E6%80%A7%E5%88%B0%E6%96%87%E6%A1%A3%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E8%AE%BF%E9%97%AEApache AGE官方网站 - 开发者指南。