图引擎服务 GES-华为云

图引擎服务 GES-增量导入图(2.1.14):响应参数

响应参数状态码： 200 表5 响应Body参数参数参数类型描述 job_id String 执行该异步任务的jobId。状态码： 400 表6 响应Body参数参数参数类型描述 error_code String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误码。 error_msg String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误信息。

图引擎服务 GES 图管理API

图引擎服务 GES-增量导入图(2.1.14):请求示例

请求示例增量导入图数据，边文件目录为testbucket/demo_movie/edges/，边数据集格式为csv，点文件目录为testbucket/demo_movie/vertices/，点数据集格式为csv。 POST http://Endpoint/v2/{project_id}/graphs/{graph_id}/import-graph { "edgeset_path" : "testbucket/demo_movie/edges/", "edgeset_format" : "csv", "vertexset_path" : "testbucket/demo_movie/vertices/", "vertexset_format" : "csv", "schema_path" : "testbucket/demo_movie/incremental_data_schema.xml", "log_dir" : "testbucket/importlogdir", "parallel_edge" : { "action" : "override", "ignore_label" : true }, "delimiter" : ",", "trim_quote" : "\"", "offline" : false }

图引擎服务 GES 图管理API

图引擎服务 GES-新建索引:功能介绍

功能介绍根据给定的indexName，IndexType等信息创建索引。目前支持两种索引：复合索引和全文索引。复合索引有全局点索引（GlobalCompositeVertexIndex），全局边索引（GlobalCompositeEdgeIndex）以及局部点索引（CompositeVertexIndex），和局部边索引（CompositeEdgeIndex）。复合索引是针对固定组合的属性建立的，其中局部索引可以在指定的label上建立索引。而全局索引复合索引不需要指定label，只要某个label包含指定属性，就会自动在此label上建立索引。使用索引查询可以加快速度。全文索引（FullTextIndex）可以实现全文搜索、模糊搜索等功能。由于全文索引的刷新机制，更新数据后立即查询可能查到的是旧数据，建议更新后间隔一秒以上再进行查询。全文索引的使用请查看点过滤查询和边过滤查询。您也可以使用cypher语句来执行全文索引，具体请查看cypher操作相关章节。目前全文索引特性只在持久化版规格版本中支持。索引创建后需要等待30秒索引同步时间，同步完成后Cypher查询才可以利用索引进行加速。

图引擎服务 GES 索引操作API

图引擎服务 GES-新建索引:响应示例

响应示例状态码： 200 成功响应示例 Http Status Code: 200 { "jobId": "f99f60f1-bba6-4cde-bd1a-ff4bdd1fd500000168232", "jobType": 8 } 状态码： 400 失败响应示例 Http Status Code: 400 { "errorMessage": "graph [demo] is not found", "errorCode": "GES.8603" }

图引擎服务 GES 索引操作API

图引擎服务 GES-新建索引:请求示例

请求示例创建复合索引，索引名称为ageIndex，索引类型为全局点索引。 POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/indices { "indexName":"ageIndex", "indexType": "GlobalCompositeVertexIndex", "hasLabel": "true", "indexProperty": ["age"] } SERVER_URL：图的访问地址，取值请参考业务面API使用限制。

图引擎服务 GES 索引操作API

图引擎服务 GES-新建索引:响应参数

响应参数表3 响应Body参数说明参数类型说明 errorMessage String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误信息。 errorCode String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误码。 jobId String 执行该异步任务的jobId。说明：可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。 jobType String 执行该异步任务的jobType。 result String 成功时result值为success。

图引擎服务 GES 索引操作API

图引擎服务 GES-新建索引:请求参数

