Statement Execution Action

Statement Execution Action

Request

POST /api/query/<ns_name>/<db_name>

Description

Statement Execution Action 用于执行语句并返回结果。

Path parameters

• <db_name>

  指定数据库名称。该数据库会被视为当前session的默认数据库，如果在 SQL 中的表名没有限定数据库名称的话，则使用该数据库。

Query parameters

无

Request body

{
    "stmt" : "select * from tbl1"
}

• sql 字段为具体的 SQL

Response

• 返回结果集

  {
      "msg": "success",
      "code": 0,
      "data": {
          "type": "result_set",
          "data": [
              [1],
              [2]
          ],
          "meta": [{
              "name": "k1",
              "type": "INT"
          }],
          "status": {},
          "time": 10
      },
      "count": 0
  }
  • type 字段为 result_set 表示返回结果集。需要根据 meta 和 data 字段获取并展示结果。meta 字段描述返回的列信息。data 字段返回结果行。其中每一行的中的列类型，需要通过 meta 字段内容判断。status 字段返回 MySQL 的一些信息，如告警行数，状态码等。time 字段返回语句执行时间，单位毫秒。

• 返回执行结果

  {
      "msg": "success",
      "code": 0,
      "data": {
          "type": "exec_status",
          "status": {},
          "time": 10
      },
      "count": 0
  }
  • type 字段为 exec_status 表示返回执行结果。目前收到该返回结果，则都表示语句执行成功。