TigerGraph文档
2.3
2.3
  • TigerGraph 2.3 技术文档目录
  • TigerGraph 版本比较
  • GSQL 图数据库算法库
  • 版本发布, 功能变更
    • 版本发布 - TigerGraph 2.3
      • 版本发布 - TigerGraph 2.2
    • 变更日志
  • INTRODUCTION AND OVERVIEW
    • TigerGraph 入门指南
    • GSQL 101
      • 环境准备
      • 定义一个Schema
      • 加载数据
      • 使用内置的SELECT进行查询
      • 使用参数化GSQL查询进行查询
      • 总结:你学到的东西
    • TigerGraph平台概览
    • Knowledge Base and FAQs
      • TigerGraph 常见问题
      • GSQL 常见问题
    • Kafka Loader用户手册
  • 系统管理指南
    • TigerGraph 管理员指南
      • 硬件及软件配置
      • 安装和配置
        • 安装指南
        • 高可用(HA)集群配置
        • 集群的扩容
        • 软件许可激活
      • 系统权限管理
        • 用户权限及验证
        • LDAP
        • 单点登录(SSO)
      • 数据加密
        • 链接的加密
        • 非活跃数据(Data At Rest)的加密
      • 系统管理
        • 基于Web的管理工具:Admin Portal
        • 使用gadmin工具管理
        • 数据的备份与恢复
        • 系统维护中的常见问题
  • 开发者指南
    • GSQL 语言开发指南
      • 第一部分 数据定义及加载
        • 简介
        • 系统和语言基础
        • 定义一个图模型(Graph Schema)
        • 修改图模型
        • 创建数据加载任务
        • 执行加载作业
        • 附录
          • 关键词和系统预留词
          • GSQL 从开始到结束的整个过程和数据流向
      • 第二部分 查询
        • 简介
        • 创建、安装、执行查询
        • 数据类型
        • 累加器(Accumulators)
        • 运算符,函数和表达式
        • 声明和赋值
        • SELECT语句
        • 控制流语句
        • 数据修改语句
        • 输出语句以及文件对象
        • 异常处理语句
        • 注释
        • 附录
          • 附录A: 一般错误和问题
          • 附录B:查询语言的完整正式语法
          • 附录C. 图查询语言的预留词列表
          • 附录D. 示例
    • RESTPP API 开发指南
      • 简介
      • RESTPP请求
      • 系统预制函数(Endpoints)
      • 系统预制函数请求格式(JSON)
    • 事务处理及ACID支持
  • 图形界面 可视化
    • GraphStudio 用户指南
      • GraphStudio 概述
      • GraphStudio许可证
      • 用户权限管理
      • 设计图模型(Schema)
      • 将数据映射到图
      • 加载数据
      • 探索图数据
      • 编写查询
      • 导入和导出解决方案
      • 已知问题
      • GraphStudio中的专利及第三方软件版权说明
Powered by GitBook
On this page
  • 探索图数据
  • 内部导览工具栏
  • 参数面板
  • 图探索面板
  • 在图中搜索点
  • 根据ID搜索点
  • 让GraphStudio帮助你选点
  • 根据属性过滤点搜索的结果
  • 从某个点开始扩展搜索
  • 选择扩展搜索的起点
  • 设置扩展搜索条件
  • 执行扩展搜索
  • 找到两点之间的路径
  • 选择起始点和目标点
  • 配置路径搜索的搜索条件
  • 执行路径搜索
  • 找到一组点之间的关联
  • 定义需要搜索关联的点集
  • 设置关联搜索条件
  • 执行多点关联的搜索
  • 执行GSQL查询
  • 配置图探索面板
  • 改变样式
  • 在结果中定位某个点
  • 显示选中的点和边
  • 隐藏选中的点和边
  • 回退和重做
  • 添加新的点
  • 添加一条边
  • 编辑点或边的属性
  • 删除点或边
  • 保存截图
  • 改变设置
  • 调整搜索结果的显示样式
  • 根据属性和累加器的值为不同的元素设定不同的颜色
  • 以不同属性和累加器的值作为条件,设置点的大小和边的粗细

Was this helpful?

  1. 图形界面 可视化
  2. GraphStudio 用户指南