请求参数表2 Body参数说明参数是否必选类型说明 indexName 是 String 索引名称。只能包含字母,数字,-和_。不能包含其他字符。索引名称的长度需在63字符以内。 indexType 是 String 索引的类型，区分大小写。 “GlobalCompositeVertexIndex”为全局的Composite类型的点索引。 “GlobalCompositeEdgeIndex”为全局的Composite类型的边索引。 “CompositeVertexIndex”为局部的Composite类型的点索引。 “CompositeEdgeIndex”为局部的Composite类型的边索引。 “FullTextIndex”为全文索引。 hasLabel 否 Boolean 是否有label，默认为false。 true false indexLabel 否 List Label列表，仅在indexType为CompositeVertexIndex或CompositeEdgeIndex时有效，而且为必填项，用来指定在哪些label上建立索引。 indexProperty 否（若hasLabel为false或null，则该项为必选） List 索引的属性列表。可以创建索引的属性类型有： integer、 float、 double、 long、 enum、 string、 date。如果属性类型为string，属性长度建议不要超过40个字节，超出的部分会被截断。 Cypher查询可以借助hasLabel为True的索引来加速。 indexProperty为空时，建立的索引为label索引，可以加速label过滤。 indexProperty不为空时，建立的索引为属性索引，可以加速对应的属性过滤。

图引擎服务 GES 索引操作API

图引擎服务 GES-删除过滤后的点(2.2.7):响应示例

响应示例状态码： 200 成功响应示例 Http Status Code: 200 { "jobId": "03e774f5-29ea-4187-9508-5435f3892ead016886200", "jobType": 1 } 状态码： 400 失败响应示例 Http Status Code: 400 { "errorMessage": "Bad Request, parameter labels and vertexFilters cannot all be null", "errorCode": "GES.8203" }

图引擎服务 GES 点操作API

图引擎服务 GES-删除过滤后的点(2.2.7):请求示例

请求示例删除满足过滤条件的顶点集合（仅支持异步模式），顶点类型过滤条件分别为movies和user，属性名称为Age。 POST https://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=delete { "labels": [ "movies", "user" ], "vertexFilters": [ { "propertyName": "Age", "predicate": "=", "values": [ "18-24" ] } ] }

图引擎服务 GES 点操作API

图引擎服务 GES-删除过滤后的点(2.2.7):响应参数

响应参数表4 响应Body参数参数类型说明 errorMessage String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误信息。 errorCode String 系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误码。 jobId String 查询节点任务ID。请求失败时字段为空。说明：可以查询jobId查看任务执行状态、获取返回结果，详情参考查询Job状态(1.0.0)-业务面。

图引擎服务 GES 点操作API

图引擎服务 GES-如何使用图引擎服务

如何使用图引擎服务图引擎服务（Graph Engine Service，简称GES）是针对以“关系”为基础的“图”结构数据，进行查询、分析的服务。广泛应用于社交关系分析、营销推荐及社会化聆听、信息传播、防欺诈等具有丰富关系数据的场景。本文档将为您介绍如何在图引擎服务管理控制台完成图数据的相关操作和分析。使用本服务的操作流程如下所示：图1 图引擎服务的使用流程表1 使用流程说明流程子任务说明详细指导准备工作注册华为账号使用图引擎服务之前，您需要注册华为账号并进行实名认证。注册华为账号并开通华为云用户授权GES权限将GES服务的策略授予用户组，并将用户添加至用户组中从而使用户拥有对应的GES权限。授权GES权限导入元数据从本地导入将元数据文件导入到图引擎服务中以便后续创建图使用。从本地导入从OBS中导入提前将准备好的元数据文件上传至OBS桶中，以便后续导入到图引擎服务中使用。从OBS中导入创建图自定义创建图使用自定义方式创建图。自定义创建图创建图行业图模板创建图使用行业图模板创建图。行业图模板创建图创建图创建动态图使用动态图的方式创建图。创建动态图管理图管理图操作对图进行备份恢复、变更规格、扩副本、升级等相关操作。管理图操作分析图图数据分析通过“图引擎编辑器”对图进行查询和分析。图数据分析查看图任务总览图系统总览页面展示了“我的资源”信息，可以帮助您快速了解已有图的总体信息和计费详情。总览图任务中心任务中心可用于查看创建图、备份图、启动图、删除图等异步任务的详情。任务中心

图引擎服务 GES

图引擎服务 GES-查看运行记录

