qoder @database功能实现数据库schema实时联动：一、在ask/agent模式中通过add context添加已连接schema；二、query console内按ctrl+shift+i行间生成精准sql；三、支持slash命令调用预设模板；四、diff视图安全应用ddl/dml变更；五、cli模式跨环境同步sql。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 JetBrains IDE 中编写后端代码时，需要频繁切换到数据库工具窗口执行 SQL，或手动拼写表名字段易出错，则可能是由于缺乏与项目数据库 Schema 的实时联动能力。以下是解决此问题的步骤：
一、启用 Qoder @database 上下文感知
该方法让 Qoder 在自然语言提问时自动加载当前 IDE 已配置的数据库结构信息，确保生成的 SQL 语句精准匹配真实表名、字段名及约束关系，避免“凭空猜测”导致的语法或逻辑错误。
1、确保已在 IDEA 的 Database 工具窗口中成功添加并测试连接目标数据库（如 MySQL、PostgreSQL）。
2、打开 Qoder 侧边栏，进入 Ask 或 Agent 模式对话框。
3、点击输入框下方的 “Add Context” 按钮。
4、在弹出菜单中选择 @database 选项。
5、从列表中勾选已连接的数据库 Schema（例如：myapp_production）。
6、确认后，Qoder 将自动抓取该 Schema 的完整 DDL 并构建上下文，后续所有 SQL 请求均基于此结构生成。
二、在 Query Console 中触发行间 SQL 生成
该方式跳过侧边栏交互，在数据库查询编辑器内部直接唤起 Qoder，实现“所想即所得”的轻量级 SQL 编写，适用于日常调试与即席查询场景。
1、在 IDEA 中打开 Database 工具窗口，双击目标数据源以展开其结构树。
2、右键点击任意数据库节点，选择 “New Query Console” 创建新控制台。
3、将光标置于空白查询编辑区，按下快捷键 Ctrl + Shift + I（Windows/Linux）或 Cmd + Shift + I（macOS）。
4、在弹出的内联输入框中输入自然语言描述，例如：“统计每个部门的员工数，并按人数降序排列”。
5、按 Enter 键，Qoder 立即生成可执行的 SELECT 语句，包含正确的 JOIN、GROUP BY 和 ORDER BY 子句。
6、生成结果下方显示 Execute 按钮，点击即可在当前 Console 中运行。
三、使用 Slash 命令快速调用预设 SQL 模板
通过自定义 /sql 类命令，可固化高频 SQL 模式（如分页查询、软删除更新），避免重复输入相似逻辑，同时支持团队统一风格与安全约束。
1、点击 Qoder 侧边栏右上角用户头像，进入 Settings → Commands。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、点击 “+ New Command”，填写名称为 /sql，描述为“生成标准分页查询”。
3、在 Prompt 输入框中粘贴模板：
“基于以下表结构：{schema}，生成一个带 LIMIT 和 OFFSET 的分页 SELECT 语句，查询全部字段，WHERE 条件留空，ORDER BY id DESC。”
4、勾选 Don't scan project files! 以排除 Java/JS 文件干扰，仅聚焦数据库上下文。
5、保存后，在任意 Qoder 对话中输入 /sql user_profiles，即可为 user_profiles 表生成对应分页 SQL。
四、利用 Diff 视图安全应用 SQL 变更
当 Qoder 生成 DDL（如 ALTER TABLE）或批量 DML（如 UPDATE 多行）时，该方法提供可视化比对与人工确认环节，防止误操作引发数据异常或结构破坏。
1、在 Ask 模式中提出变更请求，例如：“为 orders 表新增 status_code VARCHAR(20) NOT NULL DEFAULT 'pending'”。
2、Qoder 返回结构化响应，包含原始 DDL 与建议修改后的 DDL。
3、响应区域自动启用 Diff 视图，新增字段以绿色高亮，删除内容以红色横线标注。
4、检查无误后，将鼠标悬停于 Diff 区域右上角，点击 Apply to Console 按钮。
5、目标 SQL 将自动填充至最近激活的 Query Console，无需复制粘贴。
五、CLI 模式下执行跨环境 SQL 同步
该方案适用于需在 CI/CD 流水线或本地终端批量验证 SQL 兼容性的场景，借助 qodercli 直接读取项目 database.yml 或 connection.json 配置，绕过 IDE 图形界面依赖。
1、确保已安装 qodercli，运行 qodercli --version 验证版本不低于 v2.3.0。
2、在项目根目录下执行：qodercli db:prompt --context=prod --query="列出所有未索引的外键列"。
3、CLI 自动识别 ./config/database.yml 中的 production 配置块，并注入 Schema 元数据。
4、返回结果为标准 SQL 语句，可直接重定向至文件：qodercli db:prompt ... > fk_audit.sql。
5、使用 qodercli db:execute --file=fk_audit.sql 在指定环境执行审计脚本。