探索图数据

Previous加载数据Next编写查询

Last updated 6 years ago

Was this helpful?

探索图数据

完成数据的加载后,我们便可以前往“图探索页面”搜寻我们感兴趣的点,也可以根据一些判断条件筛选出相关邻点以及它们之间的边。

这是一次图探索的结果示例:

图探索页面分为左中右三个部分,从左到右依次为:

内部导览工具栏

该工具栏自上而下共有五个按钮,依次为:

按钮

功能

查找点: 根据特定的规则找到需要的点

从某个点扩展搜索: 找到某个指定点的邻点

查找路径: 从指定的点出发,找到通往某个目标点的所有路径

搜寻多点关联: 找到在一组点之间找到互相关联的路径

执行查询: 执行已经安装过的GSQL查询

参数面板

在参数面板中,你可以为各项图探索任务设置过滤规则、添加判断条件以及配置其他一些相关参数的。

图探索面板

图探索面板用于显示图探索的搜索结果。

你可以在这里调整搜索结果的显示样式,制作快照或编辑结果中的某些元素。

上面的菜单栏包含数个按钮,它们的功能从左至右依次为:

  • 更改排列样式 : 在不同的内置排列样式之间选择,选项包括球形样式,树形样式,圆环样式以及向量样式。

  • 在结果中定位某个(些)点 : 根据点的ID值或属性值,在搜索结果中定位符合条件的点。

  • 显示选中的对象 : 选中一个或多个元素,然后点击该按钮隐藏所有未被选中的元素。

  • 隐藏选中的对象 : 选中一个或多个元素,然后点击该按钮隐藏所有被选中的元素。(如果什么都没选中,则所有元素都会被隐藏)

  • 回退到上一步 : 回退到上一次搜索后的结果(即最后一次对搜索结果更新前的状态)

  • 重做下一步 : 重做一次最近回退的那一步(即前进到上一次回退前的搜索结果)。

对于数据库本身的更改(例如对于点或边的增减或是对于属性值的更改)是无法使用回退功能回到上一步状态的。 同理,回退/重做功能不能作用于对于排列样式和显示样式的改变(例如对于对象位置或者属性显示参数的改动)

  • 添加一个点 : 在搜索结果的图形中添加一个点,该点也同时添加到图数据库中。

  • Add new edge : 在探索结果的图形中添加一条边,该边也同时添加到图数据库中。

  • 编辑点或边的属性 : 在探索结果的图形中修改某个元素的属性,该修改也会同步到图数据库中。

  • 删除选中的元素 : 在探索结果的图形中将选中的元素删除,同时也将其在图数据库中删除。

  • 截图并保存 : 将当前的图形截图并保存为PNG格式的图片。

  • 更改设置 : 为每个点类或边类配置需要显示的属性。或者配置是否要在鼠标悬停窗口中的显示详细信息。

点击图探索面板中的对应按钮可以将参数面板隐藏。

在图中搜索点

根据ID搜索点

要查找你要的点,首先需要选择正确的点类,然后在文本框中输入点的ID,最后点击查找按钮。如果该ID对应的点存在,它就会出现在图探索面板中。

让GraphStudio帮助你选点

在参数面板的配置子菜单中,你可以挑选一些你需要的点类。默认情况下,所有的点类都是选中的。你可以将你不需要的点类取消勾选。

根据属性过滤点搜索的结果

点击ADD按钮完成添加,随后在Company点类的下方会出现新的条件规则:

再次点击按钮,系统便会根据该规则随机找出5个Company点,且它们的registered_capital属性值都大于或等于50000。

当图数据十分庞大时,则基于属性过滤规则的点搜索过程将会十分缓慢。我们计划在未来支持属性索引功能,该计划已经在我们的开发路线图中。

注意: 如果在图探索页面中多次执行搜索操作,则前一次的搜索结果不会自动清除,而是会与后一次的探索结果整合,并且由最近一次搜索得到的元素会自动被选中(即以灰色的粗边高亮显示)用于与之前的搜索结果进行区分。

从某个点开始扩展搜索

快捷操作: 双击一个点可以将其扩展出最多200个邻点。

选择扩展搜索的起点

