Skip to content

Commit

Permalink
optimize explorer (#1789)
Browse files Browse the repository at this point in the history
* optimize explorer

* Update ex-ug-query-exploration.md
  • Loading branch information
cooper-lzy authored May 10, 2022
1 parent 51ebba2 commit 32c8f85
Show file tree
Hide file tree
Showing 6 changed files with 37 additions and 33 deletions.
2 changes: 1 addition & 1 deletion docs-2.0/nebula-explorer/10.create-schema.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 创建 Schema

在 Nebula Graph 中, 必须先有 Schema。Explorer 支持界面化或者通过控制台命令方式创建 Schema。
Explorer 支持界面化或者通过控制台命令方式创建 Schema。

在 Explorer 页面的右上方,单击![Schema_page](https://docs-cdn.nebula-graph.com.cn/figures/studio-nav-schema.png)进入 Schema 创建页面。

Expand Down
6 changes: 3 additions & 3 deletions docs-2.0/nebula-explorer/13.choose-graphspace.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,15 @@

## 操作步骤

连接 Explorer 后,系统首先会显示图空间选择页面,用户只需选择目标图空间即可。
登录 Explorer 后,系统首先会显示图空间选择页面,用户只需选择目标图空间即可。

![Create_graphspace](https://docs-cdn.nebula-graph.com.cn/figures/create-graphspace_cn.png)

如果用户在连接 Explorer 后未及时选择图空间,还可以通过以下方式选择图空间。
之后如果要再次选择图空间,可以通过以下方式:

1. 在 Explorer 页面左侧的导航栏中,单击图空间![graphSpace](https://docs-cdn.nebula-graph.com.cn/figures/nav-graphSpace.png)图标。
2. 选择目标图空间。

!!! note

用户可以多次选择相同或者不同的图空间,每次选择都会创建对应图空间的画布
用户可以多次选择相同或者不同的图空间,每次选择都会创建新的画布
2 changes: 1 addition & 1 deletion docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,6 @@

## 断开连接

在页面左侧工具栏中,选择设置![icon](https://docs-cdn.nebula-graph.com.cn/figures/nav-setup.png)图标 > 清空连接。
在页面右上角,选择![icon](https://docs-cdn.nebula-graph.com.cn/figures/image-icon10.png)图标 > 清空连接。

如果浏览器上显示**配置数据库**页面,表示 Explorer 已经成功断开了与 Nebula Graph 数据库的连接。
2 changes: 1 addition & 1 deletion docs-2.0/nebula-explorer/ex-ug-page-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Nebula Explorer 由顶部导航栏、左侧导航栏、和画布三大模块组
| ![snapshot](https://docs-cdn.nebula-graph.com.cn/figures/snapshot-history_cn.png) | 查看历史快照信息。更多信息,参见[画布快照](canvas-operations/canvas-snapshot.md)|
| ![graphSpace](https://docs-cdn.nebula-graph.com.cn/figures/nav-graphSpace_cn.png) | 查看所有图空间,单击图空间可创建相应图空间的画布。更多信息,参见[选择图空间](13.choose-graphspace.md)|
| ![Help](https://docs-cdn.nebula-graph.com.cn/figures/nav-help_cn.png) | 查看 Explorer 操作文档、论坛内容等。 |
| ![Setup](https://docs-cdn.nebula-graph.com.cn/figures/nav-setup2.png) | 查看用户名和快捷键、修改语言设置、限制返回结果数量、清除 Explorer 链接等|
| ![Setup](https://docs-cdn.nebula-graph.com.cn/figures/nav-setup2.png) | 查看用户名、版本、快捷键,限制查询最大返回数量|

## 画布

Expand Down
37 changes: 21 additions & 16 deletions docs-2.0/nebula-explorer/ex-ug-query-exploration.md
Original file line number Diff line number Diff line change
@@ -1,52 +1,57 @@
# 开始探索

!!! note
为了探索图数据,用户需要查询出一些初始数据,在这些初始数据的基础上,才能进一步的分析、过滤。本文介绍如何查询初始数据。

## 前提条件

使用查询功能前,需要选中并单击目标图空间。详情参见[选择图空间](13.choose-graphspace.md)。
已选择目标图空间。详情参见[选择图空间](13.choose-graphspace.md)

!!! compatibility "历史版本兼容性"

针对 3.0.0 以下版本的 Nebula Graph,需要创建索引后才可以使用查询功能。更多信息,参见[创建索引](../3.ngql-guide/14.native-index-statements/1.create-native-index.md)。

用户进行图数据的探索和分析前,首先需要在 Explorer 页面先单击**开始**图标![query](https://docs-cdn.nebula-graph.com.cn/figures/nav-query2_cn.png)然后查询目标数据。查询到的数据会显示在画布中。查询方式如下:
## 操作步骤

在 Explorer 页面左侧单击**开始**图标![query](https://docs-cdn.nebula-graph.com.cn/figures/nav-query2_cn.png)然后查询数据。查询到的数据会显示在画布中。查询方式如下:

- VID 查询
- Tag 查询
- 子图查询

## VID 查询
### VID 查询

用户可输入点的 ID(VID)查询目标点然后基于目标点进行探索和分析
用户可输入点的 ID(VID)查询目标点

支持手动输入、随机导入、文件导入 VID。

!!! note

- 输入或者导入的数据必须存在于图数据库中。
- 查询区域中每行仅支持填入一个 VID。
查询区域中每行仅支持填入一个 VID,用回车键分隔。

以下以图空间`basketballplayer`及相关数据为例演示如何查询数据。
下图以图空间`basketballplayer`及相关数据为例演示如何查询数据。

![VID QUERY](https://docs-cdn.nebula-graph.com.cn/figures/vid-query-22-04-06_cn.gif)

## Tag 查询
### Tag 查询

!!! note
用户可以选择 Tag 和对应索引查询目标点,还可以设置结果数量限制和筛选条件。

使用 **Tag 查询** 方式查询数据,确保对应的图空间中已存在相应的 Tag 和索引。更多信息,参见[创建 Tag](../3.ngql-guide/10.tag-statements/1.create-tag.md) 和[创建索引](../3.ngql-guide/14.native-index-statements/1.create-native-index.md)。
!!! note

用户可以对输出的结果进行数量上的限制和对结果进行过滤
请确保对应的图空间中已存在相应的 Tag 和索引,否则无法选择。详情参见[创建 Tag](../3.ngql-guide/10.tag-statements/1.create-tag.md) 和[创建索引](../3.ngql-guide/14.native-index-statements/1.create-native-index.md)

以下查询 10 个年龄大于 30 岁,且不等于 40 岁的球员
下图为查询 10 个年龄大于 30 岁,且不等于 40 岁的球员的示例

![tag](https://docs-cdn.nebula-graph.com.cn/figures/query_tag_cn.png)

## 子图查询
### 子图查询

**子图查询**方式的必选值为 VID。用户可以输入一个或多个 VID,指定查询的步数、边类型及流入流出的方向查询子图数据。以下给出 VID 值为 `Kings``Suns`,步数为`2` ,边类型为`server``like`的入边的示例
用户可以输入一个或多个 VID,指定查询的步数、边类型及流入流出的方向查询子图数据。VID 为必选项,可选项步数默认值为 1,边类型默认值为全部

!!! note

当输入多个 VID 时,VID 之间以`Enter`键隔开。

![tag](https://docs-cdn.nebula-graph.com.cn/figures/query_subgraph_cn.png)
下图为 VID 值为 `Kings``Suns`,步数为`2` ,边类型为`server``like`的入边的示例。

![tag](https://docs-cdn.nebula-graph.com.cn/figures/query_subgraph_cn.png)
21 changes: 10 additions & 11 deletions docs-2.0/nebula-explorer/node-filtering.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,23 +8,25 @@

## 使用说明

- 使用 **Tag** 过滤画布中的点及关联的边时:
- 使用 **Tag** (标签)过滤画布中的点及关联的边时:

- **筛选条件**面板显示图空间中的所有 Tag。

- Tag 图例被置灰且画布中的对应 Tag 的点及关联的边会被隐藏。
- Tag 图例被过滤(置灰)时,画布中的对应 Tag 的点及关联的边会被隐藏。

- 对于多 Tag 的点,如果其任一 Tag 被选中为过滤项,则该点会被隐藏。
- 对于多 Tag 的点,如果其任一 Tag 被过滤,则该点会被隐藏。

- 支持通过搜索框输入对应的 Tag 进行筛选
- 支持通过搜索框搜索 Tag。

- 使用**筛选条件**过滤画布中的点及关联的边时:

- 每一组筛选条件只针对带此 Tag 的数据,筛选条件包括:Tag、属性、运算符、值。如满足条件,画布中的点会被自动添加选中状态,不满足条件的点及关联的边可被设置为**隐藏****置灰**。其他 Tag 数据状态不受影响。

- 如果筛选条件中配置了已被选中(置灰状态)的 Tag,画布中不会展示对应的数据。
- 通过标签过滤(置灰)的优先级最高。如果筛选条件中配置了已通过标签过滤(置灰)的 Tag,画布中不会展示对应的数据。

- 每次进行**节点筛选**操作时,只能选择一个 Tag。如果要过滤多个 Tag,需要多次进行**添加筛选条件**操作。
- 每次只能选择一个 Tag。如果要过滤多个 Tag,需要多次进行**添加筛选条件**操作。

- 筛选条件不支持对同一个 Tag 进行多次过滤,只会显示第一次过滤的结果。

## 示例

Expand All @@ -41,10 +43,7 @@

1. 在左侧导航栏中,单击**节点筛选**图标![node-filter](https://docs-cdn.nebula-graph.com.cn/figures/nav-filter.png)
2. 单击**添加筛选条件**,然后设置筛选项(本示例设置的值分别为`player``age``>``33`)。
3. (可选)重复第二步骤,添加多个筛选条件(本示例只需添加一次)。
4. 单击**隐藏**将不满足过滤条件的点隐藏,或者单击**置灰**将不满足过滤条件的点显示为灰色(本示例设置为**置灰**)。
3. 单击**置灰**将不满足过滤条件的点显示为灰色。
4. 打开**启动筛选**开关。

![filter_node](https://docs-cdn.nebula-graph.com.cn/figures/vertex-filtering-example2_cn.png)


![filter_node](https://docs-cdn.nebula-graph.com.cn/figures/vertex-filtering-example2_cn.png)

0 comments on commit 32c8f85

Please sign in to comment.