使用HyG算法分析图

前提条件

前端创建持久化版图时，选择开启HyG计算引擎。

图1 HyG计算引擎

操作步骤

1. 创建HyG图。
   1. 发送“POST /ges/v1.0/{project_id}/hyg/{graph_name}”，project_id为项目ID，graph_name为图数据库中已创建的图名。
   2. 在Request Header中增加“X-Auth-Token”。
   3. 在Request Body中传入参数如下：

      {
          "inEdge": true  //图是否包含入边
      }

   4. 查看请求响应结果。请求成功时，响应参数如下：

      {
          "result": "success"
      }

      请求异常时，错误码请参见错误码。

2. HyG图数据同步，将图数据库的数据同步到HyG计算引擎。
   1. 发送“POST /ges/v1.0/{project_id}/hyg/{graph_name}/sync”，project_id为项目ID，graph_name为图名。
   2. 在Request Header中增加“X-Auth-Token”。
   3. 在Request Body中传入参数如下：

      {
          "vertex": [],  //点属性列表
       
          "edge": [
              {
                  "property": [
                      "Rating"
                  ],
                  "label": "rate"
              }
          ]  //边属性列表
      }

   4. 根据JobId查看请求响应结果。请求成功时，响应参数如下：

      {
          "status": "complete",
          "result": "success"
      }

      请求异常时，错误码请参见错误码。

      如果对图数据库执行了增、删、改操作，使用该接口可以将图数据库的修改信息同步到HyG计算引擎。首次执行数据同步时，请求body里面的vertex和edge参数生效，后续执行数据同步，该参数默认跟首次指定的保持一致。

3. 查询HyG图详情。
   1. 发送“GET /ges/v1.0/{project_id}/hyg/{graph_name}/summary”，project_id为项目ID，graph_name为图名。
   2. 在Request Header中增加“X-Auth-Token”。
   3. 查看请求响应结果。请求成功时，响应参数如下：

      {
          "data": {
              "inEdge": true,
              "idIndex": true,
              "policy": "oec",
              "updateTime": "2024-01-25 10:55:31",
              "vertex": [],
              "edge": [
                  {
                      "label": "rate",
                      "property": [
                          "Rating"
                      ]
                  }
              ],
              "vertexNum": 146,
              "edgeNum": 1659
          },
          "result": "success"
      }

      请求异常时，错误码请参见错误码。

4. 执行算法
   1. 发送“POST /ges/v1.0/{project_id}/hyg/{graph_name}/algorithm”，project_id为项目ID，graph_name为图名。
   2. 在Request Header中增加“X-Auth-Token”。
   3. 在Request Body中传入参数如下（以pagerank为例）。

      {
      "algorithmName":"pagerank",
        "parameters":{
              "alpha":0.85,
              "convergence":0.00001,
              "max_iterations":1000,
              "directed":true
        }
      }

   4. 根据JobId查看请求响应结果。请求成功时，响应参数如下：

      {
          "status": "complete",
          "data": {
              "outputs": {
                  "data_offset": 0,
                  "data_return_size": 147,
                  "data_total_size": 147,
                  "pagerank": [
                      {
                          "38": 0.02115960730038959
                      },
                      {
                          "13": 0.018535705068819635
                      },
                      {
                          "7": 0.0166381431701182
                      },
                      … …
                  ],
                  "runtime": 0.022
              }
          },
          "result": "success"
      }

      请求异常时，错误码请参见错误码。

5. 删除HyG图。
   1. 发送“DELETE /ges/v1.0/{project_id}/hyg/{graph_name}”，project_id为项目ID，graph_name为图名。
   2. 在Request Header中增加“X-Auth-Token”。
   3. 根据jobId查看请求响应结果。请求成功时，响应参数如下：

      {
          "status": "complete",
          "result": "success"
      }

      请求异常时，错误码请参见错误码。