有一些点可能已经被选中了,选中的点会以灰色的粗边高亮显示。使用Shift键+鼠标单击的可以同时选取多个点或边:

  • 单击一个点可以选中它,同时之前选中的任何元素都变成未选中状态。

  • 按住Shift键点击任何未选中的点可以将它添加到已选中列表中。

  • 按住Shift键点击任何已选中的点可以将它从已选中列表中移除。

点击空白处可以取消所有选中的点。

设置扩展搜索条件

扩展搜索功能允许GraphStudio从一组初始点出发向前搜索多个步,但返回的结果数不能大于允许的数量上限(默认上限为5000个点和10000条边)。可以为每一步设定独立的扩展搜索条件。

在参数面板中设置扩展搜索条件:

  • 设置搜索结果中与每个点相连的边的数量上限。该参数的效果在于:如果某个点的邻点数超过了这个上限,则搜索结果可能无法包含所有的邻点。

  • 设置需要搜索的边类以及每个边类的属性值判断条件。

  • 设置搜索需要找到的目标点类以及每个点类的属性判断条件。

默认情况下,该窗口中只有第一步的搜索条件的编辑框。你可以点击"Add Expansion Step”按钮添加其他各步的搜索条件。

同理,你也可以点击"Remove Expansion Step”来去掉一些多余的扩展搜索条件。

执行扩展搜索

找到两点之间的路径

选择起始点和目标点

在参数面板的最上方,你需要填入本次搜索的起始点和目标点。

定位起止点的方式有两种,两种方法对于起始点和目标点都适用:

如果你已经知道某个点的点类和ID,则可以直接在下拉菜单中选择该点类,并输入该点的ID。即便该点不在当前的图探索面板中也是可以选择的。

而如果该点已经在图探索面板中,则还有一种更便捷的方法:

  1. 首先点击文本框

  2. 然后在图探索面板中点击你要的点后,GraphStudio就会自动帮你填入相关参数。

点击”交换按钮“(画着两个绿色箭头的按钮)可将起始点和目标点的角色对换。

配置路径搜索的搜索条件

GraphStudio有三种搜索路径的方式:

  1. 找到一条最短路径: 在两点之间找到并高亮一条最短路径

  2. 找到所有最短路径: 在两点之间找到并高亮所有最短路径

  3. 找到所有可能路径: 在两点之间找到并高亮所有路径

图的规模越大,则搜寻路径的运算量也越大。所以,我们有必要限制搜索结果中的路径长度。

除了可以设定搜索方法和最大长度外,你也可以通过指定的点类、边类,或者依据属性筛选条件来过滤搜索结果。

执行路径搜索

找到一组点之间的关联

  1. 对于一个给定点集,如果集合内的每一对点之间都存在一条不长于路径长度上限的最短路径,则将其添加到结果中。

  2. 最终的结果是上述所有最短路径的集合(每对点之间都有一条最短路径)。

上述搜索的实际结果等价于对该点集合中的每一个点执行一次“找到并显示一条最短路径”命令。

定义需要搜索关联的点集

点击一个点选中该点。按住Shift键可一次选中多个点。每次选中一个点,它都会自动添加到参数面板中。

设置关联搜索条件

图的规模越大,搜索多点间关联的运算量就越大。所以,我们有必要通过一些参数来限制路径的长度。

你也限定需要搜索的点类和边类,以此缩小搜索结果范围。

执行多点关联的搜索

执行GSQL查询

该按钮的功能是将GSQL查询和其他的图探索功能混合使用,以便提供更多数据搜索和分析的可能性,让用户能更好的从数据中找到规律。

配置图探索面板

当搜索结果以一个子图的形式显示在图探索面板中时,你可以使用探索结果视觉菜单栏中的按钮,对各种图形的样式进行调整,甚至直接编辑图数据库本身。

改变样式

在结果中定位某个点

ID或属性中含有单词“Mary”的点都会被自动选中:

显示选中的点和边

隐藏选中的点和边

回退和重做

数据库的变动(包括点和边的增减以及属性值的更改)是不可以通过回退按钮回滚的。 同时,回退/重做按钮不能控制对于显示元素和排列样式的更改操作(例如改变某个点或边的位置或显示参数设置)

