数据库 AI 助手实战指南(4.0 核心特性)
数据库 AI 助手(Database AI Assistant) 是 Yearning v4.0 推出的核心增效能力:它以右下角悬浮入口(dots-02 图标,亦支持独立页 /assistant)常驻工作台,严格聚焦在 「平台使用咨询」「基于真实元数据的自然语言生成 SQL」「SQL 分析与优化」 三项数据库任务上。
与通用聊天机器人不同,Yearning AI 助手在架构层面贯彻 零泄漏单轮内存脱敏、方言 AST 结构化还原、零直接执行 SQL、强制衔接正式 AI 预审与审批门禁 四条硬边界,让研发既能用自然语言秒出合规 SQL,又不突破生产数据安全红线。

1. 三大核心能力与真实使用示例
能力一:角色感知的平台操作与报错咨询(platform_help)
内置知识库与当前 Yearning v4 版本严格同步,并按登录身份自动过滤(普通用户只看工作台业务操作,管理员额外检索 /admin/* 后台配置指南)。回答附带步骤清单、来源引用以及可点击的站内页面直达按钮。
直接这么问:
- "我提交变更工单报错
2008和2001是什么原因?怎么解决?" - "如何申请生产库的只读查询权限,顺便开通导出?"
- "(管理员)怎么把内网 vLLM 部署的本地模型配置成
san原生轨道?"
能力二:自然语言生成 SQL + 两阶段直连变更工单(sql_generate)
当你知道目标库表和要写入/查询的业务内容,却不想手工核对几十个列的字段名、类型、非空约束和方言引号时,可直接把业务描述交由助手生成并衔接提单:
真实操作流程(以「插入一条新仓库记录并提单」为例):
- 打开助手并描述需求:
"帮我往
prod-erp数据源erp库的warehouses表插入一条新记录:华东一号冷链仓,编码WH-EC-001,联系人张明,电话13800138000,地址上海市浦东新区XX路88号。生成 SQL 并帮我准备提单。" - 服务端前置鉴权与受控元数据探测:
- 系统先校验你是否拥有
prod-erp的权限:仅持有只读 Query 授权只能生成SELECT,持有change_review流程授权才允许生成 DML/DDL(无权统一返回6002,不泄露数据源或表是否存在)。 - 鉴权通过后,服务端调用只读 Metadata Tool 自动拉取
warehouses表的列定义、类型、NOT NULL约束、默认值/自增标记与主键/索引。
- 系统先校验你是否拥有
- 缺必填列时主动追问(绝不瞎编值):
- 如果
warehouses表存在NOT NULL且无默认值/非自增的字段(如region_code),而你的描述里没提供,助手会暂停生成草稿并列出缺失字段清单请你补充,绝不自行猜测编造。
- 如果
- 单轮内存脱敏 → 模型生成 → 方言 AST 校验与安全还原:
- 在公有云
default轨道下,表名、列名和你的业务敏感值(仓库名、姓名、电话、地址)会被全部替换为匿名标识(table_1、column_1)与类型化占位符(:val_str_1、:val_str_2)后发往模型;模型返回后由服务端做方言语法解析、授权表列校验与类型安全还原,最终在面板输出带draft_id+revision+sql_hmac的完整 SQL 草稿卡片。
- 在公有云
- 两阶段确认提单(绝不跳过正式门禁):
- 第 1 步(触发正式 AI 预审):在 SQL 卡片上核对目标数据源、Schema 与还原后的完整 SQL,点击 执行正式 AI 预审(调用
POST /api/v4/ai-assistant/sessions/{session_id}/drafts/{draft_id}/precheck->StartEphemeralRun),完整走一遍平台确定性规则 + AI 预审引擎。 - 第 2 步(确认提交工单):仅当绑定当前草稿版本和
sql_hmac的预审达到ready且零Critical阻断项时,确认提交变更工单 按钮才亮起;点击后以Idempotency-Key幂等调用SubmitOrderV2创建正式工单,并返回真实工单号(display_number)与详情页跳转链接。
- 第 1 步(触发正式 AI 预审):在 SQL 卡片上核对目标数据源、Schema 与还原后的完整 SQL,点击 执行正式 AI 预审(调用
只要你编辑了草稿 SQL、切换了目标数据源/审批流程或权限发生变化,旧预审绑定立即失效(提交会拦截 6005 ASSISTANT_DRAFT_REVISION_STALE),必须重新点击 执行正式 AI 预审。
能力三:结合真实表结构的慢 SQL 分析与优化(sql_optimize)
把线上慢 SQL(以及可选手工粘贴的 EXPLAIN 执行计划文本)直接贴给助手并指定数据源:
- 服务端自动解析 SQL 涉及的库表,拉取授权范围内的真实列类型、索引顺序与约束,统一脱敏后送入模型。
- 助手输出优化后的改写 SQL(经方言 AST 校验还原)、改动理由、风险提示与待验证项。
- 严守诚实边界:
- 助手绝不会对生产库自动跑
EXPLAIN或SELECT,也绝不编造「耗时下降 80%」这类未经实测的数据。 - 如果改写可能改变
NULL行为、去重结果或过滤边界,助手会显式标出 语义差异警示,绝不冒充等价优化。
- 助手绝不会对生产库自动跑
2. 零泄漏隐私链路与双轨协同原理
3. 会话持久化、自动压缩与配额管理
4. 严禁边界与 60xx 错误码速查
为了守住生产数据库安全底线,AI 助手在代码层强制执行以下 5 条不可绕过禁令:
- 不陪聊:拒绝数据库与 Yearning 之外的通用闲聊、写诗、通用编程或运维脚本请求(
6001)。 - 不执行:绝不在目标库上执行任何
SELECT、EXPLAIN、DML 或 DDL。 - 不看行数据:不采样、不读取、不返回任何业务表行数据。
- 不生成高危破坏语句:禁止生成
TRUNCATE、DROP DATABASE、DROP SCHEMA、GRANT/REVOKE与存储过程/触发器。 - 不绕门禁:草稿绝不等同于预审通过,提单必须重新鉴权并走通正式
StartEphemeralRun+SubmitOrderV2。