ADOQuery1.Open 与 ExecSQL 内部区别：TaoToken 场景下的数据访问链路拆解

1. ADOQuery1.Open 与 ExecSQL 到底差在哪从一次数据访问链路说起如果你在 Delphi 里写过数据库代码大概率见过这两种写法ADOQuery1.Open和ADOQuery1.ExecSQL。很多人凭直觉记成「查询用 Open增删改用 ExecSQL」但真到排查问题时比如游标一直停在dsOpening、事务没提交、RowsAffected拿不到值就会发现这个直觉不够用。这篇就聚焦 Delphi 中 ADOQuery1.Open 与 ExecSQL 的底层差异把结果集返回、游标状态、事务与锁行为拆开讲并结合 TaoToken 统一 Key/API 通道演示两种调用在真实数据访问链路里的表现。先说结论性的判断Open走的是OpenCursor路径它会真正去Recordset.Open把游标打开、把结果集挂到数据集上让Fields、RecordCount、Eof这些成员可用而ExecSQL走的是Command.Execute路径它只关心受影响行数不建立可浏览的游标。这个差异不是风格问题而是 VCL 源码里两条完全不同的分支。适合谁看如果你正在用 Delphi 7 到 Delphi 11 之间的版本维护老系统或者你在用 ADO 组件对接远程数据服务又或者你通过 TaoToken 这类统一 API 通道把模型能力和数据访问串在一起那这篇的配置片段和排障步骤可以直接拿去用。核心检索词就是 ADOQuery、Open、ExecSQL 三者的内部区别以及它们在真实链路中的行为对照。我试过在一个批量更新场景里把ExecSQL误写成Open结果程序不报错但RecordCount返回 -1后续依赖行数的逻辑全部走偏。这类坑不靠猜得看源码和实测。2. TaoToken 前置准备统一 Key 与 API 通道怎么配在把 ADOQuery 的两种调用接进真实链路之前先把 TaoToken 这一侧的通道准备好。TaoToken 提供统一的 Key 和 API 入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。它的作用是让你不用为每个模型或服务单独维护一套鉴权和地址用一个 Key 走统一通道。你需要先拿到 API Key。进入控制台的 API Keys 页面创建地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建后复制那串以sk-开头的字符串注意只显示一次丢了就重新生成。这一步别截图发群里Key 泄露等于别人能刷你的额度。拿到 Key 之后你要明确三件套Base URL、Key、Model ID。Base URL 填https://taotoken.net/apiKey 填刚复制的那串Model ID 按你实际要调用的模型填。这三件套在后面的配置片段里会反复出现缺一个都会导致 401 或连接失败。如果你用的是 Claude Code 这类编码工具TaoToken 也提供了对应的接入方式文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 的接入页在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 里面写了 Base URL 和 Key 怎么填。对于长期编码和 Agent 场景可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 适合需要持续调用的项目。这里要强调一点TaoToken 是统一 API 通道不是让你绕过什么限制的工具它的价值在于把多个模型的调用收敛到一个入口减少你在 Key 管理和地址切换上的重复劳动。配置时把 Base URL 写全不要漏掉/api这一段否则请求会打到错误路径。准备好这三件套后我们回到 Delphi 侧看 ADOQuery 的两种调用怎么和这条链路配合。3. 可复制配置ADOQuery 参数与 TaoToken 三件套片段这一节给出可以直接复制的配置。先看 Delphi 侧 ADOQuery 的关键属性设置再看 TaoToken 的三件套片段。两者配合的方式是ADOQuery 负责本地或远程数据库的访问TaoToken 负责模型/API 通道你在同一个数据访问链路里可能既查库又调模型。先看 ADOQuery 的配置。假设你要执行一条带参数的更新语句用 ExecSQLprocedure TForm1.RunExecSQL; begin ADOQuery1.Close; ADOQuery1.SQL.Clear; ADOQuery1.SQL.Add(UPDATE Orders SET Status :Status WHERE OrderID :OrderID); ADOQuery1.Parameters.ParamByName(Status).Value : Paid; ADOQuery1.Parameters.ParamByName(OrderID).Value : 1001; ADOQuery1.CommandTimeout : 30; ADOQuery1.ExecuteOptions : [eoExecuteNoRecords]; try ADOQuery1.ExecSQL; Memo1.Lines.Add(受影响行数: IntToStr(ADOQuery1.RowsAffected)); except on E: Exception do Memo1.Lines.Add(ExecSQL 失败: E.Message); end; end;再看查询场景用 Openprocedure TForm1.RunOpen; begin ADOQuery1.Close; ADOQuery1.SQL.Clear; ADOQuery1.SQL.Add(SELECT OrderID, Status, Amount FROM Orders WHERE Status :Status); ADOQuery1.Parameters.ParamByName(Status).Value : Paid; ADOQuery1.CursorType : ctStatic; ADOQuery1.LockType : ltReadOnly; ADOQuery1.CursorLocation : clUseClient; try ADOQuery1.Open; while not ADOQuery1.Eof do begin Memo1.Lines.Add(ADOQuery1.FieldByName(OrderID).AsString); ADOQuery1.Next; end; except on E: Exception do Memo1.Lines.Add(Open 失败: E.Message); end; end;注意CursorType和LockType的选择会直接影响锁行为。ctStatic加ltReadOnly是只读快照适合报表如果你用ctDynamic加ltOptimistic游标会随数据变化锁粒度也不同。CursorLocation设为clUseClient时结果集拉到客户端clUseServer则留在服务端后者对大数据量更友好但游标状态更敏感。接下来是 TaoToken 的三件套片段。如果你用 JSON 配置可以这样写{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model_id: 你的模型ID }如果你用 TOML[taotoken] base_url https://taotoken.net/api api_key sk-你的Key model_id 你的模型ID如果你用 Claude Code 的 settings 风格{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key, ANTHROPIC_MODEL: 你的模型ID } }这三件套里的 Base URL、Key、Model ID 必须和你在控制台创建的一致。路径不要自己加斜杠或改大小写https://taotoken.net/api就是完整基址。把这段配置和上面的 ADOQuery 代码放在同一个项目里你就有了一个既能查库又能调模型的完整链路。4. 验证请求与成功结果Open 与 ExecSQL 的执行对照配置好之后怎么验证两种调用真的按预期工作这一节给出可跟做的验证步骤和预期结果。第一步验证 ExecSQL 的受影响行数。执行上面RunExecSQL的代码如果更新了 1 行RowsAffected应该返回 1。这里的关键是ExecuteOptions里加了eoExecuteNoRecords它告诉 ADO 不要返回结果集只拿行数。如果你去掉这个选项某些驱动会尝试返回一个空结果集RowsAffected可能变成 -1。第二步验证 Open 的游标状态。执行RunOpen在Open之后立刻检查ADOQuery1.State。正常应该是dsBrowse。如果你看到dsOpening一直不变说明游标没打开成功通常是连接或 SQL 有问题。RecordCount在clUseClient下能拿到准确值在clUseServer下可能返回 -1这是 ADO 的已知行为不是 bug。第三步对照两者的资源释放。Open之后必须Close否则游标一直占着连接。ExecSQL之后虽然不产生游标但如果你复用了同一个 ADOQuery 去Open也要先Close。实测下来忘记Close会导致连接池耗尽报「连接忙」或超时。第四步把 TaoToken 通道也验证一遍。用模型对话页面发一条测试请求地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果返回正常说明 Key 和 Base URL 没问题。这一步和 ADOQuery 是独立的但同属一个数据访问链路建议一起测。成功结果的判断标准ExecSQL 返回正整数行数且无异常Open 后State dsBrowse、Eof可正常遍历TaoToken 请求返回 200 且内容非空。三者都通过说明链路通了。这里给一个对照表方便你快速比对维度OpenExecSQL底层调用OpenCursor → Recordset.OpenCommand.Execute结果集有可浏览无游标状态dsBrowse / dsOpening不涉及返回值无靠数据集状态RowsAffected适用语句SELECTINSERT/UPDATE/DELETE资源释放必须 Close无需游标但复用要 Close5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来排。你在把 ADOQuery 和 TaoToken 串起来时最可能撞上下面几类错误。第一类401 Unauthorized。这几乎都是 Key 的问题。检查三件套里的 Key 是否完整、有没有多余空格、是不是复制时漏了字符。如果你用的是 Claude Code 接入确认ANTHROPIC_API_KEY填的是 TaoToken 的 Key而不是别处的。401 不会因为 SQL 写错而出现所以看到 401 先查鉴权别去改 SQL。第二类local proxy failed。这个报错通常出现在你本地配了转发但目标地址不通的时候。检查 Base URL 是不是写成了https://taotoken.net/api有没有多写端口或路径。如果你在 settings 里同时配了多个环境变量确认没有互相覆盖。这个错误和 ADOQuery 无关是通道侧的问题。第三类reading choices 相关报错。这类错误一般出现在解析返回结构时比如你期望拿到choices字段但返回体结构不对。检查 Model ID 是否填错不同模型的返回格式可能有差异。如果你在代码里硬编码了字段路径换成实际返回的结构再试。第四类OAuth 相关报错。如果你用的是需要 OAuth 的接入方式确认 token 没过期。TaoToken 的 API Key 方式不涉及 OAuth 流程但如果你混用了其他鉴权方式可能触发这类错误。统一用 API Key 最省事。第五类ADOQuery 侧的报错。Open报「未指定结果集」通常是 SQL 不是 SELECTExecSQL报「参数未赋值」是Parameters没填全。这两类错误和通道无关看异常消息就能定位。排障顺序建议先确认 TaoToken 通道能通用模型对话页测再确认 ADOQuery 单独能跑最后才看两者配合。这样能把问题范围缩小到一半。如果你在排障时需要对照接入文档地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。API Keys 管理在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。这两个页面能覆盖大部分配置问题。6. 把两种调用用对接入文档与 API Keys 的落地建议回到最开始的问题ADOQuery1.Open 和 ExecSQL 的内部区别本质是「要不要结果集」和「要不要游标」的区别。Open 走 OpenCursor建立可浏览游标适合查询ExecSQL 走 Command.Execute只拿行数适合增删改。理解这一点你就能在写代码时不再靠猜。在 TaoToken 场景下这条数据访问链路的价值在于统一。你用一套 Key 和 Base URL 就能对接模型能力同时本地 ADOQuery 继续管数据库访问两者不冲突。配置时把三件套写全Base URL 用https://taotoken.net/apiKey 从控制台拿Model ID 按实际填。落地建议有三条。第一ExecSQL 之后如果要复用 ADOQuery 去 Open先 Close避免游标冲突。第二Open 的场景尽量明确 CursorType 和 LockType别用默认值碰运气。第三TaoToken 的 Key 定期轮换控制台可以重新生成旧 Key 失效后记得更新配置。如果你需要长期在编码和 Agent 场景里调用Coding Plan 的入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。接入文档和 API Keys 页面建议收藏排障时直接翻。最后一步把上面的RunExecSQL和RunOpen跑一遍对照第 4 节的验证标准确认你的链路是通的。