1. Oracle 行转列存储过程到底解决什么问题报表开发里最磨人的场景之一就是同一张明细表要按不同维度摊开成列。比如供应商费用表VI_GYS_PERFEE里每个供应商、每个证件、每个费用科目都是一行但业务方要的报表是「一行一个供应商费用科目横向铺开」。这种需求用静态 SQL 写每加一个科目就要改一次视图维护成本极高。Oracle 行转列存储过程的核心价值就是把「哪些列固定、哪些列要旋转、旋转后的列名从哪来」这三件事参数化。你传表名、固定列、旋转列、旋转值存储过程内部用动态 SQL 拼出decode或pivot语句返回一个REF CURSOR。Java 端拿到游标后直接遍历ResultSet列名就是旋转出来的科目名。适合谁用三类人最受益一是做数据报表平台、需要动态列的后端开发二是写 Oracle 存储过程做 ETL 的数据工程师三是维护老系统、表结构经常变但又不想频繁发版的同学。我试过在几个报表项目里用这套包最大的感受是「列名动态化」把改代码变成了改参数。这篇会交付三样东西一套可复制的pkg_dynamic_rows_column包模板、动态 SQL 拼接的关键片段解析、以及用 TaoToken 统一 Key 接入 AI 编码工具时的settings.json配置骨架。最后还会给一个验证动作确认你的调用链路是通的。需要先说明行转列本身是纯数据库能力和 AI 工具没有强绑定。但实际开发中你往往需要 AI 帮你补全存储过程、解释报错、生成 Java 调用代码这时候一个稳定的模型接入配置就很关键。下面会分两部分讲数据库部分和工具配置部分互不干扰你可以按需取用。2. TaoToken 统一 Key 接入前的准备与 settings.json 骨架在写存储过程的过程中我经常需要 AI 帮忙做几件事把一段decode拼接逻辑解释清楚、根据报错反推 SQL 哪里少了逗号、把 PL/SQL 翻译成 Java 调用。这些场景对模型的要求是「懂 SQL、能读长上下文」所以选一个稳定的接入方式是前提。TaoToken 在这里扮演的角色是统一 Key 网关你只需要一个 API Key就能在多个 AI 编码工具里复用同一套配置不用每个工具单独申请。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数。先说清楚三件套这是所有工具配置的通用骨架Base URL、API Key、Model ID。缺任何一个调用都会失败。Base URL 填https://taotoken.net/apiAPI Key 在控制台生成Model ID 按你实际要用的模型填。以 Claude Code 这类工具的settings.json为例配置骨架长这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }如果你用的是 Cline 或类似的 VS Code 插件配置通常写在插件的 settings 里字段名可能是baseUrl、apiKey、model但值是一样的{ cline.apiProvider: anthropic, cline.baseUrl: https://taotoken.net/api, cline.apiKey: sk-你的TaoToken密钥, cline.model: claude-sonnet-4-20250514 }Codex 系的工具会读auth.json结构略有不同{ OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-你的TaoToken密钥, OPENAI_MODEL: gpt-4o }这里有个坑要提前说ANTHROPIC_BASE_URL和OPENAI_BASE_URL不要混用Claude 系工具读前者OpenAI 系工具读后者。填错字段名工具会直接报 401 或者连接超时。另外 Key 不要提交到 Git建议放在本地环境变量或.env里settings.json只做引用。配置完成后先别急着写存储过程用一次最小请求验证链路。打开模型对话页面 https://taotoken.net/api-keys 确认 Key 有效然后在工具里发一句「用一句话解释 Oracle decode 的作用」能正常返回就说明三件套配对了。这一步花两分钟能省掉后面半小时的排查。3. 可复制的行转列存储过程模板与动态 SQL 拼接现在进入正题。下面这套包pkg_dynamic_rows_column是我整理过的版本包含一个打印过程、一个字符串分割函数、三个行转列过程。你可以整段复制到 SQL Developer 或 SQLPlus 里执行。先建包头CREATE OR REPLACE PACKAGE pkg_dynamic_rows_column AS TYPE refc IS REF CURSOR; PROCEDURE p_print_sql(p_txt VARCHAR2); FUNCTION f_split_str(p_str VARCHAR2, p_division VARCHAR2, p_seq INT) RETURN VARCHAR2; PROCEDURE p_rows_column( p_table IN VARCHAR2, p_keep_cols IN VARCHAR2, p_pivot_cols IN VARCHAR2, p_where IN VARCHAR2 DEFAULT NULL, p_refc IN OUT refc); PROCEDURE p_rows_column_real( p_table IN VARCHAR2, p_keep_cols IN VARCHAR2, p_pivot_col IN VARCHAR2, p_pivot_val IN VARCHAR2, p_where IN VARCHAR2 DEFAULT NULL, p_refc IN OUT refc); PROCEDURE p_rows_column_grouping( p_table IN VARCHAR2, p_keep_cols IN VARCHAR2, p_pivot_col IN VARCHAR2, p_pivot_val IN VARCHAR2, p_where IN VARCHAR2 DEFAULT NULL, p_group IN VARCHAR2 DEFAULT NULL, p_refc IN OUT refc); END; /包头里三个过程的分工要理解清楚。p_rows_column是「多列旋转」把多个列的值拼成列名适合列名由多字段组合的场景。p_rows_column_real是「单列转列名、单列转值」最常用比如把PARAVALUE里的科目名变成列名FEE_TOTAL变成列值。p_rows_column_grouping在real的基础上加了grouping sets支持合计行。包体里最关键的是f_split_str函数它负责把逗号分隔的列名字符串拆成数组。逻辑是如果p_seq1取第一个分隔符之前的部分如果p_seq1取第p_seq-1个和第p_seq个分隔符之间的部分。这个函数是后面所有动态拼接的基础写错了会导致列名错位。p_rows_column_real的核心拼接逻辑是这样的V_SQL : select || V_GROUP_BY || ,; FOR X IN 1 .. V_PIVOT.COUNT LOOP V_SQL : V_SQL || NVL(max(decode( || P_PIVOT_COL || , || CHR(39) || V_PIVOT(X) || CHR(39) || , || P_PIVOT_VAL || ,null)),0) as || V_PIVOT(X) || ,; END LOOP; V_SQL : RTRIM(V_SQL, ,);这段代码做了三件事先用select distinct把P_PIVOT_COL的所有值查出来放进V_PIVOT数组然后对每个值拼一个decode表达式把匹配的行值取出来最后用max聚合加group by固定列把多行压成一行。NVL(...,0)是为了让没有数据的科目显示 0 而不是 null。p_rows_column_grouping的区别在于把max换成了SUM并且支持grouping setsV_SQL : V_SQL || NVL(SUM(decode( || P_PIVOT_COL || , || CHR(39) || V_PIVOT(X) || CHR(39) || , || P_PIVOT_VAL || ,null)),0) as || V_PIVOT(X) || ,;调用时p_group传(COM_NAME ,P_NAME , P_CERT),(COM_NAME),()就会生成三个分组层级按供应商姓名证件、按供应商、以及总计。报表里的「合计」行就是这么来的。在 SQLPlus 里执行的话记得先开输出SET SERVEROUTPUT ON; DECLARE tt pkg_dynamic_rows_column.refc; BEGIN pkg_dynamic_rows_column.p_rows_column_real( VI_GYS_PERFEE, P_NAME, P_CERT, COM_NAME, PARAVALUE, FEE_TOTAL, null, tt); END; /Java 端调用p_rows_column_grouping的写法CallableStatement state conn.prepareCall( {call pkg_dynamic_rows_column.p_rows_column_grouping(?,?,?,?,?,?,?)}); state.setString(1, VI_GYS_PERFEE); state.setString(2, COM_NAME ,NVL(P_NAME,合计) , NVL(P_CERT,合计) ); state.setString(3, PARAVALUE); state.setString(4, FEE_TOTAL); state.setString(5, null); state.setString(6, (COM_NAME ,P_NAME , P_CERT),(COM_NAME),()); state.registerOutParameter(7, oracle.jdbc.OracleTypes.CURSOR); state.execute(); ResultSet rs (ResultSet) state.getObject(7);注意第 7 个参数是输出游标必须用registerOutParameter注册成OracleTypes.CURSOR否则getObject拿不到结果集。取列名用ResultSetMetaData.getColumnName取数据用rs.getString遍历方式和普通查询一样。4. 验证请求与成功结果从游标到报表列写完存储过程怎么确认它真的按预期工作分三步验证。第一步在数据库端单独跑一次看打印出来的 SQL。p_print_sql会把拼接好的 SQL 按 250 字符一段输出到DBMS_OUTPUT。你重点检查三处select后面的固定列有没有重复、decode里的列名有没有带引号、group by的字段和固定列是否一致。如果打印出来的 SQL 直接粘到 SQL Developer 里能跑通说明拼接逻辑没问题。第二步用 Java 调用并打印列名。下面这段代码是我常用的验证片段ResultSetMetaData metaData rs.getMetaData(); int cols metaData.getColumnCount(); StringBuilder name new StringBuilder(); for (int i 1; i cols; i) { name.append(metaData.getColumnName(i).toLowerCase()).append(); } System.out.println(name); while (rs.next()) { StringBuilder value new StringBuilder(); for (int i 1; i cols; i) { value.append(rs.getString(i)).append(); } System.out.println(value); }成功的输出应该长这样列名部分是com_namep_namep_cert差旅费办公费招待费数据行是某某公司张三身份证00112008000。如果列名里出现了_1、_2这种后缀说明你用的是p_rows_column而不是p_rows_column_real前者会在列名后加序号。第三步验证合计行。用p_rows_column_grouping时p_group传了()空集结果集最后会多出一行固定列显示为 null 或「合计」。如果你在p_keep_cols里用了NVL(P_NAME,合计)那这行的姓名列就会显示「合计」这正是报表需要的效果。这里有个细节p_rows_column_real里decode的列值默认用NVL(...,0)所以没有数据的科目显示 0。但如果你希望显示 null把NVL去掉即可。两种展示方式没有对错看业务方习惯。验证通过后建议把这次调用的参数记下来比如表名、固定列、旋转列、旋转值、where 条件。下次换一张表只改这几个参数就能复用不用重写存储过程。这就是「整理」的意义——把一次性的 SQL 变成可配置的模板。5. 常见报错排查401、ORA-00904 与游标为空实际用下来报错集中在几个地方我按出现频率排一下。ORA-00904: invalid identifier。这个最常见通常是动态 SQL 里列名拼错或少了引号。比如decode里的中文科目名没加CHR(39)生成的 SQL 变成decode(PARAVALUE,差旅费,...)Oracle 会把「差旅费」当成列名去找自然找不到。排查方法先看p_print_sql打印的完整 SQL把decode部分单独复制出来跑报错位置一目了然。ORA-00979: not a GROUP BY expression。这是select里的非聚合列没有全部出现在group by里。p_rows_column_real里固定列既出现在select也出现在group by一般不会错。但如果你手动改了p_keep_cols比如加了NVL(P_NAME,合计)而group by里还是原始P_NAME就会报这个错。解决方法是让select和group by用同一个表达式。游标返回空结果集。Java 端rs.next()一直返回 false但数据库里明明有数据。这种情况多半是p_where参数拼错了。注意p_where需要带where关键字比如传 where FEE_TOTAL 0而不是FEE_TOTAL 0。包体里是直接拼接P_WHERE的少了关键字就变成from VI_GYS_PERFEE FEE_TOTAL 0语法错误被EXCEPTION WHEN OTHERS吞掉返回一个空游标。所以调试阶段建议把异常处理里的OPEN P_REFC FOR SELECT x FROM DUAL WHERE 01改成RAISE让错误暴露出来。401 UnauthorizedAI 工具侧。如果你在配置settings.json后调用模型报 401先检查三件套Base URL 是不是https://taotoken.net/api不要带结尾斜杠、API Key 有没有多余空格、Model ID 是不是当前账号可用的。Claude 系工具读ANTHROPIC_AUTH_TOKENOpenAI 系读OPENAI_API_KEY字段名填错也会 401。另外注意ANTHROPIC_BASE_URL和OPENAI_BASE_URL不要同时配工具可能读错。local proxy failed / connection refused。这类报错通常是本地网络或工具代理设置问题不是 Key 的问题。检查工具是否配置了额外的代理地址把它清空让请求直连 Base URL。如果公司网络有限制换一个网络环境再试。OAuth 相关报错。部分工具首次使用会走 OAuth 流程如果你已经用 API Key 配置需要在工具设置里关掉 OAuth 登录选项否则它会优先走 OAuth 导致冲突。具体开关位置各工具不同一般在「认证方式」里选「API Key」而不是「OAuth」。排查顺序建议先看数据库端打印的 SQL 能不能单独跑通再看 Java 端游标有没有数据最后才怀疑 AI 工具配置。数据库问题和工具配置问题分开定位不要混在一起查。6. 把模板用起来从单表到多场景的复用路径这套包整理完之后我在几个报表场景里复用过路径基本一致先确认源表的「固定维度」和「旋转维度」固定维度就是报表每行要保留的字段旋转维度就是要在横向铺开的字段。然后调p_rows_column_real或p_rows_column_grouping把参数填进去看打印的 SQL 是否符合预期。如果报表需要多级合计用p_rows_column_groupingp_group按「明细→小计→总计」的顺序传。如果只是简单摊开用p_rows_column_real就够了。如果列名需要多个字段组合比如「科目月份」用p_rows_column的多列旋转版本。一个实用技巧把常用的调用参数写成一个配置表比如RPT_PIVOT_CONFIG字段存表名、固定列、旋转列、旋转值、where 条件。存储过程从配置表读参数这样新增报表只需要插一行配置不用改代码。这是从「存储过程」走向「报表引擎」的关键一步。至于 AI 工具这边配置好settings.json之后你可以让模型帮你做几件事把新的报表需求翻译成p_rows_column_real的调用参数、根据 ORA 报错定位拼接问题、把 PL/SQL 逻辑转成 Java 调用代码。这些任务对模型来说都是「读代码改代码」用统一 Key 接入后换工具不用重新配 Key省事。最后给一个验证动作收尾在数据库端跑一次p_rows_column_real把打印的 SQL 复制到 SQL Developer 执行确认列名和值都对然后在 AI 工具里发一句「解释这段 decode 拼接的作用」确认模型能正常返回。两边都通说明你的存储过程模板和工具配置都就位了。接下来就是按报表需求填参数把重复劳动交给模板。