执行GQL查询

功能介绍

图查询语言（Graph Query Language）简称GQL，是声明式查询语言，其核心语法类似Cypher，可以使用GQL查询GES中的数据，并返回结果。GQL查询详细介绍请参考GQL语法说明。

URI

请求参数

1. 在语句前可以添加explain和profile前缀，用于显示查询计划： explain只显示查询计划，不执行语句；profile显示查询计划，并执行语句。
2. 在异步模式（executionMode参数值为async）下，内存版支持GQL查询结果以csv格式导出到文件。目前支持下列对象的返回：点边单值属性、点边id、分组计数结果等值类型。对于对象类型，目前的版本暂不支持导出，csv中视作空值处理，详情参考导出job返回结果到文件。

响应参数

请求示例

POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=execute-gql-query
{
	"statements": [{
		"statement": "match (n) return n limit 1",
        "runtime":"block",
		"parameters": {},
		"resultDataContents": ["raw"]
	}],
    "includeStats": true
}

响应示例

• 同步任务请求成功样例

  状态码：200

  Http Status Code: 200
  {
      "results": [
          {
              "columns": ["n"],
              "data": [
                  {
                      "row": [
                          {
                              "occupation": "artist",
                              "gender": "F",
                              "Zip-code": "98133",
                              "userid": 0,
                              "age": "25-34"
                          }
                      ],
                      "meta": [
                          {
                              "id": "46",
                              "type": "node",
                              "labels": [
                                  "user"
                              ]
                          }
                      ]
                  }
              ],
              "stats": {
                  "contains_updates": false,
                  "edges_created": 0,
                  "edges_deleted": 0,
                  "labels_set": 0,
                  "properties_set": 0,
                  "vertices_created": 0,
                  "vertices_deleted": 0
              }
          }
      ],
      "errors": []
  }

• 异步任务请求成功样例

  状态码：200

  Http Status Code: 200
  {
      "results": [
          {
              "columns": ["n"],
              "data": [
                  {
                      "row": [
                          {
                              "occupation": "artist",
                              "gender": "F",
                              "Zip-code": "98133",
                              "userid": 0,
                              "age": "25-34"
                          }
                      ],
                      "meta": [
                          {
                              "id": "46",
                              "type": "node",
                              "labels": [
                                  "user"
                              ]
                          }
                      ]
                  }
              ],
              "stats": {
                  "contains_updates": false,
                  "edges_created": 0,
                  "edges_deleted": 0,
                  "labels_set": 0,
                  "properties_set": 0,
                  "vertices_created": 0,
                  "vertices_deleted": 0
              }
          }
      ],
      "errors": []
  }

状态码： 400

Http Status Code: 200
{
    "results": [],
    "errors": [
        {
            "code": "GES.8904",
            "message": "Label index in vertices is not found."
        }
    ]
}

状态码