Doris 2.1 版本(原生支持json_each函数),但该函数无法使用,核心原因是FE 节点的功能开关未开启(Doris 2.x 部分 JSON 高级函数默认关闭,需手动配置启用),而非版本不兼容。
一、先排查:确认json_each函数是否可见
先执行 SQL 查看 Doris 是否加载了json_each函数,判断是配置问题还是语法问题:
sql
-- 查看所有JSON相关函数,确认json_each是否存在
SHOW FUNCTIONS LIKE '%json_each%';
- 若查询结果为空:说明功能未启用,需按下面步骤配置。
- 若查询到
json_each函数:说明是语法问题,直接跳至 "三、语法修正:2.1 版本 json_each 正确用法"。
二、启用json_each:配置 FE 功能开关
json_each属于 Doris 的高级 JSON 函数 ,需在 FE 节点开启enable_vectorized_engine和enable_json_function配置(2.1 版本默认可能关闭),步骤如下:
步骤 1:登录 FE 节点服务器
# 进入FE安装目录的conf文件夹(替换为你的实际路径)
cd /opt/apache-doris/fe/conf
步骤 2:修改 fe.conf 配置文件
编辑fe.conf,添加或修改以下配置项:
# 启用向量化引擎(json_each依赖该引擎)
enable_vectorized_engine = true
# 启用高级JSON函数(显式开启json_each等功能)
enable_json_function = true
# 可选:若仍无法使用,添加该配置(兼容部分2.1版本)
enable_experimental_json_function = true
步骤 3:重启 FE 节点(使配置生效)
# 进入FE的bin目录
cd /opt/apache-doris/fe/bin
# 停止FE(若为集群部署,先停止其他FE,最后停止leader节点)
./stop_fe.sh
# 启动FE
./start_fe.sh --daemon
步骤 4:验证配置是否生效
重启 FE 后,重新连接 Doris,执行以下 SQL:
-- 再次查看json_each函数
SHOW FUNCTIONS LIKE '%json_each%';
-- 测试基础json_each功能
SELECT * FROM dual
LATERAL VIEW json_each('{"a":1, "b":2}') j;
若能查询到json_each函数,且测试 SQL 正常返回结果,说明功能已启用。
Doris 2.1 版本中,json_each依赖向量化引擎 和JSON 高级功能开关,默认可能关闭,需手动配置启用。