添加新的点

如果你输入的ID已经存在,GraphStudio会询问你是否需要覆盖现有的重名点。如果你的选择是“否”,则这个点就不会添加到数据库中,也没有任何数据会被改动。

添加一条边

如果在两个起止点之间已经存在你所要添加的边类的边,则GraphStudio会询问你是否需要覆盖已有的边。如果你的答案是”否“,则数据库将不会产生任何改动。当前版本的TigerGraph不支持在两个点之间存在多个相同边类的边。

编辑点或边的属性

当你完成编辑后,点击Update按钮保存修改结果。

删除点或边

该删除动作是永久性的。所有被删除的点和边都无法通过“回退”按钮找回。如果你误删除了某些元素,你只能选择手动重新添加它们。

如果删除了一个点,则所有与之相连的边(包括从这个点出发的边以及指向这个点的边)都会被同时删除。

保存截图

改变设置

在下面的例子中,我们选择只显示Person点的ID和gender两个属性以及Company点的ID和registered_capital两个属性。

除了上述功能外,你还可以调整点和边的尺寸及颜色以使得结果更加易于阅读。这一点十分重要,以至于我们将用一个独立的小章节来介绍它:

调整搜索结果的显示样式

根据属性和累加器的值为不同的元素设定不同的颜色

点击ADD完成条件的添加。

同理,我们也可以添加一条内容为 @PageRankScore between [0.5, 1) 的判断条件并将其配置为绿色。配置完成后的最终效果如下:

点击APPLY后,图探索面板中的搜索结果便会按照每一条判断条件变成各种不同的颜色。

我们也可以根据相同原理为不同的边设置不同的颜色。

以不同属性和累加器的值作为条件,设置点的大小和边的粗细

默认情况下,所有表示点的圆圈的半径都是40,而所有边的粗细都是2。GraphStudio可以根据它们各自的某些属性值,或是GSQL查询得到的累加器结果数值,改变每个点的大小和边的粗细。你可以选择让每个点的半径与其在页面排序中的重要程度挂钩,这样各点的权重便可以一目了然。

在完成配置后点击ADD保存更改,随后半径的条件表达式会显示在半径窗口下方。

在点击APPLY按钮后,所有的点都会根据条件判断调整自己的大小。

我们也可以使用类似的方法配置边的粗细。

如果你想移除某些条件表达式,点击参数面板中半径值或线段粗细值上的编辑按钮,并在弹出窗口中的下拉菜单中选择 ”None”。

点击ADD+APPLY按钮即可回到初始的状态。

图形颜色条件判断和图形大小条件判断可同时存在。下图的例子中演示了同时配置两者后的效果:

图探索菜单中的第一个按钮是“搜索点按钮” 。通过它,我们可以借助这个功能找到一组可用作搜索动作出发点的点集。该界面也是你第一次进入图探索页面时的默认起始页。如果再次点击该按钮,系统会隐藏参数面板并扩大图探索面板的显示面积。

如果你并没有特别中意的点,也可以选择让GraphStudio工具帮你做出选择。在参数面板中输入一个选择数量然后点击按钮 ,随后系统会自动在每个点类中随机选出该数量的点。

你可以通过增加属性值判断规则来控制点搜索的颗粒度。点击任何点类右侧的过滤器按钮 便可添加判断条件。在弹出的窗口中,你可以添加基于点类属性的判断条件,操作方法与添加数据映射判断条件的步骤相同。下面的例子中,我们通过判断条件筛选出了所有registered_capital属性值不小于50,000的Company点。

图探索菜单中的第二个按钮是“扩展搜索按钮” 。扩展搜索(Expand)一词在此处表示从一组选中的点出发,找到与它们的距离为一步(或几步)的邻点。再次点击该按钮可以隐藏参数面板使得图探索面板的显示面积扩大。在执行扩展搜索前你需要选中至少一个点作为起点。若图探索面板中还没有任何点,请参考“在图中搜索点”中的步骤为扩展搜索添加一些起点。

