检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
准备工作 使用图引擎服务之前，您需要注册华为云账号并进行实名认证。 注册华为云后，如果需要对GES资源进行精细管理，请使用IAM服务创建IAM用户及用户组，并授权，以使得IAM用户获得具体的操作权限。具体内容请参考GES资源。 注册华为云账号 如果您已完成华为云账号注册，可跳过该步骤。
业务面API构造请求 本节介绍GES业务面REST API请求的组成。 请求URI 图引擎服务业务面API请求URI由如下部分组成。 {URI-scheme} :// {SERVER_URL} / {resource-path} ? {query-string} 尽管请求URI包
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于IAM获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对
简介 服务概述 图引擎服务（Graph Engine Service，简称GES），是针对以“关系”为基础的“图”结构数据，进行查询、分析的服务。广泛应用于社交关系分析、推荐、精准营销、舆情及社会化聆听、信息传播、防欺诈等具有丰富关系数据的场景。 开发指南概述 图引擎服务软件开发工具包（GES
查询Schema结构 功能介绍 查询生成的schema结构（从OBS上读取）。 URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/schema/structure?detail={details} 表1 路径参数 参数 是否必选
图引擎编辑器介绍 编辑器页面分为图分析区（包括探索区、操作区、元数据区、算法区、索引区）、绘图区、查询区、结果展示区、条件过滤及属性区。 图1 编辑器页面 表1 区域说明 区域名称 说明 探索区 提供图相关工具来探索图（例如：路经拓展），具体功能介绍请参考图探索功能。 操作区 通
Filtered-query V2(2.3.6) 功能介绍 第二代filtered query。支持filtered query API和repeat query API共同的功能。 该接口支持对多跳过滤查询，循环执行遍历查询进行加速。 例如以下gremlin语句： g.V('node1')
状态码 状态码如表1所示。 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。
查询点详情(1.0.0) 功能介绍 根据节点ID查询节点信息，返回节点详情，包括标签和属性等。 URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/detail?vertexIds={vertex_ids} 表1
查询边详情(1.0.0) 功能介绍 根据边的起点、终点以及索引，查询边的详细信息，返回边上的标签和属性等。 URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/edges/detail?source={sourceVertex}&
查询点详情 功能介绍 根据节点ID查询节点信息，返回节点详情，包括标签和属性等。 URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/detail?vertexIds={vertex_ids} 表1 路径参数 参数
大图访问 为了提高画布展示体验，您可以使用大图访问模式，对图数据进行处理和分析。 目前仅支持使用Cypher查询来进行大图访问和分析。 具体操作步骤如下： 登录图引擎服务管理控制台，在左侧导航栏中选择“图管理”。 在图管理页面，对需要进行分析的图，单击操作列中的“更多 > 大图访问”。
查询边详情 功能介绍 根据边的起点、终点以及索引，查询边的详细信息，返回边上的标签和属性等。 URI GET /ges/v1.0/{project_id}/graphs/{graph_name}/edges/detail?source={sourceVertex}&target=
查询job列表 功能介绍 异步任务jobId返回后，若jobId业务层丢失无法通过接口重新获取，现在提供一个新的接口用于查询engine中保存的所有异步任务，返回每个任务的jobId、job状态、原始请求。 图规格为持久化版的图，目前最多返回100000条请求。 URI GET /ges/v1
增量导入数据 操作场景 图引擎服务在创建图完成后可以导入图数据，或者当您需要新增图数据时，可以利用“导入”功能进行增量导入。 当前仅支持 1.1.8 以上版本的图的增量导入功能。 为防止系统重启时，不能正常恢复导入图数据，建议在使用图期间，不要删除存储在OBS中的数据。 数据列的分隔符默认为逗号，暂不支持自定义。
Filtered-query API(2.2.13) 功能介绍 对k跳过程进行逐层过滤，列出满足过滤条件的第k跳节点或边。 URI POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=filtered-query
执行Cypher查询 功能介绍 Cypher是一种被广泛使用的声明式图数据库查询语言，使用Cypher语句可以查询GES中的数据，并返回结果。当前的Cypher实现中使用了图的统计信息，目前Cypher查询编译过程中使用了基于label的点边索引，如需正常使用Cypher，请先参考Cypher预置条件构建索引。
执行事务Cypher 功能介绍 执行事务Cypher。 URI POST /ges/v1.0/{project_id}/graphs/{graph_name}/transaction/{commit} 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String
权限策略和授权项 如果您需要对您所拥有的GES服务进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用GES服务的其它功能。
执行Cypher查询 功能介绍 Cypher是一种被广泛使用的声明式图数据库查询语言，使用Cypher语句可以查询GES中的数据，并返回结果。当前的Cypher实现中使用了图的统计信息，目前Cypher查询编译过程中使用了基于label的点边索引，如需正常使用Cypher，请先参考Cypher预置条件构建索引。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
