图引擎服务 GES-华为云

图引擎服务 GES-时序路径分析（Temporal Paths）:概述

概述时序路径分析算法（Temporal Paths）区别于静态图上的路径分析，结合了动态图上信息传播的有序性，路径上后一条边的经过时间要晚于或等于前一条边，呈现时间递增（或非减）性。时序路径不满足传递性：即从节点i到节点j有一条时序路径，从节点j到节点k有一条时序路径，并不能说明从节点i到节点k有一条时序路径。因此在求解问题上，相较于静态图上的路径求解复杂度升高，计算难度变大，但时序路径分析在实际生活中用途很广，例如计算出行路线，模拟/搜索信息传播路径等。 Temporal Paths根据求解目标的差异可分为不同的类型，常见的有：Shortest, Foremost, 以及 Fastest Temporal Paths。 Shortest Temporal Paths：表示距离最短的时序路径。 Foremost Temporal Paths：表示尽可能早的到达目标节点的时序路径。 Fastest Temporal Paths ：表示耗费时间最短的时序路径。

图引擎服务 GES 算法参考

图引擎服务 GES-时序路径分析（Temporal Paths）:参数说明

参数说明表1 Temporal Paths参数说明参数是否必选说明类型取值范围默认值 source 是起点id String - - targets 是终点id集合 String csv格式，ID之间以英文逗号分隔，例如：“Alice,Nana”，个数不大于100000。 1000 directed 否是否考虑边的方向 Boolean true 或false，布尔型。 false k 否最大深度 Integer 1-100，包括1和100 3 strategy 否运行的算法策略 String 取值范围：shortest，foremost，fastest。 (注：fastest暂不支持) shortest：运行shortest temporal paths算法，返回距离最短的时序路径 foremost：运行foremost temporal paths算法，返回尽可能早的到达目标节点的时序路径 fastest：运行fastest temporal paths算法，返回耗费时间最短的时序路径 shortest 表2 动态时间范围设置（dynamicRange）说明参数是否必选说明类型取值范围默认值 start 是动态分析起始时间 Date/ Integer - - end 是动态分析终止时间 Date/ Integer - - time_props 是动态分析的时间属性定义 Object - - 表3 动态分析的时间属性（time_props）说明参数是否必选说明类型取值范围默认值 stime 是开始时间属性名称 String - - etime 是结束时间属性名称 String - -

图引擎服务 GES 算法参考

图引擎服务 GES-时序路径分析（Temporal Paths）:示例

示例需要在图引擎编辑器的算法区内，选定该算法进行操作。具体操作详见使用算法分析图。设置动态时间范围参数： start=1646092800，end =1646170716，stime="startTime"，etime="endTime"。设置temporal paths算法参数： source="Person00014" targets="Person00055,Person00058,Person00052,Person00061,Person00060,Place00032,Place00016,Place00026,Place00015,Place00043" directed="false" k="5" 选择算法搜索策略“shortest”或“foremost”。单击运行按钮，运行temporal paths算法，图引擎会根据选定的算法搜索策略，计算返回时序分析路径，路径随时间轴动态延伸，直至到达目标节点，JSON结果会展示在查询结果区。

图引擎服务 GES 算法参考

图引擎服务 GES-Schema编辑:删除label

删除label 调用接口后，该label相关联的所有数据都会被删除，请您谨慎操作。图版本小于2.2.18，不支持schema的label删除功能。持久化版的图不支持schema的label删除功能。系统默认的label“_DEFAULT_”不支持删除操作。删除label的操作如下：如果您想要删除某个label，在图引擎编辑器的左侧的“元数据”列表中，单击元数据旁的“删除”按钮。图7 删除label 在弹出的确认窗口内，认真阅读完提示信息，确认要删除的label名称后，在框内完整的输入“DELETE”，单击“确定”。图8 删除确认窗口删除过程中，画布下方“结果展示区”会显示删除label算法的返回结果。图9 结果展示删除过程中，绘图区右侧的条件过滤功能置灰，不可使用。图10 条件过滤

图引擎服务 GES 访问图和分析图

图引擎服务 GES-Schema编辑:添加label

添加label 在图引擎编辑器左侧的元数据列表中，单击，可增加一个新的标签。 Label 名称表示新增标签的名字。 Label 类型可以选择设置的标签类型（点，边或者通用类型），通用类型表示标签既可以表示点，也可以表示边。自定义点样式：您可以来定义标签的颜色和标记，用来区分各个点。属性添加，默认实体只展示第一个添加的属性，其余不展示，可手动调整展示哪个属性，画布上会实时响应。图1 添加label

