1. OLTP 高并发下硬解析飙升的真实场景cursor_sharing这个参数很多做 Oracle 运维的朋友第一次注意到它往往不是因为主动去查文档而是被 AWR 报告里那条陡峭的parse count (hard)曲线逼着回头找原因。我遇到过一个典型的交易类库白天业务高峰时library cache的 latch 争用明显parse time cpu占比异常翻到 Top SQL 一看几百条结构几乎一样的语句只是where后面的字面量不同每条都各自占了一份游标。这就是典型的「字面量 SQL 泛滥」——应用层没有用绑定变量数据库只能一遍遍硬解析。cursor_sharing能做什么它决定了 Oracle 在什么条件下允许不同的 SQL 语句共享同一个游标cursor也就是共享同一份执行计划。它有三个取值EXACT、FORCE、SIMILAR。默认是EXACT只有 SQL 文本完全一致才共享FORCE会把语句里的字面量替换成系统绑定变量形如:SYS_B_0让结构相同的语句共享游标SIMILAR则介于两者之间行为还跟列上有没有直方图histogram有关。它适合谁适合那些短期内没法改应用代码、但又被硬解析和共享池压力困扰的 DBA也适合正在做 SQL 审核、想搞清楚「为什么这条语句没复用游标」的开发者。但要注意cursor_sharing不是万能药它是一把双刃剑用好了能压住硬解析用不好会让执行计划变得不可控甚至让本该走索引的查询走成全表扫描。这篇文章我会从实际场景出发把三种取值的差异、可复制的查询与修改 SQL、AWR 对比验证步骤讲清楚同时说明怎么用 TaoToken 统一 Key/API 通道把多环境数据库连接凭据集中管起来避免明文密码散落在各个脚本和配置文件里。整个思路是先看清问题再动手改参数最后用数据验证效果。先说清楚一个前提cursor_sharing是可以在会话级和系统级动态修改的ALTER SESSION和ALTER SYSTEM都支持。这意味着你可以在测试会话里先试确认没问题再推到系统级。但系统级修改会影响所有会话生产环境务必谨慎最好配合 AWR 快照做前后对比。另外要理解「硬解析」和「软解析」的区别。硬解析是数据库第一次见到某条 SQL需要做语法分析、语义分析、生成执行计划开销大软解析是 SQL 文本已经存在于共享池直接复用已有游标开销小得多。cursor_sharing的核心作用就是把「文本不同但结构相同」的语句在解析阶段归一化从而把硬解析降级成软解析。理解了这一点后面三种取值的差异就很好懂了。2. TaoToken 统一 Key 接入多环境数据库凭据集中管理在动手改cursor_sharing之前我想先聊一个容易被忽略但很现实的问题多环境数据库连接凭据的管理。做 Oracle 运维的人手里往往不止一套库——开发、测试、预发、生产每套库的账号密码、连接串都不一样。这些凭据经常散落在各种地方SQLPlus 脚本里、Python 连接代码里、AWR 采集工具的配置里、甚至同事之间口口相传的聊天记录里。明文散落带来的风险不用多说一旦某个脚本被提交到代码仓库密码就泄露了。TaoToken 提供的是一个统一的 Key/API 通道可以把这些分散的连接凭据集中管理起来。它的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你可以把它理解成一个「凭据中转站」各个环境、各个工具不再各自保存明文密码而是通过统一的 Key 去换取访问权限。具体怎么用假设你有一个采集 AWR 的 Python 脚本原本连接串是硬编码的# 改造前明文散落风险高 dsn sys/oracle123prod-db:1521/ORCL改造后连接信息从 TaoToken 统一获取脚本里只保留一个 Key 的引用# 改造后凭据集中管理 import os import requests TAOTOKEN_API https://taotoken.net/api TAOTOKEN_KEY os.environ.get(TAOTOKEN_KEY) def get_db_credential(env_name): resp requests.get( f{TAOTOKEN_API}/credentials/{env_name}, headers{Authorization: fBearer {TAOTOKEN_KEY}} ) resp.raise_for_status() return resp.json() cred get_db_credential(prod-oracle) dsn f{cred[user]}/{cred[password]}{cred[host]}:{cred[port]}/{cred[service]}这样做的直接好处是密码不再出现在代码里轮换密码时只需要在 TaoToken 侧更新一次所有引用它的脚本自动生效。对于需要频繁切换环境做cursor_sharing对比测试的场景这一点尤其省事——你不用在多个连接串之间来回改。如果你用的是 Claude Code 这类编码助手来写运维脚本也可以通过 TaoToken 的 Coding Plan 通道接入让助手在生成连接代码时直接引用统一 Key而不是每次都要你手动填密码。Coding Plan 的入口在 https://taotoken.net/api/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。需要说明的是TaoToken 在这里扮演的是凭据管理和 API 通道的角色它不替代你的数据库客户端也不替代 SQLPlus 或任何编辑器数据库操作本身还是在你自己的环境里完成。把凭据管理这件事理顺之后我们再回到cursor_sharing本身。因为接下来的对比测试需要在不同会话、不同参数下反复执行 SQL如果每次都要手动输入密码效率会很低也容易出错。用统一 Key 把连接信息管起来测试流程会顺畅很多。3. 可复制的参数查询与修改配置这一节给出可以直接复制执行的 SQL 和配置片段。先看怎么查当前值再看怎么改最后给出一个结构化的配置参考。查询当前cursor_sharing取值最直接的方式是-- 查看当前会话和系统的 cursor_sharing 值 SHOW PARAMETER cursor_sharing; -- 或者从动态性能视图查询信息更全 SELECT name, value, isdefault, isses_modifiable, issys_modifiable FROM v$parameter WHERE name cursor_sharing;isses_modifiable为TRUE表示可以在会话级修改issys_modifiable为IMMEDIATE表示可以在系统级立即生效。这两个字段能帮你确认当前实例是否允许动态调整。修改会话级参数只影响当前会话适合测试-- 改成 FORCE ALTER SESSION SET cursor_sharing FORCE; -- 改成 SIMILAR ALTER SESSION SET cursor_sharing SIMILAR; -- 改回 EXACT ALTER SESSION SET cursor_sharing EXACT;修改系统级参数影响所有会话生产慎用-- 立即生效重启后失效scopememory ALTER SYSTEM SET cursor_sharing FORCE SCOPE MEMORY; -- 立即生效并写入 spfile重启后仍有效scopeboth ALTER SYSTEM SET cursor_sharing FORCE SCOPE BOTH; -- 只写入 spfile重启后生效scopespfile ALTER SYSTEM SET cursor_sharing FORCE SCOPE SPFILE;这里有个坑要提醒SIMILAR这个取值在 Oracle 12c 之后已经被标记为废弃deprecated官方建议不要再使用。如果你在 12c 及以上版本看到SIMILAR最好直接规划迁移到FORCE或EXACT。下面给出一份结构化的参数配置参考方便你在不同环境之间对照{ oracle_cursor_sharing_profiles: { oltp_high_concurrency: { cursor_sharing: FORCE, reason: 应用未使用绑定变量硬解析压力大, scope: BOTH, risk: 执行计划可能因绑定变量窥探而波动 }, dss_reporting: { cursor_sharing: EXACT, reason: 报表类 SQL 字面量差异大强制共享反而有害, scope: SPFILE, risk: 低 }, legacy_mixed: { cursor_sharing: EXACT, reason: 12c 后 SIMILAR 已废弃统一回退到 EXACT 再逐步优化 SQL, scope: BOTH, risk: 短期硬解析可能上升需配合 SQL 改造 } } }如果你用 TOML 管理运维配置可以这样写[oracle.prod] cursor_sharing FORCE scope BOTH note OLTP 主库应用层暂未绑定变量 [oracle.report] cursor_sharing EXACT scope SPFILE note 报表库保持默认需要强调的是改cursor_sharing之前一定要先备份当前的 spfile或者至少记录下原始值。系统级修改一旦生效所有新解析的 SQL 都会受影响回滚虽然简单改回EXACT即可但已经生成的子游标不会自动清理可能需要手动 flush shared pool。4. 验证请求与 AWR 对比硬解析是否真的下降改完参数最关键的一步是验证。不能只看「参数改了」要看「硬解析是不是真的降了」「执行计划有没有变坏」。这一节给出可复制的验证步骤。第一步记录修改前的基线。查询硬解析累计值-- 记录当前硬解析次数 SELECT name, value FROM v$sysstat WHERE name IN (parse count (total), parse count (hard), parse time cpu);第二步在EXACT模式下执行一组字面量不同的 SQL观察硬解析增长-- 假设有表 t_test(id NUMBER, name VARCHAR2(50)) SELECT * FROM t_test WHERE id 101; SELECT * FROM t_test WHERE id 202; SELECT * FROM t_test WHERE id 303; -- 再次查询硬解析次数会看到每次字面量不同都触发硬解析 SELECT name, value FROM v$sysstat WHERE name parse count (hard);第三步切换到FORCE模式重复同样的操作ALTER SESSION SET cursor_sharing FORCE; SELECT * FROM t_test WHERE id 101; SELECT * FROM t_test WHERE id 202; SELECT * FROM t_test WHERE id 303; -- 查看游标会发现 SQL 文本被归一化成 :SYS_B_0 SELECT sql_text, child_number, executions FROM v$sql WHERE sql_text LIKE SELECT * FROM t_test WHERE id%;在FORCE模式下你会看到sql_text变成了SELECT * FROM t_test WHERE id :SYS_B_0三条语句共享同一个父游标。硬解析次数应该只增加一次第一次解析后续两次都是软解析。第四步用 AWR 做前后对比。生成两个快照中间跑业务或压测然后对比报告-- 生成快照 EXEC DBMS_WORKLOAD_REPOSITORY.CREATE_SNAPSHOT(); -- 跑一段业务负载后再生成一个快照 EXEC DBMS_WORKLOAD_REPOSITORY.CREATE_SNAPSHOT(); -- 生成 AWR 对比报告替换 snap_id ?/rdbms/admin/awrrpt.sql在 AWR 报告里重点看几个指标parse count (hard)的每秒值、library cache相关的 latch 等待、shared pool的碎片情况。如果FORCE生效硬解析应该明显下降latch 争用缓解。但也要看parse count (total)有没有异常上升——FORCE模式下软解析要做额外的归一化工作软解析开销会比EXACT略高这是正常的权衡。还有一个细节FORCE模式下 Oracle 会做绑定变量窥探bind peeking第一次执行时用具体的字面量值来估算基数。如果数据分布倾斜严重可能导致执行计划对某些值不优。这时候要结合v$sql_shared_cursor看子游标为什么没有复用-- 查看子游标未复用的原因 SELECT sql_id, child_number, reason FROM v$sql_shared_cursor WHERE sql_id 你的sql_id;如果某个reason字段是Y就说明这是导致游标不能共享的原因。常见的比如BIND_MISMATCH、OPTIMIZER_MISMATCH、ROLL_INVALID_MISMATCH等。这一步能帮你判断FORCE是不是真的达到了预期效果还是只是表面上归一化了、实际上还在不断生成子游标。5. 本篇常见报错与排查这一节把实际运维中容易遇到的报错和排查思路整理出来对照着看能少走弯路。报错一ORA-01031: insufficient privileges执行ALTER SYSTEM SET cursor_sharing时权限不足。排查确认当前用户是否有ALTER SYSTEM权限通常需要SYSDBA或ALTER SYSTEM系统权限。用SELECT * FROM session_privs WHERE privilege LIKE %ALTER SYSTEM%;确认。报错二ORA-02095: specified initialization parameter cannot be modified说明该参数在当前 scope 下不可动态修改。排查查v$parameter的issys_modifiable字段如果是FALSE就只能通过SCOPESPFILE修改后重启实例。cursor_sharing通常是IMMEDIATE如果报这个错可能是实例状态异常或参数被锁定。报错三local proxy failed / connection refused这类错误通常出现在通过 API 通道获取数据库凭据时。排查确认 TaoToken 的 API 地址是否正确https://taotoken.net/api Key 是否有效网络是否可达。如果是 401 错误说明 Key 无效或过期需要重新在 Console 里生成。Console 入口在 https://taotoken.net/api/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。报错四reading choices / unexpected response format如果你用编码助手比如 Claude Code通过 API 生成运维脚本遇到响应格式解析失败通常是模型返回的内容结构不符合预期。排查确认请求的 Model ID 是否正确Base URL 是否指向 https://taotoken.net/api 。如果是 OAuth 相关的报错检查授权流程是否完整走完。报错五执行计划突然变差全表扫描增多这不是报错但比报错更隐蔽。FORCE模式下原本因为字面量不同而各自优化的语句被强制共享计划可能导致某些值走错计划。排查用v$sql对比修改前后的plan_hash_value看是否发生了变化。如果发现某条关键 SQL 计划变差可以用 SQL Plan Baseline 或 SQL Patch 固定计划而不是简单回退整个参数。报错六SIMILAR 模式下行为不符合预期前面 excerpt 里提到过SIMILAR在没有直方图时等于FORCE有直方图时等于EXACT。如果你发现SIMILAR没有生效先检查列上有没有直方图SELECT column_name, histogram FROM dba_tab_col_statistics WHERE table_name 你的表;。另外切换参数前最好连续执行两次ALTER SYSTEM FLUSH SHARED_POOL避免残留游标干扰测试结果。关于三件套的完整配置如果你用 Cline MCP 或 Codex 这类工具接入需要配全三件套Base URL 填 https://taotoken.net/api Key 填你在 Console 生成的 KeyModel ID 填你实际使用的模型标识。三者缺一不可少任何一个都会导致请求失败。CC Switch 切换配置时也要确认这三项都同步更新了。6. 从参数到凭据把运维链路收拢到一处cursor_sharing的调整本身不复杂难的是把它放进一个可验证、可回滚、可复用的流程里。我自己的做法是先在测试库用ALTER SESSION试确认硬解析下降且执行计划没有明显劣化再考虑系统级修改系统级修改一定配合 AWR 前后对比用数据说话而不是凭感觉。另一个容易被低估的点是凭据管理。做参数对比测试时你可能需要在多个库、多个会话之间来回切换如果每个连接都要手动输密码不仅低效还容易把密码留在命令历史里。用 TaoToken 的统一 Key 把连接信息管起来之后脚本里只留一个环境变量引用密码轮换也只需要改一处。模型对话入口在 https://taotoken.net/api/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 接入文档在 https://taotoken.net/api/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Keys 管理在 https://taotoken.net/api/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。最后留一个实操建议改完cursor_sharing之后别急着走人。隔一天再拉一次 AWR看看共享池的碎片情况、子游标数量有没有异常增长。FORCE模式下子游标虽然比SIMILAR收敛但如果应用层 SQL 写法五花八门子游标还是可能慢慢堆积。定期用SELECT COUNT(*) FROM v$sql WHERE sql_text LIKE %SYS_B_%;观察一下心里有数。参数是手段不是目的真正的目标是让数据库在高并发下稳定跑下去。