Filtered-query V2(2.3.6)

功能介绍

第二代filtered query。支持filtered query API和repeat query API共同的功能。

该接口支持对多跳过滤查询，循环执行遍历查询进行加速。

例如以下gremlin语句：

g.V('node1').repeat(out('label_2')).emit()

URI

请求参数

每层traversal的元素个数不超过1亿。

响应参数

• 同步返回

  表10 响应Body参数说明

  参数	类型	说明
  errorMessage	String	系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。
  errorCode	String	系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。
  data	Object	查询结果。查询失败时，字段为空。

  表11 data参数说明

  参数	类型	说明
  vertices	List	点的结果集合。filters最后一层为点过滤时，data中将包含vertices。
  edges	List	边的结果集合。filters最后一层为边过滤时，data中将包含edges。

• 异步返回

  表12 响应Body参数说明

  参数	类型	说明
  errorMessage	String	系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。
  errorCode	String	系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。
  job_id	String	执行算法任务ID。请求失败时，该字段为空。
  jobType	Integer	任务类型。请求失败时，该字段为空。

请求示例

• 请求样例1：列出满足过滤条件的第k跳节点或边，查询类型是出点，作用在下一跳的点上。

  POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=path-query
   {
     "repeat":[
       {
         "operator":"outV",
         "vertex_filter":{
           "property_filter":{
             "leftvalue":{
               "label_name":"labelName"
             },
             "predicate":"=",
             "rightvalue":{
               "value":"rate"
             }
           }
         }
       }
     ],
     "times":2,
     "vertices":[
       "1","2"
     ]
   }

  

  以上请求等价于gremlin语句：g.V('1','2').repeat(out().hasLabel('rate')).times(2).dedup()

• 请求样例2：列出满足过滤条件的第k跳节点或边，查询类型是出点，作用在下一跳的点上。

  POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=path-query
   {
     "repeat":[
       {
         "operator":"outV",
         "vertex_filter":{
           "property_filter":{
             "leftvalue":{
               "label_name":"labelName"
             },
             "predicate":"=",
             "rightvalue":{
               "value":"rate"
             }
           }
         }
       }
     ],
     "until":[
       {
         "vertex_filter":{
           "property_filter":{
             "leftvalue":{
               "property_name":"movieid"
             },
             "predicate":"=",
             "rightvalue":{
               "value":"1"
             }
           }
         }
       }
     ],
     "vertices":[
       "v1","v2"
     ]
   }

  

  以上请求等价于gremlin语句：

  g.V('v1','v2').repeat(out().hasLabel('rate')).until(has('movieid','1')).dedup()

响应示例

• 同步返回

  状态码： 200

  成功响应示例

  {
       "data":{
           "vertices":[
               {
                   "id":"51",
                   "label":"user",
                   "properties":{
                       "occupation":[
                           "homemaker"
                       ],
                       "gender":[
                           "F"
                       ],
                       "Zip-code":[
                           "46911"
                       ],
                       "userid":[
                           5
                       ],
                       "age":[
                           "56+"
                       ]
                   }
               }
           ]
       }
   }

  状态码： 400

  失败响应示例

  Http Status Code: 400
  {
      "errorMessage": "graph [tesdt_117] is not found",
      "errorCode": "GES.8806"
  }

状态码

错误码

请参见错误码。