PostgreSQL中AgensGraph扩展未找到及Cypher查询失效问题求助

• AgensGraph扩展未正确安装：LOAD 'agensgraph'提示文件不存在、pg_extension无查询结果，说明扩展并未成功部署到PostgreSQL环境中，导致依赖的cypher()、ag_catalog.age_to_timestamp()等核心函数都无法被识别，这是所有报错的核心根源。
• timestamp()函数使用场景错误：PostgreSQL原生环境没有无参的timestamp()函数，你调用的是AgensGraph专属的时间戳函数，但因扩展未安装触发报错；即便扩展安装完成，该函数也仅能在AgensGraph的Cypher查询上下文内生效，不能直接在PostgreSQL原生查询中使用。

1. 正确安装并配置AgensGraph #

AgensGraph是基于特定版本PostgreSQL的扩展，必须保证版本匹配（例如AgensGraph 2.1对应PostgreSQL 13，具体版本对应关系需参考官方版本说明），步骤如下：

• 安装AgensGraph：
  • 包管理器安装（以Debian/Ubuntu为例）：

    sudo apt-get install agensgraph-13
    

  • 源码编译：下载对应版本源码，编译时指定PostgreSQL安装路径，完成后将扩展文件复制到PostgreSQL的extension目录。
• 启用AgensGraph支持：
  可以直接基于AgensGraph模板创建数据库：

  CREATE DATABASE my_graph_db WITH TEMPLATE = agens_template;
  

  或者在已有数据库中启用扩展：

  \c your_existing_db
  CREATE EXTENSION agensgraph;
  

• 验证安装结果：
  执行以下查询，若返回记录则安装成功：

  SELECT * FROM pg_extension WHERE extname = 'agensgraph';
  

2. 修正Cypher查询与函数使用 #

（1）修复关系创建查询 #

确保graph_name是你已创建的图（未创建则先执行CREATE GRAPH graph_name;），再执行查询：

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

（2）修复时间格式查询 #

AgensGraph的timestamp()返回毫秒级时间戳，需使用其提供的age_to_timestamp函数转换，正确查询如下：

SELECT * FROM cypher('graph_name', $$
     RETURN to_char(age_to_timestamp(timestamp()), 'Month DD, YYYY, HH:MI:SS')
$$) as (t agtype);

如果是在PostgreSQL原生查询中获取当前时间，替换为PostgreSQL原生函数：

-- PostgreSQL原生环境使用
SELECT to_char(current_timestamp, 'Month DD, YYYY, HH:MI:SS');

3. 解决timestamp()函数报错 #

• 若在AgensGraph的Cypher查询中使用：确保扩展已正确安装并加载，此时timestamp()是AgensGraph内置函数，可正常返回毫秒时间戳。
• 若在PostgreSQL原生查询中使用：替换为PostgreSQL支持的时间函数，比如current_timestamp、now()（返回事务开始时间）或clock_timestamp()（返回当前实时时间）。

内容的提问来源于stack exchange，提问作者MOIEZ IBRAR