数据库

​

概述

Qoder 支持将 JetBrains IDE 中的数据库连接作为 AI 上下文。通过 @database 功能，AI 可以基于真实的数据库表结构生成 SQL、进行架构分析或生成相关代码。

​

前置条件

在使用数据库功能前，需要先在 JetBrains IDE 中配置数据库连接：

1. 打开数据库工具窗口
2. 创建数据库连接
3. 测试连接是否正常

详细配置说明：https://www.jetbrains.com/help/idea/database-tool-window.html

​

使用方式

​

在 Ask/Agent 模式中引用数据库

添加数据库到上下文：

1. 在 Qoder 输入框中点击「Add Context」
2. 选择 @database
3. 选择目标数据库 Schema

注意：

• 添加到上下文中的 SQL 文件是基于数据库的 schema 生成的
• 如果一个数据库有多个 schema，会生成多个对应的 schema SQL 文件

添加后，可以直接向 AI 提问数据库相关问题，例如：

• 生成查询某表的 SQL
• 分析表结构设计
• 基于表结构生成代码

执行生成的 SQL：

Ask 模式返回的 SQL 代码块会带有执行按钮。点击可直接执行。

注意： Qoder 会在当前活跃的数据库 Query Console 中执行 SQL，因此需要提前打开对应数据库的 Query Console。

​

在 Query Console 中生成 SQL

1. 打开数据库的 Query Console
2. 按 Ctrl + Shift + I
3. 输入自然语言描述
4. 回车生成 SQL

Qoder 会自动使用当前数据库的 schema 作为上下文。

​

使用斜杠指令

可以创建自定义指令快速完成常见操作。

创建指令：

1. 点击 Qoder 窗口的个人头像
2. 选择「个人设置」→「指令」
3. 创建新指令

调用指令：

在 Qoder 对话框中输入 / 加指令名称即可调用，例如输入 /sql 调用 SQL 生成指令。

常用指令示例：

生成 SQL（/sql）：

基于当前数据库 schema 生成 SQL 语句

数据库审查（/db-review）：

审查数据库 schema，检查：命名规范、索引设计、数据类型、表关系

生成测试数据（/mock-data）：

基于表结构生成 INSERT 测试数据

提示： 如果指令只涉及数据库操作（如 NL2SQL），可在开头添加「Don’t scan project files!」，这样不会扫描项目文件，可以节省 token 并避免歧义。注意 AGENTS.md 和 Rules 文件仍会被包含。

​

在 DataGrip 中使用

添加 Qoder 到工具栏：

1. 点击顶部「…」图标
2. 选择「Qoder」
3. 点击大头针固定

使用方法：

• 在 Query Console 中点击 Qoder 按钮
• 或按快捷键 Ctrl + Shift + I

Qoder 会自动选择对应的数据库 schema。

建议： 在项目目录下添加 AGENTS.md 文件，用于说明表命名规范、SQL Guideline 或特定的数据标注等项目约定。

​

实用场景

​

数据库设计

​

Agent 模式（适用于复杂场景）

适用于：

• 需要参考设计文档
• 需要生成符合特定规范的 SQL
• 需要生成特定格式的迁移脚本（如 Flyway）

操作步骤：

1. 在 Agent 模式添加相关文档到上下文
2. 以自然语言描述需求
3. 生成 SQL 文件
4. 打开 SQL 文件并执行

​

Query Console 模式（适用于简单场景）

适用于：

• 简单的数据库结构设计
• 表结构调整
• 微小改动

操作步骤：

1. 打开数据库 Schema 的 Query Console
2. 输入需求
3. 调整并执行生成的 SQL

​

数据库设计最佳实践

提供表结构示例：

如果有标准的表结构样例，可以提供给 Qoder 作为参考：

