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

Apache Doris 中文参考:SORT_JSON_OBJECT_KEYS

· 52CE 我爱测

函数对 JSON 对象的键进行排序。该函数接受一个 JSON 对象作为输入,并返回一个新的 JSON 对象,其中键按字典顺序排序。

描述

SORT_JSON_OBJECT_KEYS 函数对 JSON 对象的键进行排序。该函数接受一个 JSON 对象作为输入,并返回一个新的 JSON 对象,其中键按字典顺序排序。

需要注意的是,根据 JSON 标准,JSON 对象是无序的集合。然而,此函数可以在需要确保键顺序一致时使用,例如在比较两个 JSON 对象是否包含相同内容时。

语法

SORT_JSON_OBJECT_KEYS(json_value)

别名

SORT_JSONB_OBJECT_KEYS

参数

json_value - 需要对键进行排序的 JSON 值。必须是 JSON 类型。

返回值

返回一个新的 JSON 对象,其中键按字典顺序排序。返回类型与输入的 JSON 类型相同。

当输入为 NULL 时,函数返回 NULL。

示例

基本键排序

SELECT sort_json_object_keys(cast('{"b":123,"b":456,"a":789}' as json));
+------------------------------------------------------------------+
| sort_json_object_keys(cast('{"b":123,"b":456,"a":789}' as json)) |
+------------------------------------------------------------------+
| {"a":789,"b":123}                                                |
+------------------------------------------------------------------+

处理嵌套 JSON 数组

SELECT sort_json_object_keys(cast('[{"b":123,"b":456,"a":789},{"b":123},{"b":456},{"a":789}]' as json));
+----------------------------------------------------------------------------------------------------+
| sort_json_object_keys(cast('[{"b":123,"b":456,"a":789} ,{"b":123},{"b":456},{"a":789} ]' as json)) |
+----------------------------------------------------------------------------------------------------+
| [{"a":789,"b":123},{"b":123},{"b":456},{"a":789}]                                                  |
+----------------------------------------------------------------------------------------------------+

处理 NULL 值

SELECT sort_json_object_keys(null);
+-----------------------------+
| sort_json_object_keys(null) |
+-----------------------------+
| NULL                        |
+-----------------------------+

注意事项

  1. SORT_JSON_OBJECT_KEYS 函数有一个别名 SORT_JSONB_OBJECT_KEYS,两者功能完全相同。

  2. 此函数仅排序对象的键,而不会修改键对应的值。

  3. 只会排序对象而不会排序数组,因为标准规定数组是一个有序的集合。

  4. JSON 对象中的重复键会在转换为 Doris 的 JSON 类型时进行合并,仅保留第一个键值对。

  5. 此函数主要用于确保 JSON 对象的键以一致的顺序呈现,便于比较或调试,因为默认情况下 Doris 的 JSON 类型不保证键的顺序。

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

资料来源与适用范围

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

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

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