查看运行记录系统会以表格的方式记录用户的执行操作记录，方便用户在分析数据时了解执行进度和执行完成时间。查看运行记录的具体步骤如下：进入图引擎编辑器页面，详细操作请参见访问图引擎编辑器。在执行Gremlin/Cypher/DSL查询或算法分析之后，在“运行记录”页签下会展示操作记录的名称，状态，请求参数，jobid，开始时间，耗时以及单击“查询结果”按钮会跳转到查询结果页面，展示该操作的完整查询结果。图1 运行记录操作列功能：在执行算法请求的过程中，您想要停止算法的执行，可以在操作列单击“停止”。想要重新执行Gremlin、Cypher、DSL查询请求，无需在查询区重新输入，可以直接在操作列单击“重发”。想要对已经执行的Gremlin、Cypher、DSL查询请求进行修改，可以在该请求的操作列单击“重新输入”，该查询语句会重新输入在查询区。如果您想要将运行记录导出，可以在右上角单击“导出”，选择导出格式。 Cypher查询支持json，txt两种导出格式。 Gremlin查询和DSL查询仅支持json导出格式。父主题：访问图和分析图

图引擎服务 GES

图引擎服务 GES-图引擎编辑器介绍

图引擎编辑器介绍编辑器页面分为图分析区（包括探索区、操作区、元数据区、算法区）、绘图区、查询区、结果展示区、条件过滤及属性区。图1 编辑器页面表1 区域说明区域名称说明探索区提供图相关工具来探索图（例如：路经拓展），具体功能介绍请参考图探索功能。操作区通过调用API的方式来添加自定义操作。具体功能介绍请参考添加自定义操作。元数据区可以对元数据进行操作（如添加、隐藏、导入或导出等）。具体功能介绍请参考Schema编辑。算法区显示了GES服务支持的所有算法，且可在此区域设置各算法相关的属性。完整算法区功能介绍如表2所示。说明：算法区选择算法，执行后，画布区将展示包含关键结果的采样子图，对应的执行结果非完整结果。想获取完整返回结果请通过调用API获取。绘图区图数据的可视化展示区。绘图区预置了快捷操作，方便您对图数据进行分析。绘图区详细功能介绍如表3所示。图数据查询区可以输入Gremlin查询语句执行查询操作。可以输入Cypher查询语句执行查询操作。可以输入DSL查询语句执行查询操作。结果展示区包含如下两个页签：运行记录：具体介绍请参考查看运行记录查询结果：具体介绍请参考查看查询结果条件过滤及属性区在绘图区，可以选中一个点，单击右键，选择“查看属性”，显示该页面。包含如下三个页签：条件过滤页签可以设置条件属性，对图数据进行筛选分析。具体介绍请参考条件过滤。属性页签展示选中点或边的属性信息。统计信息展示页签会显示出当前所框选的点边对应的标签和节点权重的数量。具体介绍请参考统计信息展示。图2 算法区表2 算法区介绍界面元素说明输入算法名称，快速查找对应的算法。展开算法的参数配置区域。运行算法。算法的属性设置区域。每个算法的属性不同，详细信息请参考算法介绍。图3 绘图区表3 绘图区介绍界面元素说明第1行： 13表示当前图上的点数据，886813表示整张图的所有点数据。第2行： 9表示当前图上的边数据，892773表示整张图所有边的数据。孤立点是指和其余点没有关联，在画布中独立存在的点。框选内孤立点：框选（Ctrl+ 鼠标左键拖动）画布中的点，单击该按钮可查看框选范围内的所有孤立点。画布内全量孤立点：直接单击该按钮，可显示画布中所有的孤立点。选中画布中任意一个点，单击该按钮可查看与当前选中点有关联的所有点。撤销前一步操作。恢复被撤销的前一步操作。选择显示“全图数据”或“当前数据”。 “全图数据”是图的所有数据。 “当前数据”是当前在画布上渲染出来的数据。可以切换图引擎编辑器的主题，支持浅色、深色和跟随系统三种主题。选择了“全图数据”或者“当前数据”，在搜索框里输入节点ID，例如2，按回车或者单击查询图标，可快捷搜索出对应的点数据并渲染到图展示区域。说明：当前只支持单个顶点ID的输入。选择“当前数据”搜索，当前画布存在点会高亮显示出来。单击“清空”，清除画布所有内容。将画布内容导出，支持导出为TXT格式（当前画布的snapshot/点边文件）。快捷键。 Ctrl+E（选择关联实体）。 Ctrl+‘+’（放大）。 Ctrl+‘-’（缩小）。 Ctrl+Z (撤销 undo)。 Ctrl+A（画布内容全选）。 Ctrl+Delete：清空画布。 Delete（快捷隐藏点）。 Ctrl+单击（多选单击的点和边）。快照，用户可以快速保存和恢复画布当前所展示的图。具体功能介绍请参考快照。放大图，最大放大至6倍。缩小图，最小缩小至0.05倍。适配当前屏幕。当界面中展示的点边与当前操作的浏览器窗口大小失调时，单击此按钮，可快速自动适配窗口大小。快速切换布局。从左往右分别为：力引导布局、圆形布局、网格布局、核心单节点布局、分层布局、自动分群布局、核心双节点布局。展示效果如图力引导布局展示效果所示。说明：核心双节点布局必须要选中两个点才可以生效。当画布中有图数据时，单击图数据内容，可根据需要选择图数据的颜色和大小。点详情弹窗。把鼠标移动到想要查看的非虚化节点上，会自动显示出该节点的id、label，属性等信息。说明：弹窗最多能显示节点的6个属性。当该节点的属性大于6个时，您可以到条件过滤及属性区查看该节点的完整属性信息。绘图区快捷键操作框选：Shift+ 鼠标左键拖动框选区域内所有点边，效果如下所示。多选：Ctrl+ 鼠标左键拖动框选区域内所有点边被选中并高亮，效果如下所示。正选/反选：Ctrl + 鼠标左键 ctrl+鼠标左键选中点或者边，可以选中并高亮，按住ctrl键再次单击选中点或者边，可以取消选中并去除高亮状态。全选：Ctrl + A 选中所有点和边，并高亮。选择关联点边：Ctrl + E 选中点之后按ctrl+E，可以将有关系的点和边选中高亮。隐藏：Delete 快捷隐藏点或者边。适配：Ctrl + F 根据当前屏幕宽度和高度自动缩放所有点和边。缩小：- 键盘对应 - 键，缩小当前画布显示。放大：=（+）键盘对应 + 键，放大当前画布展示。取消选中：Esc 所有选中的点和边取消选中，高亮状态消失。放大缩小：滑动鼠标滚轮滑动鼠标滚轮可以放大缩小画布显示。图4 力引导布局展示效果图5 圆形布局展示效果图6 网格布局展示效果图7 核心单节点布局展示效果图8 分层布局展示效果图9 自动分群布局展示效果图10 核心双节点布局展示效果父主题：访问图和分析图

