EXPLAIN OUTPUT

更新时间:
复制 MD 格式

EXPLAIN OUTPUT语句用于返回指定查询语句输出结果的元数据信息,本文介绍EXPLAIN OUTPUT的语句功能、命令格式及使用示例。

功能介绍

EXPLAIN OUTPUT语句用于返回指定查询语句输出结果的元数据信息。该功能可在执行查询前,快速了解查询结果所包含的字段列名及其对应的数据类型,从而更高效地进行数据开发、接口对接或结果验证。

命令格式

EXPLAIN OUTPUT <dml query>;

dml query:必填。SELECT语句,更多信息请参见SELECT语法

返回说明

返回指定查询语句输出结果的元数据信息,包含输出的字段列名(name)和字段类型(type)。

同时,支持通过设置SET odps.sql.select.output.format=json; ,以json格式输出字段列名(name)和字段类型(type)。

使用示例

示例1:返回默认表格格式的元数据信息

使用EXPLAIN OUTPUT语句,返回默认表格格式的元数据信息。

EXPLAIN OUTPUT SELECT
TO_TIME(15, 30, 0) AS time,
GET_JSON_OBJECT(JSON '{"name": "Alice", "age": 30}', '$.name') AS user
;

返回结果如下:

name type
------------
time BIGINT
user STRING

示例2:JSON格式输出元数据信息

通过设置SET odps.sql.select.output.format=json;,以JSON格式输出字段列名和字段类型。

SET odps.sql.select.output.format=json;
EXPLAIN OUTPUT SELECT
TO_TIME(15, 30, 0) AS time,
GET_JSON_OBJECT(JSON '{"name": "Alice", "age": 30}', '$.name') AS user
;

返回结果如下:

{"columns":[{"name":"time","type":"BIGINT"},{"name":"user","type":"STRING"}]}