扩展搜索条件设置完成后,点击执行搜索按钮 执行扩展搜索。图探索面板随后会显示最新的扩展搜索结果。扩展搜索的起始点会以白色的粗边高亮显示。下面的例子中,扩展搜索的初始点有两个,扩展搜索的距离为两步。

图探索菜单上的第三个按钮为 “搜索路径按钮” 。它可以按照一定条件搜索两个点之间的路径。再次点击该按钮可以隐藏参数面板。

在所有的配置完成后,点击路径搜索按钮 执行路径搜索。

菜单上的第四个按钮是“多点关联搜索按钮” ,即在一组给定的初始点之间找到一个”关联社群“(connection community);关联社群的定义如下:

搜索条件配置完成后,点击按钮 开始搜索:

如果你已经编写并安装了一些GSQL查询(编写和安装方法请参阅章节),则你可以将GSQL查询和上文中的各种图探索功能混合使用。

菜单栏中的第五个按钮 是”执行查询按钮” 。在下拉列表中,选择要运行的查询。 输入参数,然后单击“运行查询”按钮 。查询执行结果子图将与先前的图形探索结果合并并突出显示:

点击按钮 可以在数个系统内建的样式中切换,优化搜索结果图形中点与点之间的位置。在弹出的会话窗口中会展示每种不同样式的样图。

点击“定位点按钮” 后,系统会根据你给出的ID和/或属性值在搜索结果中找到符合条件的点并将其放大。例如,如果你在筛选条件中输入“Mary” 关键词并勾选了下方的两个复选框,则那些在搜索结果中,ID或属性值含有“Mary”字段的点会被自动选中(同时其他的点会自动取消选中)且窗口会放大并聚焦在这个些点上。

点击按钮 会隐藏所有当前未被选中的点和边。如果一条边的两个端点都被选中的话,则这条边也会被自动选中。如果没有任何元素被选中则该按钮无效果。

点击按钮 会隐藏所有当前选中的点和边。如果没有任何元素被选中,则所有的点和边都会被隐藏。

图探索页面会记录本次使用过程中的所有操作。点击回退/重做按钮 可以退回上一步或重做之前回退的步骤。

点击 可以在图数据库中添加一个点。在弹出的窗口中选择一个点类并输入ID已经属性值,然后点击”ADD”完成添加,随后一个新的点就会添加到TigerGraph数据库中。同时它也会显示在图探索面板中。

点击 按钮会在图数据库中添加一条边。点击该按钮后,你需要在图探索面板中用鼠标依次选取该边的起始点和目标点,然后在弹出的窗口中选择正确的边类。下拉菜单中只会显示符合起始点和目标点条件的边类(所以如果没有符合条件的边类,下拉菜单可能为空)。随后再输入所有相关属性的参数,然后点击“ADD”完成添加。这条新边会同时出现在图探索面板中。

如果要编辑某个点或者边的属性,你可以先选中这条边或者这个点,然后点击编辑属性按钮 。

若要删除某个点或边,你需要先选中它们,然后点击删除按钮 将它们从数据库中删除。

当你找到了一些有趣的结果并想将它们保存下来的时候,你可以选择点击保存截图按钮 将搜索结果会以一个本地png格式的图片形式保存。

点击 可以编辑图探索结果中各个元素的显示设置。你可以针对每个点类或边类分别设置需要显示的属性,也可以选择是否在鼠标悬停窗口中显示该元素的细节信息。完成配置后点击APPLY保存设置。

默认情况下,每个点和边都会自动赋予你在设计图模型页面中的事先选定的颜色。然而,如果你希望着重显示某些特别的点和边,也可以通过一系列判断条件来为它们单独设定不同的颜色。你甚至可以为每一个条件都选择一个单独的颜色。 所有符合条件的点和边都会被赋予新的颜色。配置方法为:在设置面板中的颜色部分,首先选中你要改色的点类或边类,然后点击按钮 打开颜色配置窗口:

点击改色按钮 ,在弹出的调色盘中选择红色,然后添加一行判断条件: @PageRankScore >= 1.0

如果想要删除某些色彩规则,只需点击右侧的删除按钮 即可。

编辑方法: 首先选择一个点类,然后点击参数面板中半径值的编辑按钮 。在弹出的窗口中,配置半径的条件表达式:

编写查询