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

Apache Doris 中文参考:JSON_EACH_TEXT_OUTER

· 52CE 我爱测

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

描述

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

与 json_each_text 的区别在于:当输入为 NULL 或空对象时,json_each_text_outer 返回一行 NULL, NULL,而 json_each_text 返回 0 行。

该函数需配合 LATERAL VIEW 使用。

该函数自4.1.0起支持

语法

JSON_EACH_TEXT_OUTER(<json_str>)

参数

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

返回值

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

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

特殊情况:

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

示例

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

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

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

NULL 参数:返回 1 行 NULL

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text_outer(NULL) t AS k, v;
+------+------+
| k    | v    |
+------+------+
| NULL | NULL |
+------+------+

空对象:返回 1 行 NULL

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text_outer('{}') t AS k, v;
+------+------+
| k    | v    |
+------+------+
| NULL | NULL |
+------+------+

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

资料来源与适用范围

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

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

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