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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api ，注意 API 地址不带 UTM 参数。
先说清楚三件套，这是所有工具配置的通用骨架：Base URL、API Key、Model ID。缺任何一个，调用都会失败。Base URL 填https://taotoken.net/api，API 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_seq=1，取第一个分隔符之前的部分；如果p_seq>1，取第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 sets：
V_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_name>>p_name>>p_cert>>差旅费>>办公费>>招待费>>，数据行是某某公司>>张三>>身份证001>>1200>>800>>0>>。如果列名里出现了_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 0=1改成RAISE，让错误暴露出来。
401 Unauthorized（AI 工具侧）。如果你在配置settings.json后调用模型报 401，先检查三件套：Base URL 是不是https://taotoken.net/api（不要带结尾斜杠）、API Key 有没有多余空格、Model ID 是不是当前账号可用的。Claude 系工具读ANTHROPIC_AUTH_TOKEN，OpenAI 系读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_grouping，p_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 拼接的作用」，确认模型能正常返回。两边都通，说明你的存储过程模板和工具配置都就位了。接下来就是按报表需求填参数，把重复劳动交给模板。
