视觉导览

本节将带您了解 Neo4j Browser 的用户界面。

概述

browser ui
图 1. 浏览器界面概览

连接栏

连接栏包含三个下拉菜单:连接 (connection) 下拉菜单、数据库选择器 (database selector)用户信息 (user information)

连接下拉菜单 中,您可以查看连接状态、数据库版本和连接详情。此外,您还可以切换实例或断开当前实例的连接。

connection dropdown
图 2. 连接下拉菜单

数据库选择器 允许您在当前连接的实例中的各个数据库之间切换。您还可以查看每个数据库默认使用的 Cypher® 版本。

用户信息 下拉菜单显示与当前用户关联的角色,并提供更改数据库密码的选项。

侧边栏

侧边栏包含一组抽屉式菜单,用于设置图形管理环境并探索您的数据。

数据库信息

此抽屉包含有关您所连接数据库的信息。

db information
图 3. 数据库信息抽屉

它为您提供了节点标签 (node labels)关系类型 (relationship types) 的概览,以及数据库中存在的属性键 (property keys)。如果您选择其中一项,将会以图形或表格形式查看该选定元素的示例。

已保存的 Cypher

已保存的 Cypher 抽屉用于存放您收藏的 Cypher 查询和命令。它包含以下选项:添加文件夹以帮助组织已保存的查询、将选定查询保存到您的下载 (Downloads) 文件夹、上传查询以及删除选定项。所有查询和文件夹都可以轻松地向上或向下拖动,以按您喜欢的顺序排列。

saved cypher
图 4. 已保存的 Cypher

保存查询

您可以使用结果框架中的书签图标、编辑器中的 […​] 菜单,或者通过 cmd+S/ctrl+S (macOS/Windows 或 Linux) 快捷键来保存 Cypher 查询和命令。您可以创建新文件夹或将查询分类存放到现有文件夹中。

运行已保存的查询

要从“已保存的 Cypher”抽屉中运行查询,只需将鼠标悬停在其上方,然后使用播放按钮直接在编辑器中运行它。如果点击该查询,它将被填充到编辑器中,您可以先进行编辑,然后再执行。

历史记录

历史记录抽屉会跟踪您执行过的所有查询,不受数据库限制。查询存储在浏览器的本地存储中,并保留在那里,直到达到历史记录限制或您清除本地存储为止。您可以在设置抽屉中设置历史记录限制。您还可以手动删除它们,既可以删除全部,也可以选择性删除。

历史记录中的查询也可以保存到您的下载文件夹中,既可以单独选择,也可以全部保存。

通过点击历史记录中的查询,可以将它们填充到编辑器中进行编辑并执行。

Cypher 参考

Cypher 参考是 Cypher 速查表 的嵌入式版本。它允许您直接在浏览器中搜索与 Cypher 相关的术语,如查询、模式和子句。它分为多个章节和小节,便于导航,每个小节都可以展开或折叠。

cypher reference
图 5. Cypher 参考

您可以选择一个示例以在编辑器中运行它,或将其复制到剪贴板。请注意,某些示例需要您的数据库中可能不存在的数据,因此可能无法运行或无法产生预期结果,但它们用于演示 Cypher 的语法和功能。

许多小节还包含指向 Cypher 手册 的链接,以获取更多详细信息。

参数

参数抽屉允许您设置在查询中使用的参数。这也可以通过使用 :param 命令来实现。有关使用参数的更多信息,请参阅 查询参数

parameter drawer
图 6. 参数

设置

设置 抽屉包含应用程序的各种可调整选项。

抽屉的第一部分包含与应用程序性能相关的设置。可视化节点限制 (Visualization node limit) 控制初始查询返回的节点数。如果查询结果超过此限制,您仍然可以向图形可视化中添加更多元素。将任何限制设置得过高可能会降低性能。

本地存储 (local storage) 部分允许您保存参数以在不同会话中使用。

抽屉的下一部分是针对 Cypher 编辑器 的。您可以通过 访问模式 (Access mode) 设置来控制查询是否可以向数据库写入数据。

此设置主要用于集群环境中的负载均衡/路由,并非旨在替代 RBAC 来限制访问权限。

要了解有关自定义负载均衡的更多信息,请参阅 Neo4j 驱动程序文档,特别是关于 运行您自己的事务/请求路由 (Run your own transactions/Request routing) 的章节,该文档适用于 JavaScript 驱动程序Java 驱动程序Python 驱动程序Go 驱动程序

错误和警告切换开关用于启用提示,帮助您查找 Cypher 查询中的错误。

该抽屉还包含常规和隐私设置。

此外,您还可以从此抽屉更改主题,包括亮色、暗色或系统默认。

settings drawer
图 7. 设置抽屉

Cypher 编辑器

Cypher 编辑器是输入和运行 Cypher 查询与命令的主要界面。编辑器可以多次实例化,这允许您在结果框架内编辑查询并重新运行它。

语法高亮

  • 智能高亮显示当前光标位置周围的匹配对,例如匹配的括号、大括号和圆括号。

  • 匹配对会自动闭合。

  • 点击单词时,智能高亮显示相同的单词。

  • 单词(如属性、匿名名称和值)会以不同的颜色高亮显示。

  • 任何标点符号(如圆括号和逗号)的颜色与文本略有不同。

  • 警告会以红色波浪线显示,悬停时会显示错误信息。

表 1. 常用快捷键
描述 键盘快捷键 (Mac OS) 键盘快捷键 (Windows 和 Linux)

逐个选择高亮显示的相同单词。

Cmd + D

Ctrl + D

向上或向下移动一行查询。

option + 箭头键

ALT + 箭头键

删除一行查询。

Cmd + shift + K

Ctrl + shift + K

如果您想同时添加多行,请使用多重光标。

option + 点击 + 拖拽

ALT + 点击 + 拖拽

搜索并替换。

Cmd + F

Ctrl + F

运行查询。

Cmd + Enter

Ctrl + Enter

切换全屏编辑器

Cmd + E

Ctrl + E

历史记录搜索

Cmd + R

Ctrl + R

保存 Cypher

Cmd + S

Ctrl + S

格式化 Cypher

option + shift + F

Ctrl + shift + F

查询中任何位置的黄色波浪线表示警告。这通常是由查询尝试匹配图中不存在的模式引起的,但也可能由多种原因引起(请参阅 所有通知代码列表)。将鼠标悬停在带下划线的段落上即可查看解释。

可复用的结果框架

Neo4j Browser 的可复用结果框架允许您直接在结果框架中编辑现有查询,并重新运行它以更新当前的结果。

您还可以使用 Cmd/Ctrl + 点击 将其发送回主编辑器并从那里重新运行。

每个可复用框架都维护自己的本地命令历史,并在您需要从那里实例化新的结果框架时更新 Cypher 编辑器中的主历史记录。

结果框架视图

Neo4j Browser 支持不同的结果框架视图以满足您的需求:

  • 图形 (Graph) — 将结果显示为节点和关系,并允许配置样式

  • 表格 (Table) — 将结果显示为 JSON 格式的行。

  • 原始数据 (Raw) — 显示提交的请求、Neo4j 服务器版本和地址以及响应。

有关在 Neo4j Browser 中查看数据的不同方式的更多详细信息,请参阅 结果框架

流是结果框架的滚动序列。

screen stream
图 8. 结果框架流

每次执行命令都会创建一个可复用的结果框架,并添加到流的顶部,从而按逆时间顺序创建一个可滚动的集合。您可以使用 折叠 (Collapse) 图标展开和折叠结果框架。
要从流中移除所有框架,请使用 :clear 命令。