|
本文档涉及 Neo4j Labs 旗下不受支持的 NeoDash 版本。如需使用受支持的 NeoDash 产品,请参阅 NeoDash 商业版。 |
仪表板 (Dashboards)
|
本文档涉及 Neo4j Labs 旗下不受支持的 NeoDash 版本。如需使用受支持的 NeoDash 产品,请参阅 NeoDash 商业版。 |
在 NeoDash 中,一个仪表板由若干页面组成,每个页面又可以包含多个报表。
例如:上图显示了一个包含三个页面的仪表板:Breweries(酿酒厂)、Beer Ratings(啤酒评分)和 Styles(风格)。窗口顶部显示了仪表板标题 My Beer Database Dashboard 🍺。
当前选中了第一页,其中包含三个报表:一个表格、一个图表和一张地图。每个报表都可以有自己的名称,并且使用且仅使用一个 Cypher 查询来填充数据。有关报表工作原理的更多信息,请参阅“报表”章节。
仪表板管理
启动 NeoDash 后,您将可以选择创建新仪表板或打开现有仪表板(如果有)。连接后,可以使用侧边栏上的按钮来保存、加载或共享仪表板。
保存仪表板
简单来说,NeoDash 仪表板就是一个 JSON 文件。例如,默认仪表板具有以下结构
{
"title": "",
"version": "2.0",
"settings": {
"pagenumber": 0,
"editable": true,
"fullscreenEnabled": true,
"parameters": {}
},
"pages": [
{
"title": "Main Page",
"reports": [
{
"title": "Hi there 👋",
"query": "**This is your first dashboard!** \n \nYou can click (⋮) to edit this report, or add a new report to get started. You can run any Cypher query directly from each report and render data in a variety of formats. \n \nTip: try _renaming_ this report by editing the title text. You can also edit the dashboard header at the top of the screen.\n\n\n",
"width": 3,
"type": "text",
"height": 3,
"selection": {},
"settings": {}
},
{
"title": "",
"query": "MATCH (n)-[e]->(m) RETURN n,e,m LIMIT 20\n\n\n",
"width": 3,
"type": "graph",
"height": 3,
"selection": {
"Movie": "title",
"Genre": "name"
},
"settings": {
"nodePositions": {}
}
}
]
}
]
}
打开保存对话框后,有三种保存仪表板的方式:
-
保存为文件。这会触发当前仪表板以
.json文件的形式下载。 -
保存到 Neo4j。这会将仪表板的字符串表示形式作为节点存储在数据库中。当使用 Neo4j 多数据库功能时,您可以选择将仪表板保存在哪个数据库中。
-
直接复制粘贴 JSON 内容。
请注意,您当前活动的仪表板存储在浏览器缓存中。如果您清除缓存(Cookie),仪表板内容将会丢失。
加载仪表板
与保存界面一样,可以通过以下三种方式之一加载仪表板:
-
从文件加载。这需要您在计算机上选择一个
.json文件。 -
从 Neo4j 加载。这需要您选择存储在数据库中的仪表板节点。从 Neo4j 加载时,您将看到按时间倒序排列的仪表板列表。
-
通过直接粘贴到编辑器中来加载 JSON 文件。
共享仪表板
可以通过生成直接链接来与其他用户共享仪表板。此链接将包含:
-
指向仪表板的链接(直接 URL 或 Neo4j 中的仪表板名称)。
-
(可选)仪表板所报告数据库的凭据。请注意,使用此功能时,共享链接将包含数据库凭据,这可能存在安全风险。
-
仪表板应以“编辑器模式”还是“独立模式”查看。后者将配置 NeoDash 在精简后的界面中运行,不启用任何编辑器功能。
在生产数据库上部署 NeoDash 时,不建议使用“共享”功能。建议改为设置独立的 NeoDash 部署。更多信息请参阅“发布”章节。
仪表板访问控制
利用此功能,您可以通过 Neo4j 原生的基于角色的访问控制 (RBAC) 功能来管理仪表板访问权限。在此窗口中,通过利用数据库中现有的标签或创建新标签,为当前选中的仪表板节点添加额外标签,从而规范访问权限。
您可以通过点击侧边栏仪表板名称旁边的三个点并选择“访问控制 (Access Control)”选项来找到此功能。
此方法应与分配给特定角色的标签受限权限结合使用。详情请参阅 访问控制管理。
仪表板设置
点击仪表板侧边栏中的 设置 ⚙️ (Settings) 按钮,即可访问整个仪表板的设置。
此窗口可用于控制以下设置:
| 名称 | 可更改 | 默认值 | 描述 |
|---|---|---|---|
可编辑 |
是 |
开启 |
如果启用,则以“编辑模式”显示仪表板。如果不启用,则以“视图模式”显示。在视图模式下,所有编辑功能将被禁用,页面和报表无法被移动、编辑或重命名。 |
启用报表全屏视图 |
是 |
开启 |
如果启用,报表右上角将显示 🔳 全屏 按钮,允许用户最大化可视化效果。 |
最大查询时间(秒) |
是 |
20 |
查询被自动取消前允许执行的最长时间。如果您有复杂的分析查询,请增加此时间。 |
禁用行数限制 |
是 |
关闭 |
如果启用,仪表板的自动 行数限制 功能将被禁用。 |
页面编号 |
否 |
0 |
当前查看的仪表板页面编号。此项只能通过仪表板标题栏中的切换页面功能进行更改。 |
全局参数 |
否 |
{} |
在仪表板中所有报表间共享的全局参数。有关全局参数的更多信息,请参阅下一节。 |
参数
仪表板参数是键值对,可以在报表的查询中使用。按照惯例,NeoDash 中的仪表板参数总是以 $neodash_ 开头。
参数只能通过 参数选择 (Parameter Select) 报表进行设置(和取消设置)。设置参数后,它将可用于仪表板中的所有报表。使用仪表板参数的查询如下所示:
MATCH (m:Movie)<-[a:ACTED_IN]-(p:Person) WHERE m.title = $neodash_movie_title RETURN m, a, p