实例管理

如前所述,Desktop 中的实例代表一个 DBMS,即一个包含最基础的 system 数据库和默认用户数据库的 Neo4j 服务器安装。

创建实例

首次打开 Desktop 时,可以使用屏幕中间的创建实例(Create instance)按钮向本地环境添加新实例。如果您已经拥有一个实例并想要创建另一个,该按钮则位于右上角。

create instance
图 1. 创建新实例

您需要为实例命名并选择 Neo4j 版本。Desktop 2.1 支持 DBMS 5.1 及更高版本,默认选择最新版本。请注意,如果您选择除默认版本之外的任何版本,Desktop 需要下载资源,因此您必须连接到互联网。

您还需要创建一个数据库用户名和密码。这些凭据适用于该实例内的所有数据库。

设置好详细信息后,单击 创建(Create) 按钮即可完成。您的新 DBMS 很快就会显示出来,并可立即启动。请注意,新创建的实例在首次启动前会标记为新(New)

new instance
图 2. 运行中的实例

从备份创建

此外,您可以从现有的 .backup.dump.tar 文件创建新实例。步骤与上述相同,但您需要选择一个文件加载到新实例中。备份文件将加载到用户数据库 neo4j 中。系统会自动创建一个 system 数据库。版本兼容性与创建空实例时相同;同样地,如果您的备份版本不是默认版本,则需要连接到互联网。

启动/停止/重启实例

在 Desktop 中,您一次只能运行一个实例。使用播放/停止按钮来启动/停止实例,或使用重启按钮来重启正在运行的实例。如果您启动一个实例,任何已运行的实例都会自动停止。某些操作(例如加载和导出数据库)要求实例处于停止状态。

instance actions
图 3. 实例操作

Desktop 实例仅在应用程序运行时才能运行。如果您在有本地实例运行的情况下退出应用程序,系统会弹出警告,提示您停止实例或取消操作。

您可以在设置(Settings)抽屉中关闭此警告。

连接工具

实例卡片上的连接(Connect)下拉菜单允许您直接连接到查询(Query)探索(Explore)仪表板(Dashboards)工具。这些工具一次只能连接到一个数据库,并会自动选择默认数据库。您可以在工具内部切换数据库和实例。有关内置工具的更多信息,请参阅 查询探索仪表板

管理实例

实例管理菜单 […​] 允许您执行多项操作:

  • 概览(Overview) - 查看实例详细信息,如连接 URI、版本和 ID。

  • 插件(Plugins) - 安装一个或多个插件。

  • 升级(Upgrade) - 将实例升级到更高版本的 Neo4j。

  • 部署到 Aura(Deploy to Aura) - 将数据库部署到 Neo4j Aura。请参阅 部署到 Aura

  • 从文件加载数据库(Load database from file) - 直接加载您的 .dump.tar.backup 文件。请参阅 加载数据库

  • 导出数据库(Export databases) - 将实例中的数据库导出为 .dump 文件。请参阅 导出数据库

  • 打开(Open) - 用于访问以下内容的下拉菜单:

    • 实例文件夹(Instance folder) - 查看您的实例及其相关的文件夹和文件。

    • neo4j.log - 在新窗口中查看日志文件。

    • neo4j.conf - 使用您自己的编辑器/IDE 打开并配置 neo4j.conf 文件。

  • 克隆(Clone) - 制作实例的副本。

  • 删除(Delete) - 删除实例及其包含的数据库。

重命名实例

打开实例管理菜单后,您可以将鼠标悬停在实例名称上进行重命名。使用铅笔图标编辑名称。

rename instance
图 4. 重命名实例

升级实例

您可以直接在 Desktop 中将本地实例升级到更高版本的 Neo4j(注:远程实例无法执行此操作)。执行此操作时,需升级的实例必须处于停止(stopped)状态。

在实例管理菜单中,选择升级(Upgrade)并选择要升级到的版本。请注意,无法降级。如果升级因故失败,系统会自动对实例进行备份,并提供升级专用日志。

upgrade process
图 5. 升级进度

升级成功完成后,您可以启动该实例。

安装插件

插件是可以为 DBMS 启用的附加功能。在最新版本的 Neo4j Desktop 中,您可以为本地实例安装以下插件:

  • APOC - 一个用户自定义过程和函数库,有助于处理数据集成、图算法或数据转换等方面的多种任务。

  • Bloom - Bloom Enterprise 插件提供一些额外功能(例如用于协作的特性,如持久存储和共享功能),但它需要有效的许可证密钥。请联系您的 Neo4j 代表注册许可证。所有其他 Bloom 功能均可在“探索”工具中使用,无需插件。

  • 生成式 AI 集成(Gen AI integrations) - 一个生成式 AI 插件,支持在数据中创建向量嵌入,以便与向量索引和向量函数结合使用。

  • GDS 库 - Neo4j 常用的图算法。

克隆实例

使用克隆(Clone)选项制作实例副本。要克隆的实例必须处于停止(stopped)状态,并且您需要为副本提供唯一的名称。如果 Desktop 中已存在同名实例,则操作会失败。克隆完成后,新副本将与您的其他实例一起列出。

您还可以克隆 Desktop 1.x 安装中的实例,以便在 Desktop 2.x 中访问它们。更多信息,请参阅 从 Desktop 1.x 克隆实例

同时运行多个实例

如前所述,Desktop 中一次只能有一个正在运行的实例,并且您只能连接到一个正在运行的实例。但是,只要只有一个实例是本地的,就可以连接到多个实例。换句话说,您可以同时连接到一个本地实例和多个远程实例。为了同时与多个实例中的数据库交互,您需要同时打开多个 Desktop 窗口。这使您无需停止和启动实例即可查询和探索多个数据库中的数据。要打开新窗口,请前往“文件(File)”或“Neo4j Desktop 2”菜单栏选项并选择“新建窗口(New window)”。请记住,每个实例一次只能与一个数据库交互。

数据路径

在实例卡片上,除了 ID、Neo4j 版本和连接 URI 外,还列出了实例的数据路径。您可以直接从实例卡片打开该路径。默认位置是用户配置文件夹或主目录。如 自定义数据路径 中所述,可以使用环境变量 NEO4J_DESKTOP_DATA_PATH 将其设置为自定义位置。

Desktop 端口冲突

如果您运行有早期版本的 Desktop(例如 Desktop 1.6)中的任何 DBMS,则无法在 Desktop 2 中启动任何实例。这是由端口冲突引起的,您必须先停止本地运行的所有 DBMS,才能在 Desktop 2 中启动实例。同时运行多个实例/DBMS 的唯一方法是执行上述 同时运行多个实例 中的操作。