-- 表级别注释示例
CREATE TABLE user_info (
    id INT COMMENT '用户ID (标准字段名: user_id, 主键)',
    name VARCHAR(50) COMMENT '用户姓名 (标准字段名: name, 用户真实姓名)',
    created_at DATETIME COMMENT '注册时间 (标准字段名: created_at, 账号创建时间)',
    status TINYINT COMMENT '状态 (标准字段名: status, 枚举值: 0-禁用 1-正常 2-冻结)',
    PRIMARY KEY (id)
) COMMENT='用户基本信息表 | 标准表名: user_information | 业务域: 用户域 | 更新方式: 实时';

设计规范建议：

命名规范：

• 使用清晰描述性的名称，表名和字段名能直接表达含义（如 user、order_item），建议采用单数形式
• 保持命名一致性，统一使用下划线命名法（snake_case）或驼峰命名法
• 避免缩写，用 customer_address 而非 cust_addr
• 布尔字段加前缀，如 is_active、has_paid

结构设计：

• 主键明确，每个表都有清晰的主键，命名为 id 或 table_name_id
• 外键关系清晰，外键命名如 user_id、order_id，明确指向关联表
• 添加时间戳，包含 created_at、updated_at 字段

文档和注释：

• 添加表注释，说明表的用途
• 添加字段注释，解释字段含义、取值范围、单位等
• 枚举值说明，如状态字段，注释说明每个值的含义

类型选择：

• 使用合适的数据类型，避免全用 VARCHAR
• 设置合理的长度限制
• NULL 值策略明确，哪些字段允许 NULL，哪些必填
• 默认值明确，如果有明确的默认值，需要指出

​

标注遗留数据库

对于命名不规范的遗留数据库，可以使用 JSON 文件进行标注，让 AI 更好地理解数据库结构。

示例场景：

假设有以下遗留数据库表：

CREATE TABLE tbl_yonghu (
  id        BIGINT AUTO_INCREMENT PRIMARY KEY,
  xin_bie   CHAR(2)     NOT NULL,
  nian_ling INT         NOT NULL,
  gonghao   VARCHAR(32) NOT NULL UNIQUE,
  jiru_date VARCHAR(32)
);

如果无法调整现有数据库结构，可以创建 db-metadata.json 文件进行标注：

{
  "type": "database",
  "description": "数据库表结构标注，以这里的定义为准",
  "tables": {
    "tbl_yonghu": {
      "label": "用户表",
      "description": "存储系统用户信息",
      "required": [
        "id",
        "xin_bie",
        "nian_ling",
        "gonghao"
      ],
      "columns": {
        "id": {
          "label": "用户ID",
          "type": "int",
          "description": "唯一标识"
        },
        "xin_bie": {
          "label": "性别",
          "type": "char(2)",
          "description": "用户性别",
          "enum": ["男", "女"]
        },
        "nian_ling": {
          "label": "年龄",
          "type": "int",
          "description": "用户年龄"
        },
        "gonghao": {
          "label": "工号",
          "type": "varchar(16)",
          "description": "用户的工号",
          "unique": true
        },
        "jiru_date": {
          "label": "加入时间",
          "type": "varchar(16)",
          "description": "用户加入的时间",
          "format": "date",
          "nullable": true
        }
      }
    }
  }
}

使用方法：

在添加数据库 schema 到上下文时，同时添加该 JSON 标注文件。Qoder 在理解数据库结构时会参考该 JSON，从而更准确地生成代码和 SQL。

​

注意事项

​

数据库表非常多

如果数据库 schema 非常大（表非常多，如 ERP、CRM 等场景），可能导致超出 Agent 的上下文限制。

解决方案：

• 将数据库的 schema 导出为多个 SQL 文件
• 通过添加文件的方式分批添加到上下文中
• 只添加与当前任务相关的表

​

数据库方言（Dialect）

Qoder 会自动将数据库 dialect 以注释的方式添加到数据库 schema 中，无需手动声明数据库类型。

如果需要手动添加 SQL 文件到上下文：

• 可以在 SQL 文件中添加注释标明数据库类型，例如：-- dialect: mysql
• 也可以在全局 AGENTS.md 中进行数据库类型声明