图引擎服务 GES 访问图和分析图

图引擎服务 GES-Schema编辑:隐藏label

隐藏label 隐藏单个label的所有点和边在图引擎编辑器的左侧的元数据列表中，单击元数据旁的“眼睛”按钮，可在图分析结果中隐藏该元数据的所有点和边。图4 隐藏label 隐藏当前选择的label的点和边在绘图区，单击图中任意一个点，被选中的点会显示为。表示label隐藏。在图数据中默认是全部展示的，单击label旁的“眼睛”按钮，可隐藏当前选择的label的点和边（即在画布中不展示）。表示基于label的实体过滤查询，单击该查询按钮，可以将该标签的点和属性过滤显示出来。

图引擎服务 GES 访问图和分析图

图引擎服务 GES-Schema编辑:修改label

修改label 图版本为2.3.18及以上版本支持该功能。在图引擎编辑器左侧的元数据列表中，单击想要修改的元数据，会弹出该元数据label详情页。可以直接修改label的属性名称、基数、数据类型等信息。若想要隐藏或删除该属性，可以单击操作列的“隐藏”或“删除”按钮进行操作。若您误删了某个属性或者修改有误，可以单击“复位”按钮，将会回到您上一次保存的数据状态。修改完成，确认无误后，单击“保存”按钮进行更新。图3 修改label

图引擎服务 GES 访问图和分析图

图引擎服务 GES-Schema编辑:label的导入和导出

label的导入和导出将当前图的元数据、点边数据集导入到OBS桶内或者从OBS桶内导出。导入：单击元数据列表中“导入”。在弹出的窗口中，选择要导入的元数据，点边数据集，日志储存路径，边处理以及导入类型后，单击“确定”可将数据从OBS桶内导入到当前图中。日志储存路径：用于存储导入图过程中不符合元数据定义的点、边数据集和详细日志。边处理：包括“允许重复边”，“忽略之后的重复边”，“覆盖之前的重复边”和“重复边忽略Label”。重复边默认起点和终点相同，当考虑label时，表示边的起点、终点、label相同才为重复边。图5 元数据的导入导出：单击元数据列表中“导出”。在弹出的窗口中，设置要导出的元数据、点边数据集的名称和导出的路径，单击“确定”可将数据导出到OBS桶内。图6 元数据的导出

图引擎服务 GES 访问图和分析图

图引擎服务 GES-增量导入数据:操作步骤

操作步骤登录图引擎服务管理控制台，在左侧导航栏，选择“图管理”。在图管理列表中，选择需要导入数据的图，在“操作”列选择“导入”。图1 导入数据在弹出的导入提示框中，选择以下参数。图集群（持久化版图会有此项）：持久化版的图在创建时会自动升级为多图集群，一个图集群下可以包含多个图实例，具体可参见多图管理（持久化版）。元数据：可选择已有元数据或创建新的元数据，具体操作可参考创建元数据。边数据集：选择对应的边数据集。点数据集：选择对应的点数据集。若不选择，则以边数据集中的点作为点数据集来源。日志存储路径：用于存储导入图过程中不符合元数据定义的点、边数据集和详细日志。存储在OBS中可能会产生费用，请及时删除。边文件中包含SortKey（持久化版图有此选项）：通过配置不同SortKey的值来区分重复边（源点，终点，Label三者都相同的边）。边处理：包括“允许重复边”，“忽略之后的重复边”，“覆盖之前的重复边”和“重复边忽略Label”。边处理的具体含义如下： “边处理”：重复边默认起点和终点相同，当考虑label时，表示边的起点、终点和label相同才为重复边。 “允许重复边”：表示起点到终点之间可以有多条边。 “忽略之后的重复边”：表示起点和终点之间有多条边时，仅保留最先读入的那条边。 “覆盖之前的重复边”：表示起点和终点之间有多条边时，仅保留最后读入的那条边。 “重复边忽略Label”：忽略label时，表示边的起点、终点相同即为重复边。导入类型：包括“在线导入”和“离线导入”。持久化版图支持多图管理需要选择图名称，不支持导入类型。边数据集和点数据集当前仅支持英文路径和文件夹格式。目前只支持从OBS中选择边数据集和点数据集，建议您提前将数据文件存储至OBS中，导入OBS的操作请参见OBS《快速入门》。所选边数据文件或点数据文件中的“Label”和“Label”中“Property”的顺序需与所选元数据文件中的一致，否则会提示“所选边数据/点数据文件与元数据文件不匹配”而无法创建图。关于GES图数据的格式的具体内容可参考图数据的格式。图数据（包含元数据、边数据集、点数据集）需按照模板中的格式导入。模板中已包含一份电影数据，可单击“下载模板”后直接导入。单击“确定”完成导入。若导入显示失败，