图引擎服务 GES

图引擎服务 GES-一般图数据格式:边文件

边文件边文件罗列了各个边的数据信息，一行为一条边的数据。GES中图规格是以边的数量进行定义的，如一百万边。格式如下所示，id 1、id 2是一条边的两个端点的id。 id 1, id 2, label, property 1, property 2, … 示例： Eric,Lethal Weapon,rate,4,2000-11-21 15:33:18 Vivian,Eric,friends 注意：在持久化版中想要把两个端点和标签都相同的边存入进去，则需要sortKey列，放在属性后面即最后一列。导入时指定sortKeyColumn参数，如果sortKey有值，则会根据图的sortKey类型正确读入，如果没有值需要在属性的末尾添加逗号，导入时会读入空表示将sortKey设置为空，即NULL。 id 1, id 2, label, property 1, property 2, …,sortKey 示例： Eric,Lethal Weapon,rate,4,2000-11-21 15:33:18，5 Vivian,Eric,friends,

图引擎服务 GES 图数据的格式

图引擎服务 GES-一般图数据格式:点文件

点文件点文件罗列了各个点的数据信息。一行为一个点的数据。格式如下所示，id是点数据的唯一标识。 id,label,property 1,property 2,property 3,… 点id的名称中不能包含中划线（-）。点id的类型不需要设置，默认为string。请注意label前后不要任意加空格，逗号表示分隔符，空格会被识别成label的一部分，可能会出现识别不了或提示label不存在的情况。示例： Vivian,user,薇薇安,F,25-34,artist,98133 Eric,user,埃里克,M,18-24,college/grad student,40205

图引擎服务 GES 图数据的格式

云服务器内容精选

图引擎服务 GES

7*24

备案

专业服务

退订

建议反馈

售前咨询热线