实例管理
如前所述,Desktop 中的实例代表一个 DBMS,即一个包含最基础的 system 数据库和默认用户数据库的 Neo4j 服务器安装。
创建实例
首次打开 Desktop 时,可以使用屏幕中间的创建实例(Create instance)按钮向本地环境添加新实例。如果您已经拥有一个实例并想要创建另一个,该按钮则位于右上角。
您需要为实例命名并选择 Neo4j 版本。Desktop 2.1 支持 DBMS 5.1 及更高版本,默认选择最新版本。请注意,如果您选择除默认版本之外的任何版本,Desktop 需要下载资源,因此您必须连接到互联网。
您还需要创建一个数据库用户名和密码。这些凭据适用于该实例内的所有数据库。
设置好详细信息后,单击 创建(Create) 按钮即可完成。您的新 DBMS 很快就会显示出来,并可立即启动。请注意,新创建的实例在首次启动前会标记为新(New)。
启动/停止/重启实例
在 Desktop 中,您一次只能运行一个实例。使用播放/停止按钮来启动/停止实例,或使用重启按钮来重启正在运行的实例。如果您启动一个实例,任何已运行的实例都会自动停止。某些操作(例如加载和导出数据库)要求实例处于停止状态。
Desktop 实例仅在应用程序运行时才能运行。如果您在有本地实例运行的情况下退出应用程序,系统会弹出警告,提示您停止实例或取消操作。
您可以在设置(Settings)抽屉中关闭此警告。
管理实例
实例管理菜单 […] 允许您执行多项操作:
-
概览(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) - 删除实例及其包含的数据库。
升级实例
您可以直接在 Desktop 中将本地实例升级到更高版本的 Neo4j(注:远程实例无法执行此操作)。执行此操作时,需升级的实例必须处于停止(stopped)状态。
在实例管理菜单中,选择升级(Upgrade)并选择要升级到的版本。请注意,无法降级。如果升级因故失败,系统会自动对实例进行备份,并提供升级专用日志。
升级成功完成后,您可以启动该实例。
安装插件
插件是可以为 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 的唯一方法是执行上述 同时运行多个实例 中的操作。