下面是 GDS 库与 Neo4j 的兼容性矩阵。一般来说，您可以依靠支持最新版本 Neo4j 的最新版 GDS，反之亦然，我们建议您始终升级到该组合。

我们只列出主要和次要版本的软件，例如 GDS 库 1.5。您应该将其视为该主要+次要版本的任何补丁版本，但同样，请始终升级到最新补丁，以确保您获得所有错误修复。

未找到列出的 GDS 或 Neo4j 版本？是时候升级了！

安装 GDS 库最方便的方法是通过名为 Neo4j Graph Data Science的Neo4j 桌面插件。该插件可以在数据库的“插件”选项卡中找到。

安装程序将下载 GDS 库并将其安装在数据库的“插件”目录中。它还会将以下条目添加到设置文件中：

dbms.security.procedures.unrestricted=gds.*

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

如果配置了程序白名单，请确保还包括 GDS 库中的程序：

dbms.security.procedures.whitelist=gds.*

GDS 库旨在用于独立的 Neo4j 服务器。

在独立的 Neo4j 服务器上，需要手动安装和配置库。

1. 下载neo4j-graph-data-science-[version].jar从Neo4j的下载中心，并将其复制到$NEO4J_HOME/plugins目录中。

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

   dbms.security.procedures.unrestricted=gds.*

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

3. 检查$NEO4J_HOME/conf/neo4j.conf文件中是否启用了程序白名单，并在必要时添加 GDS 库：

   dbms.security.procedures.whitelist=gds.*

4. 重启 Neo4j

3.1. 验证安装

RETURN gds.version()

CALL gds.list()

解锁 Neo4j Graph Data Science 库的企业版需要有效的许可证密钥。要注册许可证，请通过https://neo4j.com/contact-us/?ref=graph-analytics联系 Neo4j 。

许可证以许可证密钥文件的形式发放，需要放在Neo4j服务器可以访问的目录中。您可以通过gds.enterprise.license_file在neo4j.confNeo4j 安装的配置文件中设置选项来配置许可证密钥文件的位置。必须使用绝对路径指定位置。首次配置许可证密钥时以及每次更改许可证密钥时，例如添加新的许可证密钥或密钥文件的位置更改时，都需要重新启动数据库。

许可证密钥文件的示例配置：

gds.enterprise.license_file=/path/to/my/license/keyfile

如果该gds.enterprise.license_file设置设置为非空值，Neo4j Graph Data Science 库将验证许可证密钥文件是否可访问并包含有效的许可证密钥。配置有效的许可证密钥后，所有企业版功能都将解锁。如果出现问题，例如，当许可证密钥文件不可访问、许可证已过期或由于任何其他原因无效时，所有对 Neo4j 图形数据科学库的调用都将导致错误，说明许可证密钥有问题.

Neo4j Graph Data Science 库可用作 Docker 上 Neo4j 的插件。Docker 的插件指南可在操作手册中找到。

要运行具有可用 GDS 的 Neo4j 容器，您可以运行

docker run -it --rm \--publish=7474:7474 --publish=7687:7687 \--user="$(id -u):$(id -g)" \-e NEO4J_AUTH=none \--env NEO4JLABS_PLUGINS='["graph-data-science"]' \neo4j:4.2

Neo4j 因果集群由多台机器组成，这些机器共同支持一个高可用的数据库管理系统。GDS 库使用单台机器上的主内存来托管图形目录中的图形和基于这些的计算算法。这两种架构不兼容，不应结合使用。GDS 工作负载会在运行时尝试消耗机器的大部分系统资源，这可能会使机器长时间无响应。由于这些原因，我们强烈建议不要在集群中运行 GDS，因为这可能会导致数据损坏或集群中断。

要在 Neo4j 因果集群部署托管的图形上使用 GDS，这些图形应该与正在运行的集群分离。这可以通过多种方式实现，包括：

1. 转储 Neo4j 存储的快照并将其导入单独的独立 Neo4j 服务器中。

2. 将只读副本添加到 Neo4j 因果集群，然后将其分离以在与 Neo4j 因果集群分离的快照上安全地操作 GDS。

3. 将只读副本添加到 Neo4j 因果集群并为 GDS 工作负载配置它。请注意，由于只读副本的更新，内存图和底层数据库最终将变得不同步。由于 GDS 可以消耗所有可用资源，因此只读副本的响应速度可能会降低，并且其状态可能会落后于集群。在这种情况下使用 GDS 需要：

   • 在只读副本上安装 GDS

   • 使用 mutate 或流调用模式

   • 通过 Cypher 直接使用 GDS 工作负载的结果（请参阅实用程序函数）

   • 不使用 GDS 回写功能（写入会触发许多大型事务并可能终止集群）

在分离的机器上完成 GDS 工作负载后（对于案例 1. 和 2.），它现在包含从 Neo4j 因果集群写入其复制图版本的不同步结果。要将这些结果集成回集群，需要自定义程序。

为了使用 GDS 库的某些功能，需要额外的配置。在启动 DBMS 之前，在neo4j.conf配置文件中进行配置。以下功能需要此类额外配置：

7.1. 图导出

7.2. 模型持久化

8.1. 主存储器

图 1. GDS 堆内存使用情况

8.2. 中央处理器