JSON_TABLE的COLUMNS子句能否使用NVARCHAR2？PL/SQL执行报ORA-40484

• ORA-40484是JSON_TABLE函数的硬性校验报错，代表COLUMNS子句中使用了函数不支持的列类型。从Oracle引入JSON_TABLE功能开始，其COLUMNS定义仅原生支持VARCHAR2、CLOB、NUMBER、DATE等类型，不允许直接在列声明中使用NVARCHAR2类型，这不是代码语法错误，是函数本身的设计限制。
• 叠加当前数据库环境的问题：NLS_CHARACTERSET取值为EE8ISO8859P2，这是单字节编码的东欧拉丁字符集，本身没有覆盖西里尔字母这类字符，即使绕开类型限制直接用VARCHAR2承接JSON值，解析过程中会触发编码转换，最终提取的多语言字符会变成替换乱码，无法完成正常匹配。

核心是绕开两个限制：一是规避JSON_TABLE不支持NVARCHAR2列定义的校验，二是跳过解析过程中数据库单字节字符集的编码转换，完整保留多语言字符。

调整后可运行的实现方式 #

1. 把原本是NVARCHAR2类型的JSON源内容转换为BLOB格式，显式告知JSON解析器按照AL16UTF16（UTF-16）编码读取内容，彻底绕开解析环节的数据库字符集转换，从根源上避免多语言字符丢失。
2. COLUMNS子句中仅使用JSON_TABLE原生支持的VARCHAR2类型做路径值提取，等值拿到之后，再通过TO_NVARCHAR2()做显式类型转换，得到目标的NVARCHAR2类型结果，既不会触发ORA-40484报错，也能匹配PL/SQL变量的类型要求。

调整后的测试代码 #

SET SERVEROUTPUT ON
DECLARE
  sample_json   NVARCHAR2(111):= '[{"NAME":"ĄŚĆĘąśćę"},{"NAME":"ЙйКкЛлМм"}]';
  part          NVARCHAR2(111);
  -- 承接转码后的JSON二进制内容
  json_blob     BLOB;
BEGIN
  -- 将NVARCHAR2字符串转为原始二进制，供JSON解析器按UTF-16读取
  json_blob := UTL_RAW.CAST_TO_RAW(sample_json);

  SELECT TO_NVARCHAR2(j.name) INTO part
  FROM JSON_TABLE(
    json_blob FORMAT JSON ENCODING AL16UTF16,
    '$[*]' COLUMNS 
      name VARCHAR2(100) PATH '$.NAME'
  ) j
  -- 对提取的VARCHAR2值做同类型转换，保证比对时字符集一致
  WHERE TO_NVARCHAR2(j.name) = 'ЙйКкЛлМм';

  DBMS_OUTPUT.PUT_LINE('提取匹配结果：' || part);
END;

关键注意事项 #

• 不要为了适配字符集直接修改数据库全局的NLS_CHARACTERSET参数，该操作风险极高，极易导致全库历史数据编码损坏，属于生产环境高风险操作，完全没必要。
• 如果JSON提取的内容长度超过VARCHAR2的存储上限，可以把COLUMNS中的提取列类型换成CLOB，后续搭配TO_NCLOB()转换为NCLOB类型承接长文本，实现逻辑完全一致。
• 该兼容写法在Oracle 12.2及以上正式版本均可运行，不需要额外安装补丁。

内容的提问来源于stack exchange，提问作者Krzysztof Foryś