大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:JSON_EACH_TEXT

· 52CE 我爱测

表函数将顶层 JSON 对象展开为一组键值对,每行包含一个键( )和对应的值( )。与 不同, 列的类型为 TEXT,字符串值在输出中**不保留** JSON 引号。

描述

json_each_text 表函数将顶层 JSON 对象展开为一组键值对,每行包含一个键(key)和对应的值(value)。与 json_each 不同,value 列的类型为 TEXT,字符串值在输出中不保留 JSON 引号。

该函数需配合 LATERAL VIEW 使用。

该函数自4.1.0起支持

语法

JSON_EACH_TEXT(<json_str>)

参数

参数 说明
<json_str> 需要展开的 JSON 字符串,内容应为 JSON 对象。

返回值

返回多列多行数据,每行对应 JSON 对象中的一个键值对:

列名 类型 说明
key TEXT JSON 对象的键名
value TEXT 对应的值,以文本形式返回(字符串值不带引号,如 foo)

特殊情况:

  • 如果 <json_str> 为 NULL,返回 0 行
  • 如果 <json_str> 为空对象({}),返回 0 行
  • JSON 值为 null 时,对应的 TEXT 值为 SQL NULL

示例

基本用法:展开包含字符串值的 JSON 对象

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text('{"a":"foo","b":"bar"}') t AS k, v;
+---+-----+
| k | v   |
+---+-----+
| a | foo |
| b | bar |
+---+-----+

value 列类型为 TEXT,字符串值不保留 JSON 引号(与 json_each 的区别)。

包含多种类型值的 JSON 对象

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text('{"str":"hello","num":42,"bool":true,"null_val":null}') t AS k, v;
+----------+-------+
| k        | v     |
+----------+-------+
| str      | hello |
| num      | 42    |
| bool     | true  |
| null_val | NULL  |
+----------+-------+

JSON 中的 null 值对应 SQL NULL。

NULL 参数:返回 0 行

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text(NULL) t AS k, v;
-- Empty set

空对象:返回 0 行

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text('{}') t AS k, v;
-- Empty set

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。