1. 登录界面
打开软件后,首先进入登录界面,如下图所示:
使用手机微信扫描二维码,如图:
在阅读并同意【隐私协议】及【服务条款】后点击【确定】即可登录。
2. 【文件夹】界面(主界面)
登录成功后,进入星影图数据库客户端界面,如下图所示:
当前界面默认将产生的本地存储文件放置于计算机中默认的个人账户文件夹下,并将该文件夹做为项目的工作区,存放用户产生的数据库查询代码,具体路径因操作系统而异。
2.1. 打开文件夹
点击【文件】->【打开文件夹】,然后在系统弹出的文件夹选择对话框中选择新的工作区即可添加新的工作区。
2.2. 切换或移除文件夹
- 切换文件夹:点击【文件】->【最近打开】,选择最近打开的文件夹即可切换到该文件夹。
- 移除文件夹:点击【文件】->【最近打开】,点击【X】即可将该行所指向的文件夹快捷入口从【最近打开】列表中移除,但不会删除文件夹。
3. 数据源连接操作界面
3.1. 添加连接
当默认文件夹或者用户打开的文件夹中,尚为添加过数据库连接,可以在界面左侧单击【添加连接】,或从【文件】->【添加连接】,添加连接所需的表单如下:
- 添加成功后,数据库将会出现在左侧列表中;
- 点击数据库名称左侧的箭头,可以展开图数据库的图空间;
- 数据库名称右键,可以对该数据库进行操作。
如下图所示:
3.2. 编辑
在上图右键弹出的菜单中,点击【编辑】,可以修改数据库连接的信息。功能与【添加连接】相同。
3.3. 删除
在上图右键弹出的菜单中,点击【删除】,可以将数据库的连接从工作区中删除,但不影响远程数据库的数据。
4. 数据库的Schema操作
4.1. 刷新
在数据库名称右键弹出的菜单中,点击【刷新】,可以同步数据库的Schema信息,包括图空间、标签、关系类型等。 点击数据库名称左侧的箭头展开或收缩具有同等效果。
4.2. 创建图空间
在数据库名称右键弹出的菜单中,点击【创建图空间】,可以创建一个新的图空间。 如图所示:
4.3. 刷新图空间下的Schema
右键图空间名称,弹出操作菜单,如下图:
刷新功能描述同3.4.1。
4.4. 复制图空间的Schema
在图空间名称右键弹出的菜单中,点击【复制】,在弹出的表单中,输入新空间的名称,即可在数据库中完成当前图空间的Schema复制,包括图空间的相关配置、标签表结构、关系表结构等。
4.5. 清除图空间的数据
在图空间名称右键弹出的菜单中,点击【清除数据】,在弹出的表单中,输入当前空间的名称进行二次确认,点击保存,即可完成图空间数据的清除,保留原有表结构。
4.6. 删除图空间
在图空间名称右键弹出的菜单中,点击【删除】,在弹出的表单中,输入当前空间的名称进行二次确认,点击保存,即可完成图空间的删除,不保留任何数据与表结构。
4.7. 创建标签、关系
在【标签】或【关系】名称右键弹出的菜单中,点击【创建】,在弹出的表单中,输入标签或关系的名称,并按需要点击【添加属性】为标签或关系添加字段,点击保存即可完成标签或关系的创建。
4.8. 编辑标签、关系
在【标签】或【关系】下的子项(如下图中的【new_tag】)右键弹出的菜单中,点击【编辑】,在弹出的表单中,可以对字段进行添加、类型修改、默认值修改或删除等操作。
4.9. 删除标签、关系
在【标签】或【关系】下的子项右键弹出的菜单中,点击【删除】,在弹出的表单中,输入当前标签或关系的名称进行二次确认,点击保存,即可完成标签或关系的删除。
4.10. 预览标签或关系的数据
点击在【标签】或【关系】下的子项,在主操作区域中呈现数据预览的表格,如下图所示:
4.11. 创建索引
点击上图主操作区中的【索引】,弹出索引操作界面,并在弹窗中点击添加索引( 可按需要将待加入索引的字段拖拽至指定区域。 ),如下图所示:
单击保存图标,完成索引创建。
提示
一般索引的创建应该放在数据导入之后,此处只是为了演示索引的创建过程。
4.12. 重建、删除索引
在上图中,点击刷新或删除图标,即可完成索引的重建或删除。 点击【关闭】,关闭索引操作界面。
5. 数据操作
5.1. 添加数据
在3.4.10中的数据预览界面中,点击【添加数据】,在弹出的表单中,输入数据的字段值,点击【保存】即可完成数据的添加。
5.2. 查看数据
当添加数据完成后,表格自动刷新,显示最新的数据。在数据表格中的【行号】列,对需要查看的数据行号右键,弹出操作菜单,点击【查看】,即可查看该行数据的详细信息。当前功能主要针对大字段的数据查看。
5.3. 编辑数据
在数据表格中的【行号】列,对需要编辑的数据行号右键,弹出操作菜单,点击【编辑】,在弹出的表单中,修改数据的字段值,点击【保存】即可完成数据的编辑。
5.4. 复制数据
在数据表格中的【行号】列,对需要复制的数据行号右键,弹出操作菜单,点击【复制】,在弹出的表单中,输入新数据的id,并修改与预期不符的字段值,点击【保存】即可完成数据的复制。
5.5. 删除数据
在数据表格中的【行号】列,对需要删除的数据行号右键,弹出操作菜单,点击【删除】,弹出数据预览界面,点击【删除】即可完成数据的删除。当删除的对象是节点时,可勾选【WITH EDGE】决定是否同时删除与之相关的关系。
5.6. 导入数据
先准备好待导入数据文件 data_imp.csv,如下图所示:
点击数据表格上方的【导入】,弹出数据导入文件选择界面,如下图所示:
双击【data_imp.csv】,或点击选中文件,并点击打开,待文件读取完成后,弹出数据导入界面,如下图所示:
可以将文件中的字段拖拽至右侧的目标字段区域,完成字段的映射,同时,可以按需对主键值追加前后缀,以避免与其他数据产生冲突。另外,导入使用了分批处理的方式,当数据量大时,默认以【5000】为一个批次导入到数据库,如果CSV的字段数较多,可以将单批数量按情况改小,执行点击【导入】即可完成数据的导入。
导入完成后,点击【刷新】,即可查看导入的数据。
5.7. 根据数据文件创建表结构
当发现数据文件中的字段与当前表结构不符时,可以通过点击【创建标签】的方式(如果单选框中选中的是【关系】,则点击【创建关系】),默认以CSV文件表头为属性名,创建属性列表,可根据实际需要对属性列表进行修改,如下图所示:
可参考 3.4.7. 创建标签、关系
创建完成后,可点击【new_tag】弹出下拉框,选中新建的标签【测试标签】,并根据3.5.6中字段映射的方式,将数据导入到新建的标签中。
当下拉框中尚未出现新建的【测试标签】,可点击刷新图标,刷新标签下拉框。
5.8. 数据过滤
在数据表格表头与数据之间的搜索框中,输入过滤条件,即可完成数据的过滤,必要时请参考3.4.12对索引进行重建。
6. 执行脚本管理
在左侧导航树的图空间名称子项中找到【查询】,右键弹出操作菜单,如下图:
6.1 添加分组
点击【添加分组】,在弹出的表单中,输入分组的名称,点击【保存】即可完成分组的添加。
6.2 删除分组
对分组右键,点击【删除】,即可完成分组的删除,如图:
6.3 添加脚本
在【查询】或分组名称右键弹出的菜单中,点击【添加】,在弹出的表单中,输入脚本的名称,点击【保存】即可完成脚本的添加。
7. 脚本的编辑与执行
7.1. 编辑脚本
保存完之后,自动打开脚本编辑界面,如下图所示:
7.2. 运行脚本与结果查看
在脚本编辑界面中,可以输入nGQL脚本,点击【运行】,即可完成脚本的执行。
可以点击【美化代码】,对脚本进行格式化。 可以点击图可视化的图标,对脚本的查询结果进行可视化展示。如下图:
当执行脚本进行查询时,如果【执行计划】处于勾选的状态,还可以点击下方执行计划的图标,查看当前脚本执行过程中所对应的执行计划,如下图:
此外,还可以将结果标签切换至【日志】,对脚本的执行情况进行查看,如图:
8. 脚本参数的使用
8.1 添加参数
在脚本编辑界面中,可以将脚本当成模板,并在右侧参数区添加对应参数,如下图所示:
点击【运行】,即可完成脚本的执行。
8.2 参数分组
另外,还可以添加参数分组,在不同组的切换中,激活不同的参数,从而达到不重新编辑,即可使用不同参数进行查询的效果。如下图所示:
8.3 删除参数
点击更多操作图标,弹出如下图所示的操作菜单,点击【删除当前参数】,即可删除参数分组(或单个参数)。如图:
9. 设置
点击设置图标,即可进入设置界面,如下图所示:
9.1. 主题设置
可以选择【浅色】或【深色】主题,同样可以选择不同的颜色做为主题色。
9.2. 语言设置
可以选择【English】【简体中文】或【繁体中文】作为软件的显示语言。
9.3. 效果
以【浅色】主题,红色主题色,语言使用【English】为例,选中完成后,效果如下:
点击返回图标,返回主界面。效果如下:
10. 反馈问题
10.1. 问题列表
点击最右侧的问题清单图标,即可进入问题反馈界面,如下图所示:
10.2. 查看问题详情
点击问题反馈列表中的问题,即可查看问题的详情,并可在下方表单中,对问题进行讨论,如下图所示:
10.3. 添加问题
点击问题反馈列表右上角+号,即可添加问题,如下图所示:
11. 提出建议
点击最右侧的建议图标,即可进入建议反馈界面,功能与3.10.问题反馈类似。
12. 窗口置顶
点击窗口右上角的图钉图标,即可将窗口置顶。
13. 退出软件
点击窗口右上角的关闭图标,或【文件】->【退出】,弹出退出确认框,点击【是】即可退出软件,点击【否】则取消退出操作。如图: