📦 前提条件
在使用 Qoder 的数据库功能前,请确保:
- 已在 JetBrains IDE 中配置好数据库连接
- 打开 Database 工具窗口
- 创建并测试数据库连接(确保能正常连通)
💡 小贴士:Qoder 会自动识别当前 IDE 中已配置的数据库 Schema,无需额外配置。
🧠 使用方式
1️⃣ 在 Ask / Agent 模式中引用数据库
添加数据库上下文
- 在 Qoder 输入框点击 “Add Context”
- 选择
@database - 选择目标数据库 Schema
✅ 效果:
- 自动生成基于该 Schema 的 SQL 文件(含表结构)
- 若有多个 Schema,会分别生成对应文件
- 可用于生成查询语句、分析表设计、生成 ORM 代码等
执行生成的 SQL
- Qoder 返回的 SQL 代码块会带一个 “Execute” 按钮
- 点击即可在当前激活的 Query Console 中执行
- ⚠️ 注意:需提前打开对应数据库的 Query Console,否则无法执行!
2️⃣ 在 Query Console 中直接生成 SQL(快捷方式)
适用于简单查询或临时调整:
- 打开数据库的 Query Console
- 按下快捷键
Ctrl + Shift + I(Windows/Linux)或Cmd + Shift + I(macOS) - 输入自然语言描述,例如:
“查询最近7天注册的活跃用户”
- 按 Enter,Qoder 自动生成 SQL!
✨ 这个方式特别适合日常开发中的“小需求”,省去手动写 WHERE 和 JOIN 的烦恼。
3️⃣ 使用 Slash 命令(/command)提升效率
你可以创建自定义命令,比如 /sql 快速生成 SQL。
创建命令步骤:
- 点击 Qoder 窗口右上角头像 → Settings → Commands
- 新建命令,例如:
Name: sql
Prompt: Generate SQL based on the database schema. Don't scan project files!
🔥 加上
Don't scan project files!可避免扫描无关文件,节省 token 并减少歧义!
调用命令:
在对话中输入 /sql 即可触发。
🛠️ 在 DataGrip 中的最佳实践
DataGrip 用户可以进一步优化体验:
- 将 Qoder 固定到工具栏:
- 点击顶部 “…” → 选择 “Qoder” → 点击图钉图标固定
- 配合 AGENTS.md 文件:
- 在项目根目录添加
AGENTS.md - 描述表命名规范、SQL 风格、业务注释等
- 示例内容:
- 表名使用 snake_case,如 user_profile - 所有表必须包含 created_at 和 updated_at - status 字段枚举值:0=待审核, 1=通过, 2=拒绝
- 在项目根目录添加
Qoder 会参考这些规则生成更符合团队规范的 SQL。