图引擎服务 GES 创建图

图引擎服务 GES-增量导入数据:操作场景

操作场景图引擎服务在创建图完成后可以导入图数据，或者当您需要新增图数据时，可以利用“导入”功能进行增量导入。当前仅支持 1.1.8 以上版本的图的增量导入功能。为防止系统重启时，不能正常恢复导入图数据，建议在使用图期间，不要删除存储在OBS中的数据。数据列的分隔符默认为逗号，暂不支持自定义。导入目录下的单文件或者导入的单文件大小不能超过5GB，如果超过5GB，则会导入失败，建议把文件拆成小于5GB的多个文件后再导入。单次导入的文件总大小（包括点、边数据集）不能超过可用内存的1/5。可用内存参考“运维监控看板”的“节点监控”中名称后缀为ges-dn-1-1和ges-dn-2-1节点可用内存（可以把鼠标悬浮在内存使用率上弹出）的最小值。

图引擎服务 GES 创建图

图引擎服务 GES-批量点查(1.1.9):响应示例

响应示例状态码： 200 成功响应示例 Http Status Code: 200 { "data": { "vertices": [ { "id": "27003509_北京中央电视台大楼", "label": "tag", "properties": { "popularity": [ 0 ], "name": [ "北京中央电视台大楼" ], "alias": [ "中央电视台光华路办公区", "中央电视台总部大楼", "大裤衩", "央视总部大楼" ] } }, { "id": "39636392_八达岭长城", "label": "tag", "properties": { "popularity": [ 0 ], "name": [ "八达岭长城" ], "alias": [ "长城" ] } } ] }, "result": "success" } 状态码： 400 失败响应示例 Http Status Code: 400 { "errorMessage": " Bad Request, parameter vertices cannot be null", "errorCode": "GES.8214" }

图引擎服务 GES

图引擎服务 GES-批量点查(1.1.9):请求示例

请求示例根据批量节点ID查询节点信息，待查询的点ID数组为"27003509_北京中央电视台大楼"和"39636392_八达岭长城"。 POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-query { "vertices": ["27003509_北京中央电视台大楼", "39636392_八达岭长城"] } SERVER_URL：图的访问地址，取值请参考业务面API使用限制。

图引擎服务 GES

图引擎服务 GES-批量点查(1.1.9):响应参数

响应参数表3 响应Body参数参数类型说明 errorMessage String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误信息。 errorCode String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误码。 data Object 查询成功时包含data字段，data字段中包含vertices查询结果。 result String 查询结果。成功时值为success，失败时值为failed。

图引擎服务 GES

图引擎服务 GES-子图查询(2.1.13):响应示例

响应示例状态码： 200 成功响应示例 Http Status Code: 200 { "data":{ "vertices":[ { "id":"Ray", "label":"user", "properties":{ "Name":["雷"], "Gender":["M"], "Age":["18-24"], "Occupation":["college/grad student"], "Zip-code":["90241"] } }, { "id":"Ella", "label":"user", "properties":{ "Occupation":["other or not specified"], "Name":["埃拉"], "Zip-code":["94402"], "Gender":["F"], "Age":["25-34"] } } ], "edges":[ { "source":"Ray", "target":"Lethal Weapon", "index":"1", "label":"rate", "properties":{ "Score":[2], "Datetime":["2000-11-22 19:16:16"] } }, { "index":"0", "source":"Ella", "label":"rate", "properties":{ "Score":[5], "Datetime":["2000-11-23 02:30:29"] }, "target":"Lethal Weapon" }, { "index":"5", "source":"Ella", "label":"friends", "properties":{}, "target":"Ray" } ] } } 状态码： 400 失败响应示例 Http Status Code: 400 { "errorMessage": " Bad Request, parameter vertices cannot be null", "errorCode": "GES.8214" }

图引擎服务 GES 子图操作API

图引擎服务 GES-子图查询(2.1.13):响应参数

响应参数表3 响应Body参数说明名称参数类型说明 errorMessage String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误信息。 errorCode String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误码。 data Object 查询成功时包含data字段，data字段中包含子图查询结果。说明：当前支持返回的子图边数最大值为100000，超过返回最大值时，会报错。

图引擎服务 GES 子图操作API

云服务器内容精选

图引擎服务 GES

7*24

备案

专业服务

退订

建议反馈

售前咨询热线