Pentaho Kettle执行Oracle SQL报ORA-01843无效月份但PL/SQL运行正常问题

这个报错的核心是会话级日期格式参数不匹配，PL/SQL客户端与Pentaho连接Oracle时的会话NLS参数不一致，导致字符串转日期的隐式转换逻辑存在差异：

• 隐式日期转换依赖问题：你的SQL或存储过程中存在未用TO_DATE()指定格式掩码的字符串转日期逻辑，例如直接写where date_col = '2024-01-01'，此时Oracle会自动读取当前会话的NLS_DATE_FORMAT参数做隐式转换，不同客户端的参数值不同就会触发报错。
• Pentaho会话默认NLS参数规则：Pentaho连接Oracle时默认从JVM的区域设置读取日期格式，不会继承Oracle数据库或PL/SQL客户端的配置。例如PL/SQL会话的NLS_DATE_FORMAT为YYYY-MM-DD，而Pentaho的JVM如果为英文环境，默认格式可能是DD-MON-RR，碰到带数字月份的日期字符串就会抛出ORA-01843: not a valid month错误。
• 存储过程执行上下文差异：你单独在PL/SQL中运行存储过程时，使用的是当前PL/SQL会话的NLS参数，而Pentaho调用存储过程时，使用的是Pentaho独立建立的会话参数，因此哪怕存储过程逻辑完全一致，执行上下文的参数不同仍然会触发报错。

解决方案 #

• 最优方案：消除所有隐式日期转换，把所有字符串转日期的逻辑都显式指定格式掩码，例如将date_col = '2024-01-01'修改为date_col = TO_DATE('2024-01-01', 'YYYY-MM-DD')，该方案不受任何客户端参数影响，稳定性最高。
• 临时适配方案：如果不想修改现有SQL/存储过程逻辑，可以强制设置Pentaho会话的NLS参数，在Pentaho的数据库连接配置中找到「高级」选项，添加初始化执行的SQL：

ALTER SESSION SET NLS_DATE_FORMAT = 'YYYY-MM-DD';
-- 如果涉及月份英文名称的转换，同步设置日期语言参数
ALTER SESSION SET NLS_DATE_LANGUAGE = 'SIMPLIFIED CHINESE';

确保参数值和你PL/SQL客户端的会话参数保持一致即可。

内容的提问来源于stack exchange，提问作者Fagner Rotter