qoderwake作为数字分析师可在受控权限下生成sql：一、绑定只读数据库连接；二、query console中快捷键触发自然语言转sql；三、slash命令批量生成分析sql；四、ask模式嵌入@database上下文；五、agents.md配置视图白名单与字段屏蔽。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果QoderWake被配置为数字分析师角色，并已接入企业数据库系统，则其可在受控权限下生成SQL查询语句。以下是该场景下的具体操作路径：
一、通过数字分析师身份调用数据库上下文
QoderWake的数字分析师角色在启用前需完成数据库连接绑定与权限校验，确保其仅能访问授权Schema且不触发写操作。该角色自动继承Qoder IDE中已配置的数据库连接信息，并依据预设的“分析只读”策略加载表结构元数据。
1、登录QoderWake控制台，选择已部署的「数字分析师」实例。
2、点击「工作空间设置」→「数据源管理」→「绑定数据库连接」。
3、从下拉列表中选择已在JetBrains或DataGrip中成功测试的数据库连接项。
4、确认勾选启用只读查询模式及禁用DDL/DML执行权限。
二、在Query Console中触发自然语言转SQL
该方式复用Qoder IDE底层的Query Console集成能力，由QoderWake代理发起请求，AI模型基于当前Schema实时生成合规SQL，所有输出均经权限沙盒拦截验证。
1、在QoderWake界面中打开目标数据库对应的Query Console标签页。
2、将光标置于编辑区，按下快捷键Ctrl + Shift + I（Windows/Linux）或 Cmd + Shift + I（macOS）。
3、输入自然语言描述，例如：“列出近30天订单金额大于5000元的客户姓名与下单次数”。
4、按Enter后，QoderWake返回SQL代码块，并在右下角显示“已通过只读策略校验”提示。
三、使用Slash命令批量生成分析类SQL
数字分析师支持预注册结构化命令，可绕过对话上下文直接调用专用SQL生成流程，适用于固定报表口径或周期性分析任务。
1、进入QoderWake「命令中心」→「新建命令」。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、填写名称为/sales_analyze，Prompt字段输入：Generate read-only SQL for sales analysis based on current database schema. Never use INSERT, UPDATE, DELETE, DROP or CREATE.
3、保存后，在任意对话输入框中键入/sales_analyze 用户地域分布与客单价中位数。
4、QoderWake立即返回符合ANSI SQL标准的SELECT语句，并附带字段注释说明。
四、在Ask模式中嵌入@database上下文生成SQL
当数字分析师以Ask模式响应复杂业务问题时，可通过显式引用数据库上下文提升生成准确性，所有SQL输出默认锁定为SELECT语句类型并跳过执行按钮渲染。
1、在QoderWake Ask输入框中输入问题，例如：“对比华东与华南地区上季度活跃用户留存率，需要哪些表和字段？”。
2、点击输入框右侧Add Context按钮。
3、在弹出菜单中选择@database → [your_analytics_db]。
4、提交后，QoderWake返回含JOIN逻辑的SELECT语句及对应表字段来源标注，不提供Execute按钮。
五、通过AGENTS.md配置限定SQL生成范围
管理员可在项目根目录的AGENTS.md文件中声明数字分析师可用的视图白名单与字段屏蔽规则，QoderWake在生成SQL前强制校验FROM子句是否匹配白名单，且SELECT字段不得包含敏感列。
1、在项目仓库中打开AGENTS.md文件。
2、添加如下YAML区块：analysis_scope:\n allowed_views: [user_behavior_vw, order_summary_vw]\n blocked_columns: [id_card, phone, email]。
3、保存并推送至远程仓库。
4、QoderWake下次生成SQL时，自动过滤掉blocked_columns所列字段，并拒绝引用非allowed_views中的对象。
