Neo4j使用记录--APOC和GDS的安装【实践】

APOC插件

APOC简介

APOC即Awesome Procedures on Cypher ，是 Neo4j 最大和最广泛使用的扩展库，是Neo4j过程和函数的标准实用程序库。它包括 450 多个标准程序，提供实用程序、转换、图形更新等功能。它们得到很好的支持，并且很容易作为单独的函数运行或包含在 Cypher 查询中。

注意事项

由于 APOC 依赖于 Neo4j 的内部 API，因此您需要为 Neo4j 安装使用匹配的 APOC 版本。确保前两个版本号在 Neo4j 和 APOC 之间匹配。除此之外，还得兼顾GDS版本号（如果你安装GDS插件库的话）
以下是APOC和Neo4j版本匹配表

apoc version	neo4j version
4.4.0.1	4.4.0 (4.3.x)
4.3.0.4	4.3.7 (4.3.x)
4.2.0.9	4.2.11 (4.2.x)
4.1.0.10	4.1.11 (4.1.x)
4.0.0.18	4.0.12 (4.0.x)
3.5.0.15	3.5.30 (3.5.x)
3.4.0.8	3.4.18 (3.4.x)
3.3.0.4	3.3.9 (3.3.x)
3.2.3.6	3.2.14 (3.2.x)
3.1.3.9	3.1.9 (3.1.x)
3.0.8.6	3.0.12 (3.0.x)
3.5.0.0	3.5.0-beta01
3.4.0.2	3.4.5
3.3.0.3	3.3.5
3.2.3.5	3.2.3
3.1.3.8	3.1.5

安装流程

1. 下载二进制 jar 并将其放到本地文件夹/plugins下

2. 将以下内容添加到$NEO4J_HOME/conf/neo4j.conf文件中：

   (出于安全原因，默认情况下Neo4j禁用使用内部 API 。它们可以通过在$NEO4J_HOME/conf/neo4j.conf指定配置来启用)

   dbms.security.procedures.unrestricted=apoc.*
   

3. 将apoc中一般要加载的过程和函数列入白名单 （允许运行的程序列表中）

   dbms.security.procedures.whitelist=apoc.coll.*,apoc.load.*
   

4. 重启Neo4j（不重启也行，哈哈哈），确认是否安装成功，如果返回APOC版本号，即为安装成功

   RETURN apoc.version() as version
   

---

GDS插件

GDS简介

GDS即Graph Data Science，Neo4j Graph Data Science 库包含大量算法。GDS有两个版本库：开源社区版本和企业版本。（下面安装是开源社区版本。）

GDS作为插件提供给 Neo4j 图形数据库。该插件需要安装到数据库中并添加到 Neo4j 配置中的允许列表中。

注意事项

应该为Neo4j 安装使用匹配的 GDS 版本，两者版本号需要进行匹配。（若安装APOC，需要考虑APOC版本）

GDS version	Neo4j version	Java Version
GDS 1.0.x	Neo4j 3.5.9 - 3.5.20	Java 1.8
GDS 1.1.x	Neo4j 3.5.9 - 3.5.33
GDS 1.2.x	Neo4j 4.0.0 – 4.0.6	Java 11
GDS 1.3.x	Neo4j 4.0.0 - 4.0.9
	Neo4j 4.1.0 - 4.1.5
GDS 1.4.x	Neo4j 4.0.0 - 4.0.11
	Neo4j 4.1.0 - 4.1.7
	Neo4j 4.2.0 - 4.2.3
GDS 1.5.x	Neo4j 4.0.0 - 4.0.11
	Neo4j 4.1.0 - 4.1.8
	Neo4j 4.2.0 - 4.2.5
GDS 1.6.x	Neo4j 4.0.0 - 4.0.12
	Neo4j 4.1.0 - 4.1.10
	Neo4j 4.2.0 - 4.2.15
	Neo4j 4.3.0 - 4.3.4
GDS 1.7.x	Neo4j 4.1.0 - 4.1.11
	Neo4j 4.2.0 - 4.2.15
	Neo4j 4.3.0 - 4.3.12
GDS 1.8.x	Neo4j 4.1.0 - 4.1.11
	Neo4j 4.2.0 - 4.2.18
	Neo4j 4.3.0 - 4.3.12
	Neo4j 4.4.0 - 4.4.5
GDS 2.0.x	Neo4j 4.3.0 - 4.3.14
	Neo4j 4.4.0 - 4.4.7
GDS 2.1.x	Neo4j 4.3.0 - 4.3.17
	Neo4j 4.4.0 - 4.4.10
GDS 2.2.x	Neo4j 4.3.0 - 4.3.17
	Neo4j 4.4.0 - 4.4.10

安装流程

1. neo4j-graph-data-science-[version].jar从Neo4j GDS所有版本下载中心下载相应版本并复制到$NEO4J_HOME/plugins目录中。（你下载的是zip压缩版本，需要解压出来，将后缀为jar的压缩文件放进）

2. 将以下内容添加到您的$NEO4J_HOME/conf/neo4j.conf文件中：

   dbms.security.procedures.unrestricted=gds.*
   

   此配置条目是必要的，因为 GDS 库访问 Neo4j 的低级组件以最大化性能。

3. 检查文件中是否启用了过程许可列表，$NEO4J_HOME/conf/neo4j.conf并在必要时添加 GDS 库：

   dbms.security.procedures.allowlist=gds.*
   

   之前Neo4j 4.2，配置设置被调用dbms.security.procedures.whitelist

4. 重启 Neo4j，确认是否安装成功，如果返回GDS版本号，即为安装成功

   RETURN gds.version() as version
   

   // 查看GDS所有基础信息
   CALL gds.debug.sysInfo() YIELD key, value
   

上面的安装流程中对$NEO4J_HOME/conf/neo4j.conf文件设置。只是针对单个插件的设置。如果你在community版本中既安装了APOC，又安装了GDS插件，你可以统一进行设置。

dbms.security.procedures.unrestricted=my.extensions.example,my.procedures.*,apoc.*,gds.*

dbms.security.procedures.allowlist=apoc.coll.*,apoc.load.*,gds.*,apoc.*

也可以进行配置其他参数：

# 启用将本地文件写入磁盘
apoc.export.file.enabled=true

# 启用从磁盘读取本地文件
apoc.import.file.enabled=true

---

总结

本文主要对Neo4j的两个插件APOC和GDS在community版本中的安装进行了简单介绍，算是一个基础篇。对Cypher语句的学习可以看我的另一篇文章Neo4j使用记录–基础篇(Cypher)【语法】
以上是我个人在学习过程中的记录所学，希望对正在一起学习的小伙伴有所帮助！！！
如果对你有帮助，希望你能一键三连【关注、点赞、收藏】！！！

参考链接

neo4j-contrib/neo4j-apoc-procedures: Awesome Procedures On Cypher for Neo4j - codenamed “apoc” (github.com)
Releases · neo4j-contrib/neo4j-apoc-procedures (github.com)
neo4j/graph-data-science: Source code for the Neo4j Graph Data Science library of graph algorithms. (github.com)