AsyncSqlResponseData

名称

类型

描述

示例值

object

异步 SQL 返回的数据结构

id

string

异步 SQL 的 ID

690C4F2A16FBD65C40000484_14

state

string

异步 SQL 的当前执行状态,可以为以下三个状态:

  • RUNNING

  • FINISHED

  • FAILED

  • CANCELLED

其中,RUNNING 是临时状态, 表示 SQL 还在执行过程中。仅当状态为 FINISHED 时,才表示请求执行成功,可以读取结果了。另外,只有状态为 FAILED 时,返回结果中的 error_code 和 error_message 才有意义。

FINISHED

AsyncSqlMetaPB

object

SQL 相关的 meta 信息

result_rows

integer

结果总行数。读取结果是,offset 值不应该超过这个值。

12000

processed_rows

integer

处理的原始数据行数

10000000

elapsed_milli

integer

SQL 执行时间(毫秒)

30000

cpu_sec

number

消耗的 cpu 总时间(秒)

0.2

cpu_cores

integer

使用了多少个 cpu core

10

progress

string

SQL 结果是否精确,它可以为以下两个值:

  • Complete (表示结果精确)

  • Incomplete (表示结果不精确)

Complete

keys

array

SQL 结果对应的 column 名称,这里的 keys 和 select 中的字段是一一对应的。

string

column 名称

["name", "age", "gender"]

rows

array

SQL 结果。array 中的每个元素也是数组,对应具体的一行结果。

array

某行结果

string

某列结果

["Jimmy", "20", "male"]

error_code

string

SQL 执行失败后,error_code 中包含了具体的错误码

InvalidQuery

error_message

string

SQL 执行失败后,error_message 中包含了具体的错误信息

line 37:14: Column 'xyz' cannot be resolved