shared pool 过大怎么排查：TaoToken 配置骨架与验证动作

1. shared pool 过大到底卡在哪从 AWR 到视图的定位思路shared pool 是 Oracle SGA 里最容易被“撑大”的一块内存它主要缓存 SQL 解析结果、执行计划、数据字典和 PL/SQL 对象。很多 DBA 会遇到这样的现象数据库跑了一段时间shared pool 从 2GB 涨到 7GB 甚至更高之后即使业务量下降它也不会自动缩回去。这不是 bug而是 Oracle 内存管理策略的正常表现——shared pool 一旦因为硬解析压力被扩大只要没有其他组件比如 buffer cache需要内存它就会一直保持这个大小。我试过在一套 22GB memory_target 的库上shared pool 稳定在 7168Mbuffer cache 只有 3840MAWR 里 Memory Usage % 才 55%但 shared pool 就是不肯降。这种情况在 Oracle 11g/12c 的自动内存管理下非常典型。你要做的不是急着改参数而是先搞清楚三件事shared pool 里到底装了什么、为什么会被撑大、以及当前内存分配是否合理。适合谁看正在被 shared pool 占用过高困扰的 Oracle DBA、需要做内存调优的运维工程师、以及想用统一 API 通道管理数据库诊断脚本的开发者。本文会先讲排查路径再给出 TaoToken 的 settings.json 与 config.toml 配置骨架让你把 AWR 查询、视图诊断这些动作通过统一 Key 跑起来最后用验证请求确认效果。排查 shared pool 过大核心是区分“真实需求”和“历史遗留”。真实需求来自硬解析、软解析、游标共享不足历史遗留则是 Oracle 在某个时间点扩大了 shared pool 后不再回收。AWR 的 Shared Pool Statistics 区域能直接告诉你答案如果 % SQL with executions1 很高比如 80% 以上说明游标共享良好shared pool 大是因为曾经有过解析压力如果这个值很低那可能是绑定变量使用不当或 SQL 没共享。2. TaoToken 前置统一 Key 与 API 通道准备在开始写诊断脚本之前先把 TaoToken 的访问通道配好。TaoToken 提供统一的 API Key 和兼容 OpenAI 风格的接口你可以用它来管理数据库诊断相关的模型调用、脚本生成和结果分析。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。你需要先拿到一个 API Key。登录后进入控制台在 API Keys 页面创建一个新 Key建议按项目命名比如oracle-diag。这个 Key 会用在后面的 settings.json 和 config.toml 里。注意不要把 Key 硬编码到脚本里提交到代码仓库用环境变量或者本地配置文件管理。TaoToken 的模型对话入口在 https://taotoken.net/api-keys 接入文档在 https://taotoken.net/doc 如果你要长期跑编码类任务比如自动生成 AWR 解析脚本可以看 Coding Planhttps://taotoken.net/coding-plan 。这些链接都带了 utm_sourcetaotoken_aicg_blog_end 和 utm_campaignrewrite方便你直接跳转。前置准备清单一个可用的 TaoToken API Key、Python 3.8 或 Node.js 环境、Oracle 客户端sqlplus 或 cx_Oracle、以及目标数据库的 AWR 访问权限。如果你只是想在本地验证配置不需要连数据库也能跑通模型调用部分。3. 可复制配置settings.json 与 config.toml 骨架下面给出两份配置骨架分别对应 JSON 和 TOML 格式。你可以根据自己用的工具链选择。settings.json 适合 VS Code 插件、Claude Code 这类工具config.toml 适合 Python 项目或 CLI 工具。3.1 settings.json 骨架{ taotoken: { api_base: https://taotoken.net/api, api_key: ${TAOTOKEN_API_KEY}, model: claude-sonnet-4-20250514, timeout: 60, max_retries: 3 }, oracle_diag: { awr_snap_begin: 2120, awr_snap_end: 2122, shared_pool_warn_mb: 4096, buffer_cache_min_mb: 4096, db_cache_advice: OFF }, output: { format: markdown, save_path: ./reports/shared_pool_diag.md } }这份配置里api_key用环境变量占位避免明文泄露。model字段填你实际要用的模型名TaoToken 支持多种模型具体以文档为准。oracle_diag段是给诊断脚本用的参数shared_pool_warn_mb设成 4096 表示超过 4GB 就告警。3.2 config.toml 骨架[taotoken] api_base https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model claude-sonnet-4-20250514 timeout 60 max_retries 3 [oracle_diag] awr_snap_begin 2120 awr_snap_end 2122 shared_pool_warn_mb 4096 buffer_cache_min_mb 4096 db_cache_advice OFF [output] format markdown save_path ./reports/shared_pool_diag.mdTOML 版本和 JSON 版本字段一一对应选一个用就行。如果你用 Python推荐 TOML因为tomllib是标准库如果你用 Node.jsJSON 更顺手。配置写好后用环境变量注入 Keyexport TAOTOKEN_API_KEYsk-your-key-hereWindows 下用set TAOTOKEN_API_KEYsk-your-key-here或者 PowerShell 的$env:TAOTOKEN_API_KEYsk-your-key-here。4. 验证请求与成功结果跑通一次 shared pool 诊断配置就绪后先跑一个最小验证请求确认 TaoToken 通道可用。下面用 Python 写一个脚本读取 config.toml调用模型生成 AWR 解析 SQL然后输出结果。import os import tomllib import requests with open(config.toml, rb) as f: cfg tomllib.load(f) api_base cfg[taotoken][api_base] api_key os.environ[TAOTOKEN_API_KEY] model cfg[taotoken][model] headers { Authorization: fBearer {api_key}, Content-Type: application/json } prompt 你是 Oracle 性能诊断专家。请根据以下 AWR 片段给出 shared pool 过大的排查 SQL Snap Begin: 2120, Snap End: 2122 Shared Pool Size: 7168M Memory Usage %: 54.31 - 55.01 % SQL with executions1: 73.18 - 82.35 % Memory for SQL w/exec1: 76.41 - 83.42 db_cache_advice: OFF memory_target: 22548578304 请输出 3 条可直接在 sqlplus 执行的查询用于定位 shared pool 中的内存占用大户。 payload { model: model, messages: [{role: user, content: prompt}], temperature: 0.2 } resp requests.post(f{api_base}/v1/chat/completions, headersheaders, jsonpayload, timeout60) resp.raise_for_status() data resp.json() print(data[choices][0][message][content])运行后你应该看到模型返回类似下面的 SQL-- 查询 shared pool 中各组件内存占用 SELECT component, current_size/1024/1024 AS size_mb FROM v$sga_dynamic_components WHERE component LIKE %shared pool%; -- 查询 shared pool 中 SQL 游标占用 SELECT sql_id, sharable_mem/1024/1024 AS mem_mb, executions FROM v$sqlarea ORDER BY sharable_mem DESC FETCH FIRST 10 ROWS ONLY; -- 查询 shared pool 保留池和临时池使用 SELECT pool, name, bytes/1024/1024 AS mb FROM v$sgastat WHERE pool shared pool ORDER BY bytes DESC FETCH FIRST 20 ROWS ONLY;成功标志HTTP 200返回内容包含可执行的 SQL且没有报 401 或 429。如果返回 401检查 Key 是否正确注入如果返回 429说明触发了限流等几秒重试或降低并发。拿到 SQL 后在 sqlplus 里执行重点看v$sgastat里free memory和miscellaneous的大小。如果free memory很大比如超过 1GB说明 shared pool 确实被过度分配了。这时候可以结合 AWR 的Shared Pool Statistics判断如果% SQL with executions1在 80% 以上说明游标共享良好shared pool 大是历史遗留可以考虑缩小如果这个值低于 50%说明硬解析多应该先优化 SQL 共享而不是盲目缩 shared pool。5. 本篇常见错排查5.1 报错 ORA-04031: unable to allocate shared memory这是 shared pool 不足的经典报错但注意它和“shared pool 过大”是两回事。如果你在缩小 shared pool 后遇到 ORA-04031说明缩得太狠了。排查步骤先查v$shared_pool_advice看 Oracle 建议的 shared pool 大小再查v$sgastat里free memory是否低于 10%。如果低于 10%把 shared pool 调回去。5.2 db_cache_adviceOFF 时 SGA 仍会动态调整AWR 里db_cache_advice是 OFF但 shared pool 还是从 2GB 涨到 7GB。这是因为 Oracle 的自动内存管理AMM在memory_target模式下即使关闭了 buffer cache 建议仍然会做 immediate 类型的 resize。Doc ID 1434975.1 专门讲了这个行为。你要做的是给 buffer cache 设一个最小值或者直接关掉 AMM 改用 ASMM。5.3 memory_target 过大导致 shared pool 不回收memory_target设成 22548578304约 21GBshared pool 占了 7GBbuffer cache 只有 3.8GB。这种分配比例不合理。建议要么给 buffer cache 设db_cache_size最小值要么把memory_target降下来让 Oracle 重新分配。改完后重启数据库观察 shared pool 是否回落。5.4 TaoToken 请求返回 401 或 403检查三处环境变量TAOTOKEN_API_KEY是否设置、Key 是否过期、请求头Authorization格式是否为Bearer sk-xxx。如果用的是 config.toml确认${TAOTOKEN_API_KEY}被正确替换TOML 不会自动展开环境变量你需要在代码里手动替换。5.5 模型返回内容被截断如果max_tokens没设或者设得太小返回的 SQL 可能不完整。在 payload 里加max_tokens: 2048。另外temperature设 0.2 左右比较稳太高会导致 SQL 语法飘。6. 把诊断动作固化到 TaoToken 通道排查 shared pool 过大核心动作就三个查 AWR 确认历史峰值、查 v$sgastat 确认当前占用、查 v$shared_pool_advice 确认建议值。这三个动作的 SQL 可以固化到脚本里通过 TaoToken 的 API 通道统一调用。你可以在 settings.json 里加一个scripts段把常用 SQL 存成模板每次诊断时直接渲染。长期做数据库诊断的话建议把模型调用和 SQL 执行分开模型负责生成和解释 SQLsqlplus 负责执行。这样即使模型返回有误你也能人工审核后再跑。TaoToken 的 Coding Plan 适合这种长期任务入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 。最后提醒一点缩小 shared pool 后一定要观察至少一个业务周期比如一天确认没有 ORA-04031 再固化配置。如果业务有大量硬解析优先考虑用绑定变量和 cursor_sharing 参数而不